st - Simple Terminal

st is a simple terminal emulator for X which sucks less.

Repository Setup

• Clone the repository
• Setup upstream remote:

   git remote add upstream https://git.suckless.org/st
   git remote set-url --push upstream DISABLE
   git checkout -b upstream upstream/master

Requirements

In order to build st you need the Xlib header files.

Installation

Edit config.mk to match your local setup (st is installed into the /usr/local namespace by default).

Afterwards enter the following command to build and install st (if necessary as root):

make clean install

Running st

If you did not install st with make clean install, you must compile the st terminfo entry with the following command:

tic -sx st.info

See the man page for additional details.

Patches

• boxdraw via patch: Custom rendering of lines/blocks/braille characters for gapless alignment.
• changealpha via patch: A patch that allows for updating terminal transparency natively.
• externalpipe via patch: Reading and writing st's screen through a pipe.
• font2 via patch: This patch allows to add spare font besides default.
• ligatures via patch: This patch adds proper drawing of ligatures.
• scrollback via patch: Scroll back through terminal output using Shift+{PageUp, PageDown}.
• xresources via patch: This patch adds the ability to configure st via Xresources.

Additional Features

Credits

Based on Aurélien APTEL bt source code.