_                    _
  ___ | |__   __ _ _______ | |_
 / _ \| '_ \ / _` |_  / _ \| __|
| (_) | | | | (_| |/ / (_) | |_
 \___/|_| |_|\__,_/___\___/ \__|

st — suckless simple terminal - usage and patches

git clone https://git.suckless.org/st
make

The default font can be changed by changing the following line:

static char *font = Liberation Mono:pixelsize=12:antialias=true:autohint=true ;
I have tested TTF fonts under /usr/share/fonts/TTF, eg.:
/usr/share/fonts/TTF/LiberationMono-Regular.ttf
static char *font = Liberation Mono:style=Regular:pixelsize=10.8 ;
The font terminus (/usr/share/fonts/misc/ter-*) works as well:
static char *font = terminus ;

Disable bold and italic fonts. Conflicts with the patch "cyclefonts". See CAVEATS

  1. Download the latest patch (currently 0.8.2): Disable bold/italic fonts
  3. To disable bold fonts by default change config.def.h:
    int disablebold = 1;

There are various palette patches. I have tested two which allow multiple palettes and changing palettes as needed.

colorschemes : Has simpler keybinbindings (Alt-N) but has a limit of 8 colours.
colorschemes.
palettes : Also called color_schemes. Can have 12 colours.
  Using Alt-Shift-F[1-12].
palettes/color_schemes
  1. Download the latest patch:

Add multiple fonts and cycle through them with Ctrl-Shift-S. This patch conflict with "disable bold italic fonts". See CAVEATS Download the latest patch (currently st-cyclefonts-20220731-baa9357.diff)

  1. cyclefonts

(back to top)

Ctrl-Shift-PageUp : Increase font size.
Ctrl-Shift-PageDown : Decrease font size.
Ctrl-Shift-Home : Reset font size.
Alt-[1-9] : Select colorschemes 0-8. (colorschemes patch)
Alt-0 : Cycle through colorschemes. (colorschemes patch)

(back to top)

The patches "disable bold italic fonts" and "cyclefonts" conflict They both use the fonts section for updates. The rejected changes can be applied manually on the file config.def.h

(back to top)

- Translate to Spanish.

(back to top)

suckless, tabbed
VoidLinux manpages: st(1),
links
- Suckless.org
- st - suckless simple terminal
- st patches
- st patch - disable bold/italic fonts
- st patch - colorschemes
- st patch - palettes/color_schemes
- st patch - cyclefonts

(back to top)

2026-07-06 : Created.

(back to top)

ohazot | about | ohazot.com <admin@ohazot.com>

This document applies to: Linux OpenBSD | 2026-07-11