.\" Automatically generated by Pandoc 3.7.0.2
.\"
.TH "RETCH" "1" "May 2026" "retch 0.1.6" "System Information Fetcher"
.SH NAME
retch \- a fast, feature\-rich system information fetcher
.SH SYNOPSIS
\f[B]retch\f[R] [\f[I]OPTIONS\f[R]]
.SH DESCRIPTION
\f[B]retch\f[R] is a fast system information tool written in Rust.
It displays detailed information about your system including OS, CPU,
memory, disks, network, and more, with support for high\-quality ASCII
and graphical logos.
.SH OPTIONS
.TP
\f[B]\-h, \(enhelp\f[R]
Show help information.
.TP
\f[B]\-V, \(enversion\f[R]
Print version information.
.TP
\f[B]\(enascii\-only\f[R]
Force ASCII\-only output, disabling graphical and Chafa rendering.
.TP
\f[B]\(enno\-logo\f[R]
Disable the logo entirely.
.TP
\f[B]\(entheme\f[R] \f[I]THEME\f[R]
Use a specific theme (\f[CR]default\f[R], \f[CR]dark\f[R], or
\f[CR]light\f[R]).
.TP
\f[B]\(enprint\-logos\f[R]
Print all available logos.
.TP
\f[B]\(enlist\-distros\f[R]
List known supported distributions.
.TP
\f[B]\(encompletions\f[R] \f[I]SHELL\f[R]
Generate shell completion scripts for the specified shell.
Supported shells are: \f[CR]bash\f[R], \f[CR]elvish\f[R],
\f[CR]fish\f[R], \f[CR]power\-shell\f[R], \f[CR]zsh\f[R],
\f[CR]nushell\f[R].
.TP
\f[B]\(engenerate\-config\f[R]
Print a default configuration file to stdout.
.TP
\f[B]\(enwrite\-config\f[R] [\f[I]PATH\f[R]]
Write the default configuration to a file (uses
\f[CR]\(ti/.config/retch/config.toml\f[R] if no path is given).
.TP
\f[B]\(enshort\f[R]
Short output mode.
Shows: OS, Kernel, Host, CPU, GPU, Memory, Disk.
.TP
\f[B]\(enlong\f[R]
Long output mode.
Shows all available fields.
.SH CONFIGURATION
retch reads its configuration from:
.IP
.EX
$XDG_CONFIG_HOME/retch/config.toml
.EE
.PP
or
.IP
.EX
\(ti/.config/retch/config.toml
.EE
.PP
You can generate a starting configuration with:
.IP
.EX
retch \-\-generate\-config > \(ti/.config/retch/config.toml
.EE
.SH THEMES
retch supports multiple built\-in themes as well as custom color
overrides.
.PP
The following themes are available:
.IP \(bu 2
\f[B]auto\f[R] (default): Automatically follows your system dark/light
preference.
.IP \(bu 2
\f[B]neutral\f[R]: A balanced neutral theme (cyan labels, white values).
.IP \(bu 2
\f[B]dark\f[R] and \f[B]light\f[R]: Basic dark and light themes.
.IP \(bu 2
Popular community themes: \f[B]catppuccin\-latte\f[R],
\f[B]catppuccin\-frappe\f[R], \f[B]catppuccin\-macchiato\f[R],
\f[B]catppuccin\-mocha\f[R], \f[B]solarized\-light\f[R],
\f[B]solarized\-dark\f[R].
.PP
You can also define custom colors using the \f[CR][custom_theme]\f[R]
section in your configuration file.
.PP
Colors can be specified using names
(e.g.\ \f[CR]\(dqbright_cyan\(dq\f[R]) or hex values
(e.g.\ \f[CR]\(dq#89b4fa\(dq\f[R]).
.PP
Example:
.IP
.EX
[custom_theme]
label_color = \(dqbright_cyan\(dq
value_color = \(dq#cdd6f4\(dq
accent_color = \(dqbright_green\(dq
.EE
.SH LOGOS
retch supports both ASCII and graphical logos.
.IP \(bu 2
ASCII logos are adapted from Fastfetch.
.IP \(bu 2
Graphical logos are rendered using Chafa when available, or via the
Kitty, iTerm2, or Sixel inline image protocols.
.PP
Use \f[CR]\-\-ascii\-only\f[R] to force text\-only output.
.SH EXIT STATUS
\f[B]retch\f[R] exits with status 0 on success, and non\-zero on error.
.SH SEE ALSO
\f[B]fastfetch\f[R](1), \f[B]neofetch\f[R](1)
.SH AUTHORS
Maintained by the retch developers.
See the project repository for more information:
.IP
.EX
https://github.com/l1a/retch
.EE
.SH AUTHORS
retch developers.