--- name: "neofetch" section: "1" platform: "linux" package: "neofetch" version: "7.1.0-4" release: "Debian 12 (Bookworm)" platforms: ["linux"] url: "https://new.carta.tech/neofetch" --- # neofetch(1) A fast, highly customizable system info script ## NAME Neofetch - A fast, highly customizable system info script ## SYNOPSIS **neofetch** *func\_name --option "value" --option "value"* ## DESCRIPTION Neofetch is a CLI system information tool written in BASH. Neofetch displays information about your system next to an image, your OS logo, or any ASCII file of your choice. NOTE: Every launch flag has a config option. ## OPTIONS ### INFO: - func\_name Specify a function name (second part of info() from config) to quickly display only that function's information. - Example: neofetch uptime **--uptime\_shorthand** tiny - Example: neofetch uptime disk wm memory - This can be used in bars and scripts like so: - memory="$(neofetch memory)"; memory="${memory##\*: }" - For multiple outputs at once (each line of info in an array): - IFS=$'\\n' read **-d** "" **-ra** info \< \<(neofetch memory uptime wm) - info=("${info\[@\]##\*: }") - **--disable** infoname Allows you to disable an info line from appearing in the output. 'infoname' is the function name from the 'print\_info()' function inside the config file. For example: 'info "Memory" memory' would be '--disable memory' - NOTE: You can supply multiple args. eg. 'neofetch **--disable** cpu gpu' - **--title\_fqdn** on/off Hide/Show Fully Qualified Domain Name in title. - **--package\_managers** on/off Hide/Show Package Manager names . (on, tiny, off) - **--os\_arch** on/off Hide/Show OS architecture. - **--speed\_type** type Change the type of cpu speed to display. Possible values: current, min, max, bios, scaling\_current, scaling\_min, scaling\_max - NOTE: This only supports Linux with cpufreq. - **--speed\_shorthand** on/off Whether or not to show decimals in CPU speed. - NOTE: This flag is not supported in systems with CPU speed less than 1 GHz. - **--cpu\_brand** on/off Enable/Disable CPU brand in output. - **--cpu\_cores** type Whether or not to display the number of CPU cores Possible values: logical, physical, off - NOTE: 'physical' doesn't work on BSD. - **--cpu\_speed** on/off Hide/Show cpu speed. - **--cpu\_temp** C/F/off Hide/Show cpu temperature. - NOTE: This only works on Linux and BSD. - NOTE: For FreeBSD and NetBSD-based systems, you need to enable coretemp kernel module. This only supports newer Intel processors. - **--distro\_shorthand** on/off Shorten the output of distro (on, tiny, off) - NOTE: This option won't work in Windows (Cygwin) - **--kernel\_shorthand** on/off Shorten the output of kernel - NOTE: This option won't work in BSDs (except PacBSD and PC-BSD) - **--uptime\_shorthand** on/off Shorten the output of uptime (on, tiny, off) - **--refresh\_rate** on/off Whether to display the refresh rate of each monitor Unsupported on Windows - **--gpu\_brand** on/off Enable/Disable GPU brand in output. (AMD/NVIDIA/Intel) - **--gpu\_type** type Which GPU to display. (all, dedicated, integrated) - NOTE: This only supports Linux. - **--de\_version** on/off Show/Hide Desktop Environment version - **--gtk\_shorthand** on/off Shorten output of gtk theme/icons - **--gtk2** on/off Enable/Disable gtk2 theme/font/icons output - **--gtk3** on/off Enable/Disable gtk3 theme/font/icons output - **--shell\_path** on/off Enable/Disable showing $SHELL path - **--shell\_version** on/off Enable/Disable showing $SHELL version - **--disk\_show** value Which disks to display. Possible values: '/', '/dev/sdXX', '/path/to/mount point' - NOTE: Multiple values can be given. (**--disk\_show** '/' '/dev/sdc1') - **--disk\_subtitle** type What information to append to the Disk subtitle. Takes: name, mount, dir, none - 'name' shows the disk's name (sda1, sda2, etc) - 'mount' shows the disk's mount point (/, */mnt/Local* Disk, etc) - 'dir' shows the basename of the disks's path. (/, Local Disk, etc) - 'none' shows only 'Disk' or the configured title. - **--disk\_percent** on/off Hide/Show disk percent. - **--ip\_host** url URL to query for public IP - **--ip\_timeout** int Public IP timeout (in seconds). - **--song\_format** format Print the song data in a specific format (see config file). - **--song\_shorthand** on/off Print the Artist/Album/Title on separate lines. - **--memory\_percent** on/off Display memory percentage. - **--music\_player** player-name Manually specify a player to use. Available values are listed in the config file ### TEXT FORMATTING: - **--colors** x x x x x x Changes the text colors in this order: title, @, underline, subtitle, colon, info - **--underline** on/off Enable/Disable the underline. - **--underline\_char** char Character to use when underlining title - **--bold** on/off Enable/Disable bold text - **--separator** string Changes the default ':' separator to the specified string. ### COLOR BLOCKS: - **--color\_blocks** on/off Enable/Disable the color blocks - **--col\_offset** auto/num Left-padding of color blocks - **--block\_width** num Width of color blocks in spaces - **--block\_height** num Height of color blocks in lines - **--block\_range** num num Range of colors to print as blocks ### BARS: - **--bar\_char** 'elapsed char' 'total char' Characters to use when drawing bars. - **--bar\_border** on/off Whether or not to surround the bar with '\[\]' - **--bar\_length** num Length in spaces to make the bars. - **--bar\_colors** num num Colors to make the bar. Set in this order: elapsed, total - **--cpu\_display** mode Bar mode. Possible values: bar, infobar, barinfo, off - **--memory\_display** mode Bar mode. Possible values: bar, infobar, barinfo, off - **--battery\_display** mode Bar mode. Possible values: bar, infobar, barinfo, off - **--disk\_display** mode Bar mode. Possible values: bar, infobar, barinfo, off ### IMAGE BACKEND: - **--backend** backend Which image backend to use. Possible values: 'ascii', 'caca', 'chafa', 'jp2a', 'iterm2', 'off', 'sixel', 'tycat', 'w3m', 'kitty' - **--source** source Which image or ascii file to use. Possible values: 'auto', 'ascii', 'wallpaper', '/path/to/img', '/path/to/ascii', '/path/to/dir/', 'command output' \[ascii\] - **--ascii** source Shortcut to use 'ascii' backend. - NEW: neofetch **--ascii** "$(fortune \| cowsay **-W** 30)" - **--caca** source Shortcut to use 'caca' backend. - **--chafa** source Shortcut to use 'chafa' backend. - **--iterm2** source Shortcut to use 'iterm2' backend. - **--jp2a** source Shortcut to use 'jp2a' backend. - **--kitty** source Shortcut to use 'kitty' backend. - **--pixterm** source Shortcut to use 'pixterm' backend. - **--sixel** source Shortcut to use 'sixel' backend. - **--termpix** source Shortcut to use 'termpix' backend. - **--tycat** source Shortcut to use 'tycat' backend. - **--w3m** source Shortcut to use 'w3m' backend. - **--off** Shortcut to use 'off' backend (Disable ascii art). - NOTE: 'source; can be any of the following: 'auto', 'ascii', 'wallpaper', '/path/to/img', '/path/to/ascii', '/path/to/dir/' ### ASCII: - **--ascii\_colors** x x x x x x Colors to print the ascii art - **--ascii\_distro** distro Which Distro's ascii art to print - NOTE: AIX, Alpine, AlterLinux, Anarchy, Android, Antergos, antiX, "AOSC OS", "AOSC OS/Retro", Apricity, ArcoLinux, ArchBox, ARCHlabs, ArchStrike, XFerience, ArchMerge, Arch, Artix, Arya, Bedrock, Bitrig, BlackArch, BLAG, BlankOn, BlueLight, bonsai, BSD, BunsenLabs, Calculate, Carbs, CentOS, Chakra, ChaletOS, Chapeau, Chrom, Cleanjaro, ClearOS, Clear\_Linux, Clover, Condres, Container\_Linux, CRUX, Cucumber, Debian, Deepin, DesaOS, Devuan, DracOS, DragonFly, Drauger, Elementary, EndeavourOS, Endless, EuroLinux, Exherbo, Fedora, Feren, FreeBSD, FreeMiNT, Frugalware, Funtoo, GalliumOS, Gentoo, Pentoo, gNewSense, GNOME, GNU, GoboLinux, Grombyang, Guix, Haiku, Huayra, Hyperbola, janus, Kali, KaOS, KDE\_neon, Kibojoe, Kogaion, Korora, KSLinux, Kubuntu, LEDE, LFS, Linux\_Lite, LMDE, Lubuntu, Lunar, macos, Mageia, MagpieOS, Mandriva, Manjaro, Maui, Mer, Minix, LinuxMint, MX\_Linux, Namib, Neptune, NetBSD, Netrunner, Nitrux, NixOS, Nurunner, NuTyX, OBRevenge, OpenBSD, OpenIndiana, openmamba, OpenMandriva, OpenStage, OpenWrt, osmc, Oracle, OS Elbrus, PacBSD, Parabola, Pardus, Parrot, Parsix, TrueOS, PCLinuxOS, Peppermint, popos, Porteus, PostMarketOS, Proxmox, Puppy, PureOS, Qubes, Radix, Raspbian, Reborn\_OS, Redstar, Redcore, Redhat, Refracted\_Devuan, Regata, Rosa, sabotage, Sabayon, Sailfish, SalentOS, Scientific, Septor, SereneLinux, SharkLinux, Siduction, Slackware, SliTaz, SmartOS, Solus, Source\_Mage, Sparky, Star, SteamOS, SunOS, openSUSE\_Leap, openSUSE\_Tumbleweed, openSUSE, SwagArch, Tails, Trisquel, Ubuntu-Budgie, Ubuntu-GNOME, Ubuntu-MATE, Ubuntu-Studio, Ubuntu, Venom, Void, Obarun, windows10, Windows7, Xubuntu, Zorin, and IRIX have ascii logos - NOTE: Arch, Ubuntu, Redhat, and Dragonfly have 'old' logo variants. - NOTE: Use '{distro name}\_old' to use the old logos. - NOTE: Ubuntu has flavor variants. - NOTE: Change this to Lubuntu, Kubuntu, Xubuntu, Ubuntu-GNOME, Ubuntu-Studio, Ubuntu-Mate or Ubuntu-Budgie to use the flavors. - NOTE: Arcolinux, Dragonfly, Fedora, Alpine, Arch, Ubuntu, CRUX, Debian, Gentoo, FreeBSD, Mac, NixOS, OpenBSD, android, Antrix, CentOS, Cleanjaro, ElementaryOS, GUIX, Hyperbola, Manjaro, MXLinux, NetBSD, Parabola, POP\_OS, PureOS, Slackware, SunOS, LinuxLite, OpenSUSE, Raspbian, postmarketOS, and Void have a smaller logo variant. - NOTE: Use '{distro name}\_small' to use the small variants. - **--ascii\_bold** on/off Whether or not to bold the ascii logo. - **-L**, **--logo** Hide the info text and only show the ascii logo. ### IMAGE: - **--loop** Redraw the image constantly until Ctrl+C is used. This fixes issues in some terminals emulators when using image mode. - **--size** 00px \| **--size** 00% How to size the image. Possible values: auto, 00px, 00%, none - **--crop\_mode** mode Which crop mode to use Takes the values: normal, fit, fill - **--crop\_offset** value Change the crop offset for normal mode. Possible values: northwest, north, northeast, west, center, east, southwest, south, southeast - **--xoffset** px How close the image will be to the left edge of the window. This only works with w3m. - **--yoffset** px How close the image will be to the top edge of the window. This only works with w3m. - **--bg\_color** color Background color to display behind transparent image. This only works with w3m. - **--gap** num Gap between image and text. - NOTE: **--gap** can take a negative value which will move the text closer to the left side. - **--clean** Delete cached files and thumbnails. ### OTHER: - **--config** */path/to/config* Specify a path to a custom config file - **--config** none Launch the script without a config file - **--no\_config** Don't create the user config file. - **--print\_config** Print the default config file to stdout. - **--stdout** Turn off all colors and disables any ASCII/image backend. - **--help** Print this text and exit - **--version** Show neofetch version - **-v** Display error messages. - **-vv** Display a verbose log for error reporting. ### DEVELOPER: - **--gen-man** Generate a manpage for Neofetch in your PWD. (Requires GNU help2man) ## REPORTING BUGS Report bugs to https://github.com/dylanaraps/neofetch/issues