Suckless-st

st is a termial emulator from the suckless project.

Documentation

homepage

https://st.suckless.org/

Install

# download/extract
curl -O# https://dl.suckless.org/st/st-0.8.2.tar.gz
tar -xvf st-0.8.2.tar.gz

# patch, if desired
curl -#O 'https://st.suckless.org/patches/alpha/st-alpha-0.8.2.diff'
patch -ruN -d st-0.8.2 < st-alpha-0.8.2.diff

# compile/install
cd st
./configure
make
sudo make install

Configuration

Suckless st does not have any dynamic configuration. To make changes, you change the source-code and then recompile it. Most options you'll be interested in (keybindings, colours, fonts) can be found in config.h.

Font/shell

static char font[]  = "Droid Sans Mono:size=14:antialias=true";
static char shell[] = "/bin/zsh";

If UTF-8 characters are not being rendered, check that your /etc/locale.conf is set properly. See Also: Linux Fonts.

Colours

/* Terminal colors (16 first used in escape sequence) */
static const char *colorname[] = {
    /* 8 normal colors */

    "#000000",	//"black",
    "#A93025",	//	"red3",
    "#93d44f",	//	"green3",
    "#eab93d",	//	"yellow3",
    "#306a87",	//	"blue2",
    "#ce5c00",	//	"magenta3",
    "#89b6e2",	//	"cyan3",
    "#cccccc",	//	"gray90",

    /* 8 bright colors */
    "#555753",	//	"gray50",
    "#ff8d8d",	//	"red",
    "#40a030",	//	"green",
    "#ffc123",	//	"yellow",
    "#3465a9",	//	"#5c5cff",
    "#f57900",	//	"magenta",
    "#46a4ff",	//	"cyan",
    "#ffffff",	//	"white",

    [255] = 0,

    /* more colors can be added after 255 to use with DefaultXX */
    "#cccccc",
};

/*
 * Default colors (colorname index)
 * foreground, background, cursor
 */
unsigned int defaultfg = 243;
unsigned int defaultbg = 236;
static unsigned int defaultcs = 245;
static unsigned int defaultrcs = 257;

Hotkeys

Use xev to retrieve keysym

static Shortcut shortcuts[] = {
    /* mask                 keysym          function        argument */
    /* resize fonts */
    { ControlMask,          XK_equal,       zoom,           {.f = +1} },
    { ControlMask,          XK_minus,       zoom,           {.f = -1} },

    /* paste */
    { ShiftMask,            XK_Insert,      selpaste,       {.i =  0} },  /* shift-ins pastes selection buffer */
    { MODKEY|ShiftMask,     XK_Insert,      clippaste,      {.i =  0} },  /* alt-shift-ins pastes clipboard */
    { MODKEY|ControlMask,   XK_v,           clippaste,      {.i =  0} },  /* ctrl-alt-v pastes clipboard */
};