/st

My fork of suckless's simple terminal

Primary LanguageCMIT LicenseMIT

st - simple terminal

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

About this fork

Patches applied

Bindings

Scrolling

          MouseWheel  -  Move by line
  Shift + MouseWheel  -  Move by line in alternate mode
                         Send ^E/^Y when not in alternate mode and scroll line
                         buffer when in alternate mode.
Control + MouseWheel  -  Move by page

        Alt + {k, j}  -  Move {up, down} by line
Shift + Alt + {k, j}  -  Move {up, down} by 3 lines
        Alt + {u, d}  -  Move {up, down} by page

Upstream

To pull changes from upstream:

if not already done:
$ git remote add upstream 'https://git.suckless.org/st'

$ git fetch upstream
$ git checkout custom
$ git merge upstream/master

To push the upstream tags:
$ git push origin --tags

Requirements

In order to build st you need the Xlib header files.
For the transparency to work you need a composite manager (e.g. picom, xcompmgr).

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.

Credits

Based on Aurélien APTEL bt source code.