st/README.md

2.6 KiB

Similar to dwm-flexipatch this project has a different take on st patching. It uses preprocessor directives to decide whether or not to include a patch during build time. Essentially this means that this build, for better or worse, contains both the patched and the original code. The aim being that you can select which patches to include and the build will contain that code and nothing more.

For example to include the alpha patch then you would only need to flip this setting from 0 to 1 in patches.h:

#define ALPHA_PATCH 1

Refer to https://dwm.suckless.org/ for details on the st terminal, how to install it and how it works.


Changelog:

2019-09-16 - Added alpha, anysize, bold-is-not-bright, clipboard, copyurl, disable-fonts, fixime, hidecursor, newterm and open-copied-url patches

Patches included:

  • alpha

    • adds transparency for the terminal
  • anysize

    • allows st to reize to any pixel size rather than snapping to character width / height
  • bold-is-not-bright

    • by default bold text is rendered with a bold font in the bright variant of the current color
    • this patch makes bold text rendered simply as bold, leaving the color unaffected
  • clipboard

    • by default st only sets PRIMARY on selection
    • this patch makes st set CLIPBOARD on selection
  • copyurl

    • this patch allows you to select and copy the last URL displayed with Mod+l
    • multiple invocations cycle through the available URLs
  • disable-fonts

    • this patch adds the option of disabling bold/italic/roman fonts globally
  • fixime

    • adds better Input Method Editor (IME) support
  • hidecursor

    • hides the X cursor whenever a key is pressed and show it back when the mouse is moved in the terminal window
  • newterm

    • allows you to spawn a new st terminal using Ctrl-Shift-Return
    • it will have the same CWD (current working directory) as the original st instance
  • open-copied-url

    • open contents of the clipboard in a user-defined browser