.\" Automatically generated by Pandoc 3.1.12.1
.\"
.TH "" "" "" "" ""
.SH leenfetch \[em] User Commands
.SS NAME
leenfetch \[em] a fast, customizable system information tool (Neofetch
clone)
.SS SYNOPSIS
.IP
.EX
leenfetch [OPTIONS]
.EE
.SS DESCRIPTION
\f[B]leenfetch\f[R] is a modern, fast, and highly configurable system
information tool written in Rust.
It displays system information alongside a distribution logo or custom
ASCII art, similar to Neofetch, and is designed for both terminal
enthusiasts and new users.
.PP
Configuration is handled via human\-friendly RON files, with detailed
comments to guide users through all available options.
.PP
leenfetch can also accept \f[B]piped input\f[R] to render as ASCII art.
This allows users to display custom text logos via standard input.
.SS OPTIONS
.IP \[bu] 2
\f[CR]\-v\f[R], \f[CR]\-\-version\f[R]
.PD 0
.P
.PD
Print version information and exit.
.IP \[bu] 2
\f[CR]\-h\f[R], \f[CR]\-\-help\f[R]
.PD 0
.P
.PD
Show a help message and exit.
.IP \[bu] 2
\f[CR]\-l\f[R], \f[CR]\-\-list\-options\f[R]
.PD 0
.P
.PD
List all available configuration options and their possible values.
.IP \[bu] 2
\f[CR]\-i\f[R], \f[CR]\-\-init\f[R]
.PD 0
.P
.PD
Create default configuration files in the user config directory if they
do not exist.
.IP \[bu] 2
\f[CR]\-r\f[R], \f[CR]\-\-reinit\f[R]
.PD 0
.P
.PD
Delete existing configuration files and regenerate them with default
values.
.IP \[bu] 2
\f[CR]\-\-ascii_distro <DISTRO>\f[R]
.PD 0
.P
.PD
Override the ASCII art distribution for this run (e.g., \[lq]arch\[rq],
\[lq]ubuntu\[rq], \[lq]debian\[rq]).
.IP \[bu] 2
\f[CR]\-\-ascii_colors <COLORS>\f[R]
.PD 0
.P
.PD
Override the ASCII art color palette for this run (comma\-separated
list, e.g., \[lq]1,2,3,4,5,6,7\[rq]).
.IP \[bu] 2
\f[CR]\-\-custom_ascii_path <PATH>\f[R]
.PD 0
.P
.PD
Use a custom ASCII art file for this run.
.IP \[bu] 2
\f[CR]terminal stdin\f[R]
.PD 0
.P
.PD
Read ASCII logo content from standard input instead of using built\-in
or custom files.
.SS CONFIGURATION
leenfetch uses RON files for configuration, typically located at:
.IP
.EX
$XDG_CONFIG_HOME/leenfetch/
\[ti]/.config/leenfetch/
.EE
.PP
The main configuration files are: \- \f[B]flags.ron\f[R]: Controls
display options, such as which fields to show, formatting, and output
style.
\- \f[B]toggles.ron\f[R]: Enables or disables specific modules (e.g.,
show/hide GPU, battery, song info, etc.).
\- \f[B]layout.ron\f[R]: Controls the order and grouping of displayed
information.
.PP
Each config file is heavily commented to explain all available options
and their effects.
.SS EXAMPLES
.IP \[bu] 2
\f[CR]leenfetch\f[R]
.PD 0
.P
.PD
Display system information using the current configuration.
.IP \[bu] 2
\f[CR]leenfetch \-\-ascii_distro debian\f[R]
.PD 0
.P
.PD
Show system info with Debian ASCII art, regardless of detected distro.
.IP \[bu] 2
\f[CR]leenfetch \-\-init\f[R]
.PD 0
.P
.PD
Create default config files if missing.
.IP \[bu] 2
\f[CR]leenfetch \-\-reinit\f[R]
.PD 0
.P
.PD
Delete and regenerate all config files.
.IP \[bu] 2
\f[CR]echo \[dq]Rustacean\[dq] | leenfetch\f[R]
.PD 0
.P
.PD
Display system info with a piped ASCII logo generated from the input
text.
.IP \[bu] 2
\f[CR]fortune | cowsay | leenfetch\f[R]
.PD 0
.P
.PD
fortune generates a random quote.
cowsay wraps it in a cow speech bubble (ASCII art).
leenfetch takes piped input and displays it as an ASCII logo.
.SS ENVIRONMENT
.IP \[bu] 2
\f[B]XDG_CONFIG_HOME\f[R]: Specifies the base directory for
user\-specific configuration files.
Defaults to \f[CR]\[ti]/.config\f[R] if not set.
.SS FILES
.IP \[bu] 2
\f[CR]\[ti]/.config/leenfetch/flags.ron\f[R]
.IP \[bu] 2
\f[CR]\[ti]/.config/leenfetch/toggles.ron\f[R]
.IP \[bu] 2
\f[CR]\[ti]/.config/leenfetch/layout.ron\f[R]
.SS BUGS
Please report bugs or feature requests at:
.PD 0
.P
.PD
https://github.com/drunkleen/leenfetch/issues
.SS AUTHOR
Written by DrunkLeen \c
.MT snape@drunkleen.com
.ME \c