NAME¶

nst.conf - nst(1) configuration file

DESCRIPTION¶

nst.conf is the configuration file for the nst(1) terminal emulator. It allows to change a range of settings to override the compiled-in defaults during runtime.

The configuration file is read once during startup of nst(1). Multiple configuration files will be looked up in the following order:

The settings found in the configuration files are accumulated. Settings from configuration files that are parsed at a later time will override previously seen settings, if they overlap.

The configuration file is parsed line by line. Lines starting with a "#" character (after stripping leading whitespace) will be treated as comments and will be ignored. There is no support for line continuation neither in comments nor in configuration lines.

All configuration lines follow the format "<key> = <value>". <key> is an alphanumerical string containing only ASCII characters, underscores and no whitespace. Leading and trailing whitespace is stripped. <key> items that are unknown to nst(1) will be parsed for syntax errors but will be ignored otherwise. <value> can be of one of the following formats, depending on the configuration <key>:

Parse errors will be diagnosed by nst(1) on stderr, but will not cause the terminal emulator to abort. Bad configuration settings (on a logical level) can still lead to a non-functional nst(1).

The available configuration keys along with a description and their compiled-in defaults can be found in the template configuration file installed in /etc/nst.conf.

FILES¶

/etc/nst.conf $HOME/.config/nst.conf