.\" Automatically generated by Pandoc 3.4
.\"
.TH "leenfetch" "1" "" "Leenfetch 1.0.2" "Manual"
.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 lives in a single JSON\-with\-comments file
(\f[CR]config.jsonc\f[R]), with inline explanations for every option.
.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 the default configuration file in the user config directory if it
does not exist.
.IP \[bu] 2
\f[CR]\-r\f[R], \f[CR]\-\-reinit\f[R]
.PD 0
.P
.PD
Delete the configuration file and regenerate it 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 a single JSONC file for configuration, typically located
at:
.IP
.EX
$XDG_CONFIG_HOME/leenfetch/
\[ti]/.config/leenfetch/
.EE
.PP
The configuration file is: \- \f[B]config.jsonc\f[R]: Includes
\f[CR]flags\f[R], an ordered \f[CR]modules\f[R] (\f[CR]layout\f[R])
array, and an optional \f[CR]logo\f[R] override.
Use strings like \f[CR]\[dq]break\[dq]\f[R] for spacers or objects with
\f[CR]type\f[R]/\f[CR]key\f[R] to control the output.
JSONC keeps comments intact so every option is documented in place.
.PP
Edit the file to adjust appearance, enabled modules, spacing, or output
order.
.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 the default config file if missing.
.IP \[bu] 2
\f[CR]leenfetch \-\-reinit\f[R]
.PD 0
.P
.PD
Delete and regenerate the config file.
.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 FILE
.IP \[bu] 2
\f[CR]\[ti]/.config/leenfetch/config.jsonc\f[R]
.SS WIKI
Please report bugs or feature requests at:
.PD 0
.P
.PD
https://github.com/drunkleen/leenfetch/wiki
.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