Neofetch

From Gentoo Wiki
Jump to:navigation Jump to:search
This article is a stub. Please help out by expanding it - how to get started.

Neofetch is a command-line system information tool that displays information about the operating system, software, and hardware in an aesthetic and visually pleasing way. Neofetch is written in bash 3.2+. As of April 26th, 2024, the original neofetch is no longer maintained, but some of its forks are still updated.

Installation

USE flags

USE flags for app-misc/neofetch Simple information system script

X Enable support for detecting DEs, WMs, screen resolutions, and showing images from an X terminal

Emerge

root #emerge --ask app-misc/neofetch

Alternative implementations

Alternatively, other fetch implementations exist. Fastfetch, written in C, is designed to be a faster version of neofetch. Hyfetch, written in Python, optionally but primarily colors the distro's logo with a pride flag.

fastfetch

See: Fastfetch

hyfetch

root #emerge --ask app-misc/hyfetch
Note
app-misc/hyfetch has an updated, original version of neofetch, which is launched with 'neowofetch'.

Configuration

Files

  • ${HOME}/.config/neofetch/config.conf - User configuration file for neofetch and neowofetch. For more information on customizing check out the Neofetch's wiki.

Usage

neofetch can be used to determine basic system information by issuing the command without any options:

user $neofetch
         -/oyddmdhs+:.                larry@gentoo
     -odNMMMMMMMMNNmhy+-`             ------------
   -yNMMMMMMMMMMMNNNmmdhy+-           OS: Gentoo Base System release 2.8 x86_64
 `omMMMMMMMMMMMMNmdmmmmddhhy/`        Kernel: 5.14.7-gentoo-x86_64
 omMMMMMMMMMMMNhhyyyohmdddhhhdo`      Uptime: 75 days, 7 hours, 19 mins
.ydMMMMMMMMMMdhs++so/smdddhhhhdm+`    Packages: 1279 (emerge)
 oyhdmNMMMMMMMNdyooydmddddhhhhyhNd.   Shell: bash 5.1.12
  :oyhhdNNMMMMMMMNNNmmdddhhhhhyymMh   Terminal: /dev/pts/0
    .:+sydNMMMMMNNNmmmdddhhhhhhmMmy   CPU: AMD Phenom II X4 955 (4) @ 3.200GHz
       /mMMMMMMNNNmmmdddhhhhhmMNhs:   GPU: NVIDIA GeForce4 MX 4000
    `oNMMMMMMMNNNmmmddddhhdmMNhs+`    Memory: 463MiB / 5872MiB
  `sNMMMMMMMMNNNmmmdddddmNMmhs/.
 /NMMMMMMMMNNNNmmmdddmNMNdso:`
+MMMMMMMNNNNNmmmmdmNMNdso/-
yMMNNNNNNNmmmmmNNMmhs+/-`
/hMMNNNNNNNNMNdhs++/-`
`/ohdmmddhys+++/:.`
  `-//////:--.

When running hyfetch, a configuration utility will be launched. A 74 * 30 terminal is the recommended minimum requirement.

Invocation

user $neofetch --help
Usage: 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.
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).
    --ip_interface value        Interface(s) to use for local IP
    --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.
    --memory_unit kib/mib/gib   Memory output unit.
    --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
    --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', 'catimg', 'chafa', 'jp2a',
                                'iterm2', 'off', 'sixel', 'tycat', 'w3m', 'kitty', 'viu'
    --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.
    --catimg source             Shortcut to use 'catimg' 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.
    --pot source                Shortcut to use 'pot' 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.
    --ueberzug source           Shortcut to use 'ueberzug' backend
    --viu source                Shortcut to use 'viu' 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, Hash, Alpine, AlterLinux, Amazon, Anarchy, Android,
                                instantOS, Antergos, antiX, \"AOSC OS\", \"AOSC OS/Retro\",
                                Apricity, ArchCraft, ArcoLinux, ArchBox, ARCHlabs, ArchStrike,
                                XFerience, ArchMerge, Arch, Artix, Arya, Bedrock, Bitrig,
                                BlackArch, BLAG, BlankOn, BlueLight, Bodhi, bonsai, BSD, BunsenLabs,
                                Calculate, Carbs, CentOS, Chakra, ChaletOS, Chapeau, Chrom,
                                Cleanjaro, ClearOS, Clear_Linux, Clover, Condres, Container_Linux,
                                Crystal Linux, CRUX, Cucumber, dahlia, Debian, Deepin, DesaOS, Devuan,
                                DracOS, DarkOs, Itc, DragonFly, Drauger, Elementary, EndeavourOS, Endless,
                                EuroLinux, Exherbo, Fedora, Feren, FreeBSD, FreeMiNT, Frugalware,
                                Funtoo, GalliumOS, Garuda, Gentoo, Pentoo, gNewSense, GNOME, GNU,
                                GoboLinux, Grombyang, Guix, Haiku, Huayra, Hyperbola, iglunix, janus, Kali,
                                KaOS, KDE_neon, Kibojoe, Kogaion, Korora, KSLinux, Kubuntu, LEDE,
                                LaxerOS, LibreELEC, LFS, Linux_Lite, LMDE, Lubuntu, Lunar, macos,
                                Mageia, MagpieOS, Mandriva, Manjaro, TeArch, Maui, Mer, Minix, LinuxMint,
                                Live_Raizo, MX_Linux, Namib, Neptune, NetBSD, Netrunner, Nitrux,
                                NixOS, Nurunner, NuTyX, OBRevenge, OpenBSD, openEuler, OpenIndiana,
                                openmamba, OpenMandriva, OpenStage, OpenWrt, osmc, Oracle,
                                OS Elbrus, PacBSD, Parabola, Pardus, Parrot, Parsix, TrueOS,
                                PCLinuxOS, Pengwin, Peppermint, Pisi, popos, Porteus, PostMarketOS,
                                Proxmox, PuffOS, Puppy, PureOS, Qubes, Qubyt, Quibian, Radix, Raspbian, Reborn_OS,
                                Redstar, Redcore, Redhat, Refracted_Devuan, Regata, Regolith, Rosa,
                                sabotage, Sabayon, Sailfish, SalentOS, Scientific, Septor,
                                SereneLinux, SharkLinux, Siduction, Slackware, SliTaz, SmartOS,
                                Solus, Source_Mage, Sparky, Star, SteamOS, SunOS, openSUSE_Leap,
                                t2, openSUSE_Tumbleweed, openSUSE, SwagArch, Tails, Trisquel,
                                Ubuntu-Cinnamon, Ubuntu-Budgie, Ubuntu-GNOME, Ubuntu-MATE,
                                Ubuntu-Studio, Ubuntu, Univention, Venom, Void, VNux, LangitKetujuh, semc,
                                Obarun, windows10, Windows7, Xubuntu, Zorin, and IRIX have ascii logos.
                                NOTE: Arch, Ubuntu, Redhat, Fedora 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,
                                Artix, 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
    --catimg_size 1/2           Change the resolution of catimg.
    --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)
Report bugs to https://github.com/dylanaraps/neofetch/issues

External resources