simple
You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
Luke Smith cd357e5c67 Big cleanup and some redundant bindings added 7 years ago
.travis.yml Enable travis build 8 years ago
FAQ Updated st 0.8.1. Used new patches, scrollblock and alpha fixed. 7 years ago
LEGACY LEGACY: typo. 13 years ago
LICENSE Updated st 0.8.1. Used new patches, scrollblock and alpha fixed. 7 years ago
Makefile Updated st 0.8.1. Used new patches, scrollblock and alpha fixed. 7 years ago
README.md Big cleanup and some redundant bindings added 7 years ago
TODO Remove old TODO entry. 10 years ago
arg.h Updated st 0.8.1. Used new patches, scrollblock and alpha fixed. 7 years ago
config.h Big cleanup and some redundant bindings added 7 years ago
config.mk Updated st 0.8.1. Used new patches, scrollblock and alpha fixed. 7 years ago
solarized-alpha-toggle.patch Big cleanup and some redundant bindings added 7 years ago
st Big cleanup and some redundant bindings added 7 years ago
st.1 Updated st 0.8.1. Used new patches, scrollblock and alpha fixed. 7 years ago
st.c Updated st 0.8.1. Used new patches, scrollblock and alpha fixed. 7 years ago
st.h Updated st 0.8.1. Used new patches, scrollblock and alpha fixed. 7 years ago
st.info Updated st 0.8.1. Used new patches, scrollblock and alpha fixed. 7 years ago
st.o Big cleanup and some redundant bindings added 7 years ago
win.h Updated st 0.8.1. Used new patches, scrollblock and alpha fixed. 7 years ago
x.c Updated st 0.8.1. Used new patches, scrollblock and alpha fixed. 7 years ago
x.o Big cleanup and some redundant bindings added 7 years ago

README.md

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 patches added:

  • transparency
  • copy to clipboard (alt-shift-c)
  • Solarized colors (light and dark toggleable)
  • vertcenter
  • scrollback with keyboard
  • scrollback with mouse
  • updated to latest version 0.8.1

My own additions

  • 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.
  • Alt-u and Alt-d scroll back/foward in history a page at a time.
  • Alt-PageUp and Alt-PageDown scroll back/foward in history a page at a time.
  • Transparency with solarized colors by default.

Terminal-specific mappings

(Additions before me.)

  • 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)

By default, the terminal is transparent with a blackish background. There's a patch file solarized-alpha-toggle.patch which you can use to remove the transparency and give it a typical deep, dark blue solarized background. Just run:

patch < solarized-alpha-toggle.patch

Then, run make & sudo make install again to install the new build. You make reverse the solarized background by running the same command as above, but giving patch the -R option as well.

Explore config.h

  • Change colorname[] array values (88 LOC), default colours are solarized.
  • Numbers of 0 - 15 are usual terminal colors. Change them to your liking.
  • Change bg to your desired terminal background color.
  • Change fg to your desired terminal foreground color.
  • Change cursor to your desired terminal cursor color.