.\" st-config.5 - configuration manual for st terminal
.TH ST\-CONFIG 5 "November 2024" "Version 1.0" "Morinaga OS Manual"
.SH NAME
st\-config \- configuration file for the simple terminal
.SH DESCRIPTION
The configuration for st is done by creating a custom
.B config.h
and (re)compiling the source code.
.SH CONFIGURATION VARIABLES
.TP
.B font
Default font specification in Fontconfig format. Default:
.br
"Perfect DOS VGA 437 Win:size=24:dpi=96:spacing=mono:antialias=false:autohint=false"
.TP
.B borderpx
Border pixel width. Default: 2
.TP
.B alpha
Background opacity (0.0 - 1.0). Default: 0.8
.TP
.B colors
Terminal colors array with 256 entries. Format:
.br
static const char *colorname[] = { "#000000", ... }
.TP
.B defaultfg
Default foreground color index. Default: 259
.TP
.B defaultbg
Default background color index. Default: 258
.TP
.B defaultcs
Default cursor color index. Default: 256
.TP
.B cursorthickness
Thickness of the cursor. Default: 2
.TP
.B bellvolume
Bell volume (-100 to 100). Default: 0
.TP
.B tabspaces
Number of spaces per tab. Default: 8
.SH KEYBOARD SHORTCUTS
.TP
.B Alt+c
Copy selection
.TP
.B Alt+v
Paste selection
.TP
.B Alt+k/j
Scroll up/down
.TP
.B Alt+u/d
Scroll page up/down
.SH EXAMPLE CONFIGURATION
.nf
.RS
static char *font = "Perfect DOS VGA 437 Win:size=24";
static unsigned int borderpx = 3;
static float alpha = 0.85;

/* Terminal colors */
static const char *colorname[] = {
    "#282828", /* background */
    "#cc241d", /* red */
    "#98971a", /* green */
    /* ... */
};
.RE
.fi
.SH FILES
.TP
.I config.h
Main configuration file
.SH SEE ALSO
.BR st (1),
.BR morinaga (1)