.\" Generated by gen_docs from crates/datui-cli. Do not edit.
.TH DATUI\-THEME 1 2026-10-08 "datui 0.4.4" "User Commands"
.nr HY 0
.ds AD l
.SH NAME
datui\-theme \- list the themes, built in and in the config directory's themes/, or print one as a file to start from
.SH SYNOPSIS
.nf
\fBdatui theme list\fR
\fBdatui theme show\fR \fINAME\fR
.fi
.SH DESCRIPTION
List the themes, built in and in the config directory's themes/, or print one as a file to start from.
.PP
A theme is a set of colors, one per slot. night-market (dark) and day-market (light) are built in; every \fICONFIG\fR/themes/*.toml is a theme, named by its file. A theme file holds \fBtheme.colors\fR slots, plus \fBextends\fR (the theme its unset slots come from; without it, the built-in for the mode it is used in) and \fBdescription\fR. \fBtheme.dark\fR and \fBtheme.light\fR in the config pick the theme for each mode, and \fBtheme.colors\fR lies over whichever is in use. A file with a mistake is left out with a warning, and its mode uses the built-in.
.SH COMMANDS
.TP
\fBdatui theme list\fR
List the themes: name, the mode it is set for, where it comes from and its description.
.TP
\fBdatui theme show\fR
Print a theme as a file with every slot, to save into themes/ and edit.
.RS
.TP
\fINAME\fR
The theme: night-market, day-market, or a file's name in themes/.
.RE
.SH OPTIONS
.TP
\fB\-c\fR, \fB\-\-config\fR \fIKEY=VALUE\fR
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. \fBdatui config keys\fR lists them.
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help.
.SH "EXIT STATUS"
.TP
\fB0\fR
Success: the session was quit (q, Ctrl+Q or Ctrl+C), or the command did what it was asked.
.TP
\fB1\fR
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).
.TP
\fB2\fR
A usage error: an unknown option or command, or a value an option does not take.
.SH ENVIRONMENT
.TP
\fBDATUI_CONFIG_DIR\fR
The config directory, in place of the platform's (\fB~/.config/datui\fR on Linux). Saved views and format specs live there too.
.SH FILES
\fICONFIG\fR is \fB$DATUI_CONFIG_DIR\fR when it is set, else \fB$XDG_CONFIG_HOME/datui\fR (\fB~/.config/datui\fR) on Linux, \fB~/Library/Application Support/datui\fR on macOS and \fB%APPDATA%\edatui\fR on Windows.
.TP
\fICONFIG\fR/config.toml
The config file: see datui-config(5). \fBdatui config path\fR prints the files read.
.TP
\fICONFIG\fR/catalog.toml
Your catalog, which Ctrl+D on the home screen adds to: see datui-catalog(1).
.TP
\fICONFIG\fR/catalogs/
More catalogs, one *.toml each, named by its file; examples.toml replaces the bundled one.
.TP
\fICONFIG\fR/views/
Saved views: see datui-views(1).
.TP
\fICONFIG\fR/formats/
Format specs and dictionaries, searched first: see datui-formats(7).
.SH EXAMPLES
List the themes: name, the mode it is set for, file and description.
.PP
.RS 4
.EX
datui theme list
.EE
.RE
.PP
Print the built-in dark theme with every slot, a file to start a theme from.
.PP
.RS 4
.EX
datui theme show night\-market
.EE
.RE
.SH "SEE ALSO"
\fBdatui\fR(1), \fBdatui\-config\fR(5)
.PP
The datui documentation: <https:/\:/\:derekwisong.\:github.\:io/\:datui/\:>
.SH BUGS
Report bugs at <https:/\:/\:github.\:com/\:derekwisong/\:datui/\:issues>.
.SH AUTHORS
Derek Wisong and the datui contributors.
.SH COPYRIGHT
Copyright \(co 2026 Derek Wisong
.PP
datui is free software under the MIT License.