NEOFETCH

Section: User Commands (1)
Updated: August 2019
Page Index
 

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'
--package_managers on/tiny/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/tiny/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/tiny/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.
--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
'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)
--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
--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'
--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: Arch and Ubuntu have 'old' logo variants.
NOTE: Use 'arch_old' or 'ubuntu_old' to use the old logos.
NOTE: Ubuntu has flavor variants.
NOTE: Change this to 'Lubuntu', 'Xubuntu', 'Ubuntu-GNOME',
'Ubuntu-Studio' or 'Ubuntu-Budgie' to use the flavors.
NOTE: Alpine, Arch, CRUX, Debian, Gentoo, FreeBSD, Mac, NixOS,
OpenBSD, 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
--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


 

Index

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
INFO:
TEXT FORMATTING:
COLOR BLOCKS:
BARS:
IMAGE BACKEND:
ASCII:
IMAGE:
OTHER:
DEVELOPER:
REPORTING BUGS
LinuxReviews : manual page archive : man1