datui-config - write the default config file, list the files read,
or list every key
datui config init [--force]
datui config path
datui config keys
Write the default config file, list the files read, or list every
key.
The file's keys are in datui-config(5).
- datui config
init
- Write the default config file, every key commented out at its
default.
- --force
- Replace a config file that is there.
- datui config
path
- Print the config files read, lowest precedence first.
- datui config
keys
- List every key: its type, default, the value in effect and what set
it.
- -c, --config
KEY=VALUE
- Set a config key for this run, as in the file: -c
display.row_numbers=true. Repeatable; a flag of the key's own still wins.
datui config keys lists them.
- -h, --help
- Print help.
- 0
- Success: the session was quit (q, Ctrl+Q or Ctrl+C), or the command did
what it was asked.
- 1
- An error, printed to standard error: a PATH that is not there, a
configuration file that cannot be used, nothing piped in for -, or a
command that failed (datui formats check on a spec with errors).
- 2
- A usage error: an unknown option or command, or a value an option does not
take.
- DATUI_CONFIG_DIR
- The config directory, in place of the platform's (~/.config/datui
on Linux). Saved views and format specs live there too.
- DATUI_LOG
- The log level: error, warn, info, debug,
trace or off. Beats log.level in a file; -c
and --log-level beat it.
CONFIG is $DATUI_CONFIG_DIR when it is set, else
$XDG_CONFIG_HOME/datui (~/.config/datui) on Linux,
~/Library/Application Support/datui on macOS and
%APPDATA%\datui on Windows.
- CONFIG/config.toml
- The config file: see datui-config(5). datui config path prints the
files read.
- CONFIG/catalog.toml
- Your catalog, which Ctrl+D on the home screen adds to: see
datui-catalog(1).
- CONFIG/catalogs/
- More catalogs, one *.toml each, named by its file; examples.toml replaces
the bundled one.
- CONFIG/views/
- Saved views: see datui-views(1).
- CONFIG/formats/
- Format specs and dictionaries, searched first: see datui-formats(7).
Write the config file, every key commented out at its default.
The config files read, lowest precedence first.
Every key: its type, default, the value in effect and what set it,
here -c.
datui config keys -c display.row_numbers=true
datui(1), datui-config(5)
The datui documentation:
<https://derekwisong.github.io/datui/>
Report bugs at
<https://github.com/derekwisong/datui/issues>.
Derek Wisong and the datui contributors.
Copyright © 2026 Derek Wisong
datui is free software under the MIT License.