.\" Generated by scdoc 1.11.3
.\" Complete documentation for this program is not available as a GNU info page
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.nh
.ad l
.\" Begin generated content:
.TH "MACCHINA" "1" "2024-09-29"
.PP
.SH NAME
.PP
macchina - A system information frontend, with an (unhealthy) emphasis
on performance.\&
.PP
.SH SYNOPSIS
.PP
\fBmacchina\fR [FLAGS]
.PP
.SH FLAGS
.PP
\fB-d, --doctor\fR
.RS 4
Checks the system for failures.\&
.PP
.RE
\fB-e, --export-config\fR
.RS 4
Prints a template configuration file to stdout.\&
.PP
.RE
\fB-c, --config\fR=\fIFILE\fR
.RS 4
Specify a custom path to a configuration file.\&
.PP
This is helpful in cases where macchina fails to parse the configuration
file from the default path, i.\&e.\& \fB$XDG_CONFIG_HOME/macchina/macchina.\&toml\fR.\&
.PP
.RE
\fB-l, --list-themes\fR
.RS 4
Lists all available themes.\&
.PP
Themes are \fBTOML\fR files which must be placed in
\fB$XDG_CONFIG_HOME/macchina/themes\fR.\&  Whatever this flag
returns to the console can be used with the \fB--theme\fR flag.\&
.PP
.RE
\fB-t, --theme\fR=\fITHEME\fR
.RS 4
Specify the name of the theme to use, i.\&e.\& its basename and
without the ".\&toml" extension.\&
.PP
You should verify whether macchina was able to find your theme
with \fB--list-themes\fR.\&
.PP
.RE
\fB-i, --interface\fR=\fIIF_NAME\fR
.RS 4
Specify the network interface for the LocalIP readout, e.\&g.\& "wlan0", "eth0".\&
.PP
.RE
\fB-s, --current-shell\fR
.RS 4
Toggles between the current shell, i.\&e.\& the parent of the terminal emulator, or the default one.\&
.PP
.RE
\fB-C, --logical-cores\fR
.RS 4
Toggles between logical and physical cores for the Processor readout.\&
.PP
.RE
\fB-K, --long-kernel\fR
.RS 4
Lengthens kernel output.\&
.PP
.RE
\fB-S, --long-shell\fR
.RS 4
Lengthens shell output.\&
.PP
.RE
\fB-U, --long-uptime\fR
.RS 4
Lengthens uptime output.\&
.PP
.RE
\fB-m, --memory-percentage\fR
.RS 4
Show memory usage in percentage
.PP
.RE
\fB-D, --disks\fR
.RS 4
Specify the disks for which the usage percentage will be shown
.PP
.RE
\fB-p, --disk-space-percentage\fR
.RS 4
Show disk space usage in percentage
.PP
.RE
\fB-h, --help\fR
.RS 4
Prints help information.\&
.PP
.RE
\fB-v, --version\fR
.RS 4
Prints version information.\&
.PP
.RE
\fB-o, --show\fR
.RS 4
Display only the specified readouts.\&
.PP
Please note that the order these are listed in will be the order that they are
displayed in.\&
.PP
Possible values are (case-sensitive):
.PD 0
.IP \(bu 4
Host
.IP \(bu 4
Machine
.IP \(bu 4
Kernel
.IP \(bu 4
Distribution
.IP \(bu 4
OperatingSystem
.IP \(bu 4
DesktopEnvironment
.IP \(bu 4
WindowManager
.IP \(bu 4
Packages
.IP \(bu 4
Shell
.IP \(bu 4
Terminal
.IP \(bu 4
LocalIP
.IP \(bu 4
Backlight
.IP \(bu 4
Resolution
.IP \(bu 4
Uptime
.IP \(bu 4
Processor
.IP \(bu 4
ProcessorLoad
.IP \(bu 4
Memory
.IP \(bu 4
Battery
.IP \(bu 4
GPU
.IP \(bu 4
DiskSpace
.PD
.PP
.RE
\fB--ascii-artists\fR
.RS 4
Lists the original artists of the ASCII art used by macchina.\&
.PP
.RE
.SH SEE ALSO
.PP
macchina(7)
.PP
.SH AUTHORS
.PP
Written and maintained by the Macchina-CLI team:
.PD 0
.IP \(bu 4
Taha Aziz Ben Ali <ba.\&tahaaziz@gmail.\&com>
.IP \(bu 4
Uttarayan Mondal <email@uttarayan.\&me>
.IP \(bu 4
Marvin Haschker <marvin@haschker.\&me>
.PD
.PP
.SH RESOURCES
.PP
This project is hosted at \fBhttps://github.\&com/Macchina-CLI/macchina\fR.\&