Skip to content

chrkoewar/st

 
 

Repository files navigation

Luke's build of st - the simple (suckless) terminal - with modifications and customizable margins

The suckless terminal (st) with some additional features that make it literally the best terminal emulator ever:

Unique features (using dmenu)

  • MOD = Control+Shift-Alt
  • follow urls by pressing MOD-f
  • copy urls in the same way with MOD-c
  • copy the output of commands with MOD-o

Bindings

  • scrollback with MOD-↑/↓ or shift while scrolling the mouse. Faster with alt-u/alt-d.
  • copy text with alt-c, paste is alt-v
  • change alpha with MOD i/o
  • change zoom with MOD m/n
  • set x- and y-margins at runtime with -x 50 -y 100 or -b 50
  • set x- and y-margins via hotkey MOD h/j/k/l

Other st patches

  • Boxdraw
  • Ligatures
  • font2
  • updated to latest version 0.8.5

Installation for newbs

You should have xlib header files and libharfbuzz build files installed.

git clone https://github.com/chrkoewar/st
cd st
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.

Be sure to have a composite manager (xcompmgr, picom, etc.) running if you want transparency.

How to configure dynamically with Xresources

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: 0.9
*.color0: #111
...

The alpha value (for transparency) goes from 0 (transparent) to 1 (opaque). There is an example Xdefaults file in this respository.

Colors

To be clear about the color settings:

  • This build will use gruvbox 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.

About

fork of the suckless simple terminal (st) with customizable margins

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • C 94.5%
  • Roff 2.4%
  • Shell 1.6%
  • Makefile 1.5%