.\" A little documentation for future use
.\" This a comment
.\" TH request sets the title of the man page and the section (between 1 and 8)
.\" SH is a primary section heading
.\" TP sets up an indented paragraph with label
.\" B makes text appear in bold face
.\" I makes text appear in italic face
.\" inline versions would look like \fBthis\fR and \fIthis\fR
.\" EX and EE surrounds example section with text as is, with no empty lines in between the actual lines
.TH UWUFETCH 1 "14 July 2024" "2.1" "A meme system info tool for Linux"
.SH DESCRIPTION
UwUfetch is a program inspired by neofetch and ufetch, that takes system information and prints it in terminal in an UwU way, with either UwU ascii or image logo.
.SH SYNOPSYS
\fBuwufetch\fR [\fIOPTIONS\fR] [\fIARGUMENTS\fR]
.SH OPTIONS
.TP
.B -c --config
you can change config path
.TP
.B -d --distro
lets you choose the logo to print based on the distribution name
.TP
.B -h --help
prints the help page
.TP
.B -i --image
prints image instead of ascii logo uses a custom image if one is provided (disabled on iOS)
works in most terminals, read README.md for more info
.TP
.B -l --list
prints a list of all supported distributions
.TP
.B -r --read-cache
reads the cache file (~/.cache/uwufetch.cache)
.TP
.B -v --version
prints the current uwufetch version
.TP
.B -w --write-cache
writes to the cache file (~/.cache/uwufetch.cache)
.SH CONFIGURATION
The system-wide config file is /etc/uwufetch/config, and you can use it to configure uwufetch globally or as a template for your own config.
The user config file is located in $HOME/.config/uwufetch/config (you need to create it), but you can change the path by using the \fB--config\fR option.
.TP
.SH EXAMPLE
.EX
distro=arch
image=path/to/custom/image.png
user=true
os=true
host=true
kernel=true
cpu=true
gpu=0
gpu=3
gpu=1
ram=true
resolution=true
shell=true
pkgs=true
uptime=true
colors=true
.EE
.SH SUPPORTED DISTRIBUTIONS
Distribution name -d \fBoption\fR
.TP
.SH FULLY SUPPORTED
.EX
AmogOwOs            \fBamogos\fR
Nyalpine            \fBalpine\fR
Nyarch Linuwu       \fBarch\fR
ArcOwO Linuwu       \fBarcolinux\fR
Nyartix Linuwu      \fBartix\fR
Debinyan            \fBdebian\fR
endeavOwO           \fBendeavour\fR
Fedowa              \fBfedora\fR
GentOwO             \fBgentoo\fR
GnUwU gUwUix        \fBguix\fR
Miwint              \fBlinuxmint\fR
Myanjawo            \fBmanjaro\fR
Myanjawo AWM        \fBmanjaro-arm\fR
OwOpenSUSE          \fBopensuse-leap\fR
Pop OwOs            \fBpop\fR
RaspNyan            \fBraspbian\fR
Swackwawe           \fBslackware\fR
sOwOlus             \fBsolus\fR
UwUntu              \fBubuntu\fR
OwOid               \fBvoid\fR
Nyandroid           \fBandroid\fR
Unknown (tux logo)  \fBunknown\fR
.EE
.TP
.SH IMAGE OR ASCII ONLY
.EX
Dewepyn       \fBdeepin\fR
FemboyOWOS    \fBfemboyos\fR
KDE NeOwOn    \fBneon\fR
nixOwOs       \fBnixos\fR
xuwulinux     \fBxerolinux\fR
Wocky Linuwu  \fBrocky\fR
FweeBSD       \fBfreebsd\fR
OwOpenBSD     \fBopenbsd\fR
macOwOS       \fBmacos\fR
iOwOS         \fBios\fR
WinyandOwOws  \fBwindows\fR
.EE
.SH EXAMPLES
.EX
uwufetch -d arch                  # uses ascii Arch logo
uwufetch -i some_image.png  # prints custom image (no full path is needed)
uwufetch -id artix              # uses Artix image logo (which is also uwu)
.EE
.SH DEPENDENCIES
.TP 8
.B freecolor
ram usage on FreeBSD
.TP
.B libc (required)
glibc on gnu systems or musl on non-gnu systems
.TP
.B viu
print images instead of ascii logo
.TP
.B xwininfo
get screen resolution
.TP
.B lshw
better gpu info
.TP
.B kitty
better image viewing
.P
All of these dependencies are optional. There are no required dependencies (except libc).
.SH LICENSE AND COPYRIGHT
uwufetch is provided under the GPL3 license, for copyright info read https://github.com/TheDarkBug/uwufetch/tree/main/res/COPYRIGHT.md.