Go to file
Luke Smith 7699e6d67c
Merge pull request #24 from terriblephrases/master
Correct gruvbox defaultfg and cursor colors
2018-12-03 12:58:50 -05:00
.travis.yml Enable travis build 2017-01-30 20:14:38 -08:00
arg.h Updated st 0.8.1. Used new patches, scrollblock and alpha fixed. 2018-04-25 22:15:11 +02:00
config.h sets correct gruvbox defaultfg and cursor colors, restores poss. to use 257+ colors 2018-12-03 17:38:57 +01:00
config.mk Updated st 0.8.1. Used new patches, scrollblock and alpha fixed. 2018-04-25 22:15:11 +02:00
LICENSE Revert "Update LICENSE" 2018-09-01 00:16:58 -04:00
Makefile Updated st 0.8.1. Used new patches, scrollblock and alpha fixed. 2018-04-25 22:15:11 +02:00
README.md openbsd compilation note 2018-11-24 09:17:12 -05:00
st.1 mouse bindings and documentation 2018-10-16 15:21:02 -04:00
st.c Updated st 0.8.1. Used new patches, scrollblock and alpha fixed. 2018-04-25 22:15:11 +02:00
st.h Updated st 0.8.1. Used new patches, scrollblock and alpha fixed. 2018-04-25 22:15:11 +02:00
st.info Updated st 0.8.1. Used new patches, scrollblock and alpha fixed. 2018-04-25 22:15:11 +02:00
win.h Updated st 0.8.1. Used new patches, scrollblock and alpha fixed. 2018-04-25 22:15:11 +02:00
x.c xresources patch now default 2018-07-07 03:28:01 -04:00

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

The suckless terminal (st) with some additional features:

  • Compatibility with Xresources and pywal for dynamic colors.
  • Default solarized colors otherwize.
  • Transparency/alpha, which is also adjustable from ~/.Xresources.
  • Default font is system "mono" at 14pt, meaning the font will match your system font.
  • Very useful keybinds including:
    • Copy is alt-c, paste is alt-v or alt-p pastes from primary selection
    • Zoom in/out or increase font size with Alt+Shift+k/j or u/d for larger intervals.
    • Hold alt and press either ↑/↓ or the vim keys k/j to move up/down in the terminal.
    • Shift+Mouse wheel do the same.
    • Alt-u and Alt-d scroll back/forward in history a page at a time.
    • Alt-PageUp and Alt-PageDown will do the same.
  • Vertcenter
  • Scrollback
  • 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.

On OpenBSD, be sure to edit config.mk first and remove -lrt from the $LIBS before compiling.

How to configure dynamically with Xresrouces

For many key variables, this build of st will look for X settings set in either ~/.Xdefaults or ~/.Xresources. You must run xrdb on one of these files to load the settings.

For example, you can define your desired fonts, transparency or colors:

*.font:	Liberation Mono:pixelsize=12:antialias=true:autohint=true;
*.alpha: 150
*.color0: #111
...

The alpha value (for transparency) goes from 0 (transparent) to 255 (opaque).

Colors

To be clear about the color settings:

  • This build will use colorized colors by default and as a fallback.
  • If there are Xresources colors defined, those will take priority.
  • But if wal has run in your session, its colors will take priority.

Note that when you run wal, it will negate the transparency of existing windows, but new windows will continue with the previously defined transparency.

Contact