.Dd 2026-07-11
.de oit
.It
\\$*
..
.de obi
.Bl -\\$1 -compact
.shift
.oit \\$*
..
.de obe
.obi \\$*
.El
..
.de obd
.Bd -literal -compact
\\$*
..
.de obc
.Bl -column \\$*
..
.Dt ST oh
.Os Linux OpenBSD |
.Nm st 
.Nd suckless simple terminal - usage and patches
.Sh COMPILE
.Bd -literal -compact
git clone https://git.suckless.org/st
make
.Ed
.Ss config.def.h
The default font can be changed by changing the following line:
.Dl static char *font = "Liberation Mono:pixelsize=12:antialias=true:autohint=true"\&;
I have tested TTF fonts under /usr/share/fonts/TTF, eg.:
.Dl /usr/share/fonts/TTF/LiberationMono-Regular.ttf
.Dl static char *font = "Liberation Mono:style=Regular:pixelsize=10.8"\&;
The font terminus (/usr/share/fonts/misc/ter-*) works as well:
.Dl static char *font = "terminus"\&;
.Sh PATCHES
.Ss disablebold
Disable bold and italic fonts.
Conflicts with the patch "cyclefonts". See
.Sx CAVEATS
.Bl -enum -compact
.It
Download the latest patch (currently 0.8.2):
.Lk https://st.suckless.org/patches/disable_bold_italic_fonts/ Disable bold/italic fonts
.It
.Li patch -p1 < st-disable-bold-italic-fonts-0.8.2.diff
.It
To disable bold fonts by default change config.def.h:
.Dl int disablebold = 1;
.El
.Ss colors
There are various palette patches.
I have tested two which allow multiple palettes and changing palettes as needed.
.obc colorsche
.It colorschemes Ta : Has simpler keybinbindings (Alt-N) but has a limit of 8 colours.
.It Ta Lk https://st.suckless.org/patches/colorschemes/ colorschemes.
.It palettes Ta : Also called color_schemes. Can have 12 colours.
.It Ta \ \ Using Alt-Shift-F[1-12].
.It Ta Lk https://st.suckless.org/patches/palettes/ palettes/color_schemes
.El
.Bl -enum -compact
.It
Download the latest patch:
.It
.Li patch -p1 < st-<color_palette_patch>.diff
.El
.Ss fonts
Add multiple fonts and cycle through them with Ctrl-Shift-S.
This patch conflict with "disable bold italic fonts". See
.Sx CAVEATS
.Bl -enum -compact
Download the latest patch (currently st-cyclefonts-20220731-baa9357.diff)
.It
.Lk https://st.suckless.org/patches/cyclefonts/ cyclefonts
.It
.Li patch -p1 < st-cyclefonts-20220731-baa9357.diff
.El
.Sh KEYBINDINGS
.obc ctrl_shift_paged
.It Ctrl-Shift-PageUp Ta : Increase font size.
.It Ctrl-Shift-PageDown Ta : Decrease font size.
.It Ctrl-Shift-Home Ta : Reset font size.
.It Alt-[1-9] Ta : Select colorschemes 0-8. (colorschemes patch)
.It Alt-0 Ta : Cycle through colorschemes. (colorschemes patch)
.El
.Sh CAVEATS
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
.Sh TODO
.obc
.It - Translate to Spanish.
.El
.Sh SEE ALSO
.obc
.It
.Xr suckless oh ,
.Xr tabbed oh
.It VoidLinux manpages:
.Xr st 1 ,
.It links
.It - Lk https://suckless.org/ Suckless.org
.It - Lk https://st.suckless.org/ st - suckless simple terminal
.It - Lk https://st.suckless.org/patches/ st patches
.It - Lk https://st.suckless.org/patches/disable_bold_italic_fonts/ st patch - disable bold/italic fonts
.It - Lk https://st.suckless.org/patches/colorschemes/ st patch - colorschemes
.It - Lk https://st.suckless.org/patches/palettes/ st patch - palettes/color_schemes
.It - Lk https://st.suckless.org/patches/cyclefonts/ st patch - cyclefonts
.El
.Sh HISTORY
.obc _______
.It 2026-07-06 Ta : Created.
.El
.Sh AUTHORS
.An -nosplit
.Xr ohazot oh |
.Xr about oh |
.Lk https://ohazot.com ohazot.com
.Aq Mt admin@ohazot.com