Alexander/st
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
7f231a6b54
st/README.md
Luke Smith 7f231a6b54 xresources patch now default
2018-07-07 03:28:01 -04:00

1.9 KiB
Raw Blame History

Luke's build of st - the simple (suckless) terminal

Forked from https://github.com/shiva/st for simplicity's sake, which is the suckless terminal (st) with some additional features:

  • Adjustable transparency/alpha
  • Compatibility with Xresources and pywal for dynamic colors
  • Copy to clipboard (alt-shift-c)
  • Default font is system "mono" at 14pt, meaning the font will match your system font.
  • Hold alt and press either ↑/↓ or the vim keys k/j to move up/down in the terminal.
  • Shift+Mouse wheel will as well.
  • Alt-u and Alt-d scroll back/forward in history a page at a time.
  • Alt-PageUp and Alt-PageDown will do the same.
  • Zoom in/out with Alt+Shift+k/j or u/d for larger intervals.
  • Vertcenter
  • Optional solarized colors (light and dark toggleable)
  • updated to latest version 0.8.1

The following additional bindings were added before I forked this:

  • Scroll through history -- Shift+PageUp/PageDown or Shift+Mouse wheel
  • Increase/decrease font size -- Shift+Alt+PageUp/PageDown
  • Return to default font size -- Shift+Alt+Home
  • Paste -- Shift+Insert

Installation for newbs

make
sudo make install

Obviously, make is required to build. fontconfig is required for the default build, since it asks fontconfig for your system monospace font. It might be obvious, but libX11 and libXft are required as well. Chances are, you have all of this installed already.

Custom changes (config.def.h or config.h)

Now by default, the terminal is transparent and uses an Xresources patch that looks for your Xresources colors for the colors of st. You can disable the Xresources patch by reversing it as below:

patch -R < xresources.patch

On top of that, you can disable alpha and enable fully solarized colors by running the following:

patch < solarized-alpha-toggle.patch