NEOFETCH(1) User Commands NEOFETCH(1)

Neofetch - A fast, highly customizable system info script

neofetch func_name --option "value" --option "value"

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.

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[@]##*: }")
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'
Hide/Show Fully Qualified Domain Name in title.
Hide/Show Package Manager names . (on, tiny, off)
Hide/Show OS architecture.
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.
Whether or not to show decimals in CPU speed.
1 GHz.
Enable/Disable CPU brand in output.
Whether or not to display the number of CPU cores Possible values: logical, physical, off
NOTE: 'physical' doesn't work on BSD.
Hide/Show cpu speed.
Hide/Show cpu temperature.
NOTE: This only works on Linux and BSD.
coretemp kernel module. This only supports newer Intel processors.
Shorten the output of distro (on, tiny, off)
NOTE: This option won't work in Windows (Cygwin)
Shorten the output of kernel
NOTE: This option won't work in BSDs (except PacBSD and PC-BSD)
Shorten the output of uptime (on, tiny, off)
Whether to display the refresh rate of each monitor Unsupported on Windows
Enable/Disable GPU brand in output. (AMD/NVIDIA/Intel)
Which GPU to display. (all, dedicated, integrated)
NOTE: This only supports Linux.
Show/Hide Desktop Environment version
Shorten output of gtk theme/icons
Enable/Disable gtk2 theme/font/icons output
Enable/Disable gtk3 theme/font/icons output
Enable/Disable showing $SHELL path
Enable/Disable showing $SHELL version
Which disks to display. Possible values: '/', '/dev/sdXX', '/path/to/mount point'
NOTE: Multiple values can be given. (--disk_show '/' '/dev/sdc1')
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.
Hide/Show disk percent.
URL to query for public IP
Public IP timeout (in seconds).
Print the song data in a specific format (see config file).
Print the Artist/Album/Title on separate lines.
Display memory percentage.
Manually specify a player to use. Available values are listed in the config file

Changes the text colors in this order: title, @, underline, subtitle, colon, info
Enable/Disable the underline.
Character to use when underlining title
Enable/Disable bold text
Changes the default ':' separator to the specified string.

Enable/Disable the color blocks
Left-padding of color blocks
Width of color blocks in spaces
Height of color blocks in lines
Range of colors to print as blocks

Characters to use when drawing bars.
Whether or not to surround the bar with '[]'
Length in spaces to make the bars.
Colors to make the bar. Set in this order: elapsed, total
Bar mode. Possible values: bar, infobar, barinfo, off
Bar mode. Possible values: bar, infobar, barinfo, off
Bar mode. Possible values: bar, infobar, barinfo, off
Bar mode. Possible values: bar, infobar, barinfo, off

Which image backend to use. Possible values: 'ascii', 'caca', 'chafa', 'jp2a', 'iterm2', 'off', 'sixel', 'tycat', 'w3m', 'kitty'
Which image or ascii file to use. Possible values: 'auto', 'ascii', 'wallpaper', '/path/to/img', '/path/to/ascii', '/path/to/dir/', 'command output' [ascii]
Shortcut to use 'ascii' backend.
NEW: neofetch --ascii "$(fortune | cowsay -W 30)"
Shortcut to use 'caca' backend.
Shortcut to use 'chafa' backend.
Shortcut to use 'iterm2' backend.
Shortcut to use 'jp2a' backend.
Shortcut to use 'kitty' backend.
Shortcut to use 'pixterm' backend.
Shortcut to use 'sixel' backend.
Shortcut to use 'termpix' backend.
Shortcut to use 'tycat' backend.
Shortcut to use 'w3m' backend.
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/'

Colors to print the ascii art
Which Distro's ascii art to print
"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.
Ubuntu-Studio, Ubuntu-Mate or Ubuntu-Budgie to use the flavors.
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.
Whether or not to bold the ascii logo.
Hide the info text and only show the ascii logo.

Redraw the image constantly until Ctrl+C is used. This fixes issues in some terminals emulators when using image mode.
How to size the image. Possible values: auto, 00px, 00%, none
Which crop mode to use Takes the values: normal, fit, fill
Change the crop offset for normal mode. Possible values: northwest, north, northeast, west, center, east, southwest, south, southeast
How close the image will be to the left edge of the window. This only works with w3m.
How close the image will be to the top edge of the window. This only works with w3m.
Background color to display behind transparent image. This only works with w3m.
Gap between image and text.
closer to the left side.
Delete cached files and thumbnails.

Specify a path to a custom config file
Launch the script without a config file
Don't create the user config file.
Print the default config file to stdout.
Turn off all colors and disables any ASCII/image backend.
Print this text and exit
Show neofetch version
Display error messages.
Display a verbose log for error reporting.

Generate a manpage for Neofetch in your PWD. (Requires GNU help2man)

Report bugs to

Aug 2020 Neofetch 7.1.0