Skip to content

Neofetch

Neofetch is a command line output tool written in bash 3.2+. It displays information about your operating system, software and hardware in an aesthetic and visually pleasing way.

Installation from the repository

Neofetch can be installed through terminal:

shell
su -
apt-get update
apt-get install neofetch
shell
epm -i neofetch

Configuration

Neofetch has a fairly flexible configuration, and anyone can customize it for themselves.

Информация

This block discusses configuration using the example of one of the custom configurations.

To display it correctly, you must install one of the Nerd fonts.

default

The main visual part is configured in this function.

shell
print_info() {
    info title
    info underline
    info "OS" distro
    info "Host" model
    info "Kernel" kernel
    info "Uptime" uptime
    info "Packages" packages
    info "Shell" shell
    info "Resolution" resolution
    info "DE" de
    info "WM" wm
    info "WM Theme" wm_theme
    info "Theme" theme
    info "Icons" icons
    info "Terminal" term
    info "Terminal Font" term_font
    info "CPU" cpu
    info "GPU" gpu
    info "Memory" memory
    info cols
}

Term structure

The info function displays one of the system parameters.

shell
info "COMMENT" PARAMETR

Example:

shell
    info "Theme" theme
    info "Icons" icons
    info "Terminal" term
    info "CPU" cpu
    info "GPU" gpu

Output:

shell
Theme: Adwaita [GTK2/3]
Icons: Adwaita [GTK2/3]
Terminal: kgx
CPU: Intel Xeon E5-2640 v2 (16) @ 2.500GHz
GPU: AMD ATI Radeon RX 580 2048SP
Possible parameters
VariableValue
titleHeader (user@host)
underlineDividing line
distroDistribution
modelPC model
kernelCore
uptimeOpening hours
packagesPackages
shellShell
resolutionScreen resolution
deEnvironment
wmWindow manager
wm_themeWindow theme
themeSubject
iconsIcon theme
termTerminal
term_fontTerminal font
cpuCPU
gpuVideo card
memoryRAM
gpu_driverVideo card driver
diskDisk
batteryBattery
fontFont
songSong
local_ipLocal IP address
public_ipPublic IP address
usersUser
localeLocale
colsColor blocks

Title

Hide/Show FQDN

FlagValue
--title_fqdnon, off
shell
title_fqdn="off"
shell
title_fqdn="off"

Kernel

Shorten kernel function output

FlagValue
--kernel_shorthandon, off
shell
OS: ALT Regular Sisyphus x86_64
Kernel: 6.8.8-6.8-alt1
Uptime: 1 hour, 32 mins
shell
kernel_shorthand="on"
shell
kernel_shorthand="off"

Distribution

Shorten the output of the distro function

FlagValue
--distro_shorthandon, tiny, off
shell
distro_shorthand="off"
shell
distro_shorthand="off"

Hide/Show OS Architecture

FlagValue
--os_archon, off
shell
fiersik@alt-gnome
-----------------
OS: ALT Regular Sisyphus x86_64
Kernel: 6.8.8-6.8-alt1
shell
os_arch="on"
shell
os_arch="on"

Opening hours

Shorten uptime function output

FlagValue
--uptime_shorthandon, tiny, off
shell
OS: ALT Regular Sisyphus x86_64
Kernel: 6.8.8-6.8-alt1
Uptime: 1 hour, 47 mins
Packages: 2208 (rpm), 35 (flatpak)
Shell: zsh 5.9
shell
uptime_shorthand="on"
shell
uptime_shorthand="on"

Memory

Hide/show usage percentage

FlagValue
--memory_percenton, off
shell
Icons: Adwaita [GTK2/3]
Terminal: kgx
Memory: 6807MiB / 15982MiB (42%) 
CPU: Intel Xeon E5-2640 v2 (16) @ 2.500GHz
GPU: AMD ATI Radeon RX 580 2048SP
shell
memory_percent="off"
shell
memory_percent="on"

Change Memory Output Units

FlagValue
--memory_unitkib, mib, gib
shell
Icons: Adwaita [GTK2/3]
Terminal: kgx
Memory: 7144448KiB / 16365568KiB
CPU: Intel Xeon E5-2640 v2 (16) @ 2.500GHz
GPU: AMD ATI Radeon RX 580 2048SP
shell
memory_unit="mib"
shell
memory_unit="mib"

Packages

Hide/show package manager names

FlagValue
--package_managerson, tiny off
shell
Kernel: 6.8.8-6.8-alt1
Uptime: 1 hour, 56 mins
Packages: 2208 (rpm), 35 (flatpak), 4 (snap) 
Shell: zsh 5.9
Resolution: 1920x1080
shell
package_managers="tiny"
shell
package_managers="on"

Shell ($SHELL)

Hide/show shell path

FlagValue
--shell_pathon, off
shell
Uptime: 2 hours, 1 min
Packages: 2208 (rpm), 35 (flatpak)
Shell: /bin/zsh 5.9
Resolution: 1920x1080
DE: GNOME 46.1
shell
shell_path="off"
shell
shell_path="off"

Hide/show version

FlagValue
--shell_versionon, off
shell
Uptime: 2 hours, 1 min
Packages: 2208 (rpm), 35 (flatpak), 4 (snap)
Shell: zsh 5.9
Resolution: 1920x1080
DE: GNOME 46.1
shell
shell_version="on"
shell
shell_version="on"

Desktop environment

Hide/show version

FlagValue
--de_versionon, off
shell
Shell: zsh 5.9
Resolution: 1920x1080
DE: GNOME 46.1
WM: Mutter
WM Theme: Adwaita
shell
de_version="on"
shell
de_version="on"

Processor

Frequency type

FlagValue
--speed_typescaling_cur_freq, scaling_min_freq, scaling_max_freq, bios_limit
shell
speed_type="bios_limit"
shell
speed_type="scaling_cur_freq"

Reduce frequency

FlagValue
--speed_shorthandon, off.
shell
Theme: Adwaita [GTK2/3]
Icons: Adwaita [GTK2/3]
CPU: Intel Xeon E5-2640 v2 (16) @ 2.5GHz 
GPU: AMD ATI Radeon RX 580 2048SP
Memory: 7897MiB / 15982MiB
shell
speed_shorthand="off"
shell
speed_shorthand="on"

Hide/show brand

FlagValue
--cpu_brandon, off
shell
Theme: Adwaita [GTK2/3]
Icons: Adwaita [GTK2/3]
CPU: Intel Xeon E5-2640 v2 (16) @ 2.500GHz 
GPU: AMD ATI Radeon RX 580 2048SP
Memory: 7897MiB / 15982MiB
shell
cpu_brand="on"
shell
cpu_brand="off"

Hide/show frequency

FlagValue
--cpu_speedon, off
shell
Theme: Adwaita [GTK2/3]
Icons: Adwaita [GTK2/3]
CPU: Xeon E5-2640 v2 (16) @ 2.500GHz 
GPU: AMD ATI Radeon RX 580 2048SP
Memory: 7897MiB / 15982MiB
shell
cpu_speed="on"
shell
cpu_speed="on"

Hide/Show Cores

FlagValue
--cpu_coreslogical, physical, off
shell
Theme: Adwaita [GTK2/3]
Icons: Adwaita [GTK2/3]
CPU: Xeon E5-2640 v2 (16) @ 2.500GHz 
GPU: AMD ATI Radeon RX 580 2048SP
Memory: 7897MiB / 15982MiB
shell
cpu_cores="logical"
shell
cpu_cores="logical"

Hide/show temperature

FlagValue
--cpu_tempC, F, off
shell
Theme: Adwaita [GTK2/3]
Icons: Adwaita [GTK2/3]
CPU: Xeon E5-2640 v2 (16) @ 2.500GHz [38.0°C] 
GPU: AMD ATI Radeon RX 580 2048SP
Memory: 7897MiB / 15982MiB
shell
cpu_temp="off"
shell
cpu_temp="C"

GPU

Hide/show brand

FlagValue
--gpu_brandon, off
shell
Icons: Adwaita [GTK2/3]
CPU: Xeon E5-2640 v2 (16)
GPU: AMD ATI Radeon RX 580 2048SP
Memory: 7897MiB / 15982MiB
shell
gpu_brand="on"
shell
gpu_brand="off"

Which to display

FlagValue
--gpu_typeall, dedicated, integrated
shell
Icons: Adwaita [GTK2/3]
CPU: Xeon E5-2640 v2 (16)
GPU: AMD ATI Radeon RX 580 2048SP
GPU: Intel Integrated Graphics
Memory: 7897MiB / 15982MiB
shell
gpu_type="all"
shell
gpu_type="all"

Permission

Hide/Show refresh rate

FlagValue
--refresh_rateon, off
shell
Packages: 2208 (rpm), 35 (flatpak), 4 (snap)
Shell: zsh 5.9
Resolution: 1920x1080 @ 75.00Hz
DE: GNOME 46.1
WM: Mutter
shell
refresh_rate="off"
shell
refresh_rate="on"

Gtk themes / icons / fonts

Shorten output

FlagValue
--gtk_shorthandon, off
shell
WM: Mutter
WM Theme: Adwaita
Theme: Numix, Adwaita
Icons: Numix, Adwaita
Terminal: kgx
shell
gtk_shorthand="off"
shell
gtk_shorthand="off"

Hide/Show gtk2

FlagValue
--gtk2on, off
shell
WM: Mutter
WM Theme: Adwaita
Theme: Numix [GTK2], Adwaita [GTK3] 
Icons: Numix [GTK2], Adwaita [GTK3] 
Terminal: kgx
shell
gtk2="on"
shell
gtk2="on"

Hide/Show gtk3

FlagValue
--gtk3on, off
shell
WM: Mutter
WM Theme: Adwaita
Theme: Numix [GTK2], Adwaita [GTK3] 
Icons: Numix [GTK2], Adwaita [GTK3] 
Terminal: kgx
shell
gtk3="on"
shell
gtk3="on"

IP address

Website for checking IP address

FlagValue
--ip_hosturl
shell
public_ip_host="http://ident.me"
shell
public_ip_host="http://ident.me"

Public IP Timeout

FlagValue
--ip_timeoutint
shell
public_ip_timeout=2
shell
public_ip_timeout=1

###Disk

Which drives to display

FlagValue
--disk_show/, /dev/sdXX, /path/to/drive
shell
GPU Driver: amdgpu
CPU Usage: 23%
Disk (/): 105G / 162G (66%) 
Disk (games): 2.5G / 61G (5%) 
Font: Cantarell 11 [GTK2/3]
Local IP: 192.168.31.154
shell
disk_show=("/")
shell
disk_show=("/" "/run/media/fiersik/games")
Which tooltip to display.
FlagValue
--disk_subtitlemount, name, dir, none
shell
GPU Driver: amdgpu
CPU Usage: 23%
Disk (/dev/nvme0n1p3): 105G / 162G (66%) 
Disk (/dev/nvme0n1p4): 2.5G / 61G (5%) 
Font: Cantarell 11 [GTK2/3]
Local IP: 192.168.31.154
shell
disk_subtitle="mount"
shell
disk_subtitle="dir"

Hide/show usage percentage

FlagValue
--disk_percenton, off
shell
GPU Driver: amdgpu
CPU Usage: 23%
Disk (/): 105G / 162G (66%) 
Font: Cantarell 11 [GTK2/3]
Local IP: 192.168.31.154
shell
disk_percent="on"
shell
disk_percent="on"

Music

Music player

FlagValue
--music_playerauto, player-name
Music players.
amarokaudaciousbansheebluemindo
clementinecmusdeadbeefdeepin-music
dragonelisaguayadequegnome-music
gmusicbrowserexailegogglesmmio.elementary.music
yarockelisamuineiTunes
juklollypopmocpmopidy
mpdnetease-cloud-musicoliviaplayerctl
pogopraghaqmmpquodlibet
rhythmboxsayonarasmplayerspotify
strawberryauonmbtomahawkvlc
xmms2dxnoise
shell
music_player="auto"
shell
music_player="auto"

Information display format

FlagValue
--song_format%artist%, %album%, %title%
shell
Disk (/): 105G / 162G (66%)
Font: Cantarell 11 [GTK2/3]
Song: Liar_Sieru - Обман - Реальный мир
Music Player: vlc
Local IP: 192.168.31.154
shell
song_format="%artist% - %album% - %title%"
shell
song_format="%artist% - %album% - %title%"

Output on separate lines

FlagValue
--song_shorthandon, off
shell
Disk (/): 105G / 162G (66%)
Font: Cantarell 11 [GTK2/3]
Artist: Liar_Sieru
Album: Обман
Song: Реальный мир
Music Player: vlc
Local IP: 192.168.31.154
shell
song_shorthand="off"
shell
song_shorthand="off"

Text colors

FlagValue
--colorsdistro, num num num num num num
OrderOutput part
1Title
2Domain separator
3Underline
4Subtitle
5Separator
5Information
shell
colors=(distro)
shell
colors=(distro)

Text Options

Bold type

FlagValue
--boldon, off
shell
bold="on"
shell
bold="on"

Domain underscore

FlagValue
--underlineon, off
shell
fiersik@alt-gnome
----------------
OS: ALT Regular Sisyphus x86_64
Kernel: 6.8.7-6.8-alt1
ptime: 1 hour, 14 mins
shell
underline_enabled="on"
shell
underline_enabled="on"

Domain separator character

FlagValue
--underline_charstring
shell
fiersik@alt-gnome
=================
OS: ALT Regular Sisyphus x86_64
Kernel: 6.8.7-6.8-alt1
Uptime: 1 hour, 33 mins
shell
underline_char="-"
shell
underline_char="-"

Information separator character

FlagValue
--separatorstring
shell
fiersik@alt-gnome
----------------
OS= ALT Regular Sisyphus x86_64
Kernel= 6.8.7-6.8-alt1
Uptime= 1 hour, 33 mins
shell
separator=":"
shell
separator=" "

Color blocks

Color range

FlagValue
--block_rangenum, num
shell
block_range=(1 16)
shell
block_range=(1 18)

Custom Colors

Информация

This subblock is optional and is not included in the default configuration. It is necessary for conveniently setting your own colors for displaying information.

shell
magenta="\033[1;35m"
green="\033[1;32m"
white="\033[0;37m"
blue="\033[1;34m"
red="\033[1;31m"
black="\033[1;40;30m"
yellow="\033[1;33m"
cyan="\033[1;36m"
reset="\033[0m"
bgyellow="\033[1;43;33m"
bgwhite="\033[1;47;37m"
cl0="${reset}"
cl1="${magenta}"
cl2="${green}"
cl3="${white}"
cl4="${blue}"
cl5="${red}"
cl6="${yellow}"
cl7="${cyan}"
cl8="${black}"
cl9="${bgyellow}"
cl10="${bgwhite}"

Hide/Show Color Blocks

FlagValue
--color_blockson, off
shell
color_blocks="on"
shell
color_blocks="off"

Block width

FlagValue
--block_widthnum
shell
block_width=3
shell
block_width=0

Block height

FlagValue
--block_heightnum
shell
block_height=1
shell
block_height=0

Offset of blocks from the left side

FlagValue
--col_offsetauto, num
shell
col_offset="auto"
shell
col_offset="auto"

col_offset="auto"

Progress bars

Display information

FlagValue
--cpu_displaybar, infobar, barinfo, off
--memory_displaybar, infobar, barinfo, off
--battery_displaybar, infobar, barinfo, off
--disk_displaybar, infobar, barinfo, off
shell
CPU: Intel Xeon E5-2640 v2 (16) @ 2.500GHz
GPU: AMD ATI Radeon RX 580 2048SP
Memory: [-----------====] 
GPU Driver: amdgpu
CPU Usage: 10%
shell
cpu_display="off"
memory_display="off"
battery_display="off"
disk_display="off"
shell
cpu_display="off"
memory_display="off"
battery_display="off"
disk_display="off"

Bar char

FlagValue
--bar_charstring string
shell
CPU: Intel Xeon E5-2640 v2 (16) @ 2.500GHz
GPU: AMD ATI Radeon RX 580 2048SP
Memory: 12764MiB / 15982MiB [-----------====] 
GPU Driver: amdgpu
CPU Usage: 9%
shell
bar_char_elapsed="-"
bar_char_total="="
shell
bar_char_elapsed=""
bar_char_total=""

Hide/Show Progress Bar Borders

FlagValue
--bar_borderon, off
shell
CPU: Intel Xeon E5-2640 v2 (16) @ 2.500GHz
GPU: AMD ATI Radeon RX 580 2048SP
Memory: 12764MiB / 15982MiB [-----------====] 
GPU Driver: amdgpu
CPU Usage: 9%
shell
bar_border="on"
shell
bar_border="off"

Progress bar length

FlagValue
--bar_lengthnum
shell
CPU: Intel Xeon E5-2640 v2 (16) @ 2.500GHz
GPU: AMD ATI Radeon RX 580 2048SP
Memory: 12764MiB / 15982MiB [-------===] 
GPU Driver: amdgpu
CPU Usage: 9%
shell
bar_length=15
shell
bar_length=0

Progress Bar Colors

FlagValue
--bar_colorsdistro, num
shell
bar_color_elapsed="distro"
bar_color_total="distro"
shell
bar_color_elapsed="distro"
bar_color_total="distro"

Backend settings

Image Server

FlagValue
--backendbackend_name, off
Possible values
asciicaca
chafajp2a
iterm2pot
termpixpixterm
tycatw3m
kittyoff
shell
image_backend="ascii"
shell
image_backend="ascii"

Image Source

FlagValue
--sourceauto, ascii, wallpaper, /path/to/file, /path/to/dir/
shell
image_source="auto"
shell
image_source="auto"

ASCII options

Distribution

FlagValue
--ascii_distroauto, distro_name
Possible values
DefaultSmallRetro
AIXAlpine_smallArch_old
AnarchyArch_smallUbuntu_old
AndroidCRUX_smallRedhat_old
AntergosDebian_smallDragonfly_old
antiXGentoo_small
"AOSC OS"FreeBSD_small
"AOSC OS/Retro"Mac_small
ApricityNixOS_small
ArcoLinuxOpenBSD_small
ARCHlabsandroid_small
ArchStrikeAntrix_small
XFerienceCentOS_small
ArchMergeCleanjaro_small
ArtixElementaryOS_small
AryaGUIX_small
BedrockHyperbola_small
BitrigManjaro_small
BlackArchMXLinux_small
BLAGNetBSD_small
BlankOnParabola_small
BlueLightPOP_OS_small
bonsaiPureOS_small
BSDSlackware_small
BunsenLabsSunOS_small
CalculateLinuxLite_small
CarbsOpenSUSE_small
CentOSRaspbian_small
ChakrapostmarketOS_small
ChaletOSVoid_small
Chapeau
Chrom*
Cleanjaro
ClearOS
Clear_Linux
Clover
Condres
Container_Linux
CRUX
Cucumber
Debian
Deepin
DesaOS
Devuan
DracOS
DarkOs
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
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
openEuler
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
IRIX
shell
ascii_distro="auto"
shell
ascii_distro="ALT_GNOME"

ASCII Colors

FlagValue
--ascii_colorsnum num num num num num
shell
ascii_colors=(distro)
shell
ascii_colors=(distro)

Make ASCII logo bold

FlagValue
--ascii_boldon, off
shell
ascii_bold="on"
shell
ascii_bold="on"

Image Options

Redraw

Информация

If set to on, Neofetch will continually redraw the image as long as Ctrl + C is pressed. This resolves display issues in some terminal emulators.

FlagValue
--loopon, off
shell
image_loop="off"
shell
image_loop="off"

Catalog of miniatures

Value
dir
shell
thumbnail_dir="~/.cache/thumbnails/neofetch"
shell
thumbnail_dir="${XDG_CACHE_HOME:-${HOME}/.cache}/thumbnails/neofetch"

Crop Mode

FlagValue
--crop_modenormal, fit, fill
shell
crop_mode="normal"
shell
crop_mode="normal"

Offset

Внимание

Only affects normal mode.

FlagValue
--crop_offsetmode
Modes:
northwestnorthnortheast
westcentereast
southwestsouthsoutheast
shell
crop_offset="center"
shell
crop_offset="center"

Image Size

FlagsValue
--image_size, --sizeauto, 00px, 00%, none
shell
image_size="auto"
shell
image_size="auto"

Gap between image and text

FlagValue
--gapnum, -num
shell
gap=3
shell
gap=2

Image offset

Внимание

Works only with w3m.

FlagValue
--xoffset, --yoffsetnum
shell
yoffset=0
xoffset=0
shell
yoffset=0
xoffset=0

Background color

Внимание

Works only with w3m.

FlagValue
--bg_colorcolor
shell
background_color=" "
shell
background_color=" "

Other options

Standard output mode

Информация

Disables all colors. Useful for moving to another team.

Value
on, off
shell
stdout="off"
shell
stdout="off"

Published under the GPL-3.0+ license. The content is available under the CC BY-SA 4.0 license, unless otherwise specified.