1NEOFETCH(1) User Commands NEOFETCH(1)
2
6 Neofetch - A fast, highly customizable system info script
7
9 neofetch func_name --option "value" --option "value"
10
12 Neofetch is a CLI system information tool written in BASH. Neofetch
13 displays information about your system next to an image, your OS logo,
14 or any ASCII file of your choice.
15 NOTE: Every launch flag has a config option.
17
19 INFO:
20 func_name
21 Specify a function name (second part of info() from config) to
22 quickly display only that function's information.
23 Example: neofetch uptime --uptime_shorthand tiny
25 Example: neofetch uptime disk wm memory
27 This can be used in bars and scripts like so:
29 memory="$(neofetch memory)"; memory="${memory##*: }"
31 For multiple outputs at once (each line of info in an array):
33 IFS=$'\n' read -d "" -ra info < <(neofetch memory uptime wm)
35 info=("${info[@]##*: }")
37 --disable infoname
39 Allows you to disable an info line from appearing in the output.
40 'infoname' is the function name from the 'print_info()' function
41 inside the config file. For example: 'info "Memory" memory'
42 would be '--disable memory'
43 NOTE: You can supply multiple args. eg. 'neofetch --disable cpu
45 gpu'
46 --package_managers on/off
48 Hide/Show Package Manager names . (on, tiny, off)
49 --os_arch on/off
51 Hide/Show OS architecture.
52 --speed_type type
54 Change the type of cpu speed to display. Possible values: cur‐
55 rent, min, max, bios, scaling_current, scaling_min, scaling_max
56 NOTE: This only supports Linux with cpufreq.
58 --speed_shorthand on/off
60 Whether or not to show decimals in CPU speed.
61 NOTE: This flag is not supported in systems with CPU speed less than
63 1 GHz.
64 --cpu_brand on/off
66 Enable/Disable CPU brand in output.
67 --cpu_cores type
69 Whether or not to display the number of CPU cores Possible val‐
70 ues: logical, physical, off
71 NOTE: 'physical' doesn't work on BSD.
73 --cpu_speed on/off
75 Hide/Show cpu speed.
76 --cpu_temp C/F/off
78 Hide/Show cpu temperature.
79 NOTE: This only works on Linux and BSD.
81 NOTE: For FreeBSD and NetBSD-based systems, you need to enable
83 coretemp kernel module. This only supports newer Intel proces‐
84 sors.
85 --distro_shorthand on/off
87 Shorten the output of distro (on, tiny, off)
88 NOTE: This option won't work in Windows (Cygwin)
90 --kernel_shorthand on/off
92 Shorten the output of kernel
93 NOTE: This option won't work in BSDs (except PacBSD and PC-BSD)
95 --uptime_shorthand on/off
97 Shorten the output of uptime (on, tiny, off)
98 --refresh_rate on/off
100 Whether to display the refresh rate of each monitor Unsupported
101 on Windows
102 --gpu_brand on/off
104 Enable/Disable GPU brand in output. (AMD/NVIDIA/Intel)
105 --gpu_type type
107 Which GPU to display. (all, dedicated, integrated)
108 NOTE: This only supports Linux.
110 --de_version on/off
112 Show/Hide Desktop Environment version
113 --gtk_shorthand on/off
115 Shorten output of gtk theme/icons
116 --gtk2 on/off
118 Enable/Disable gtk2 theme/font/icons output
119 --gtk3 on/off
121 Enable/Disable gtk3 theme/font/icons output
122 --shell_path on/off
124 Enable/Disable showing $SHELL path
125 --shell_version on/off
127 Enable/Disable showing $SHELL version
128 --disk_show value
130 Which disks to display. Possible values: '/', '/dev/sdXX',
131 '/path/to/mount point'
132 NOTE: Multiple values can be given. (--disk_show '/'
134 '/dev/sdc1')
135 --disk_subtitle type
137 What information to append to the Disk subtitle. Takes: name,
138 mount, dir, none
139 'name' shows the disk's name (sda1, sda2, etc)
141 'mount' shows the disk's mount point (/, /mnt/Local Disk, etc)
143 'dir' shows the basename of the disks's path. (/, Local Disk,
145 etc)
146 'none' shows only 'Disk' or the configured title.
148 --disk_percent on/off
150 Hide/Show disk percent.
151 --ip_host url
153 URL to query for public IP
154 --ip_timeout int
156 Public IP timeout (in seconds).
157 --song_format format
159 Print the song data in a specific format (see config file).
160 --song_shorthand on/off
162 Print the Artist/Album/Title on separate lines.
163 --memory_percent on/off
165 Display memory percentage.
166 --music_player player-name
168 Manually specify a player to use. Available values are listed
169 in the config file
170 TEXT FORMATTING:
172 --colors x x x x x x
173 Changes the text colors in this order: title, @, underline, sub‐
174 title, colon, info
175 --underline on/off
177 Enable/Disable the underline.
178 --underline_char char
180 Character to use when underlining title
181 --bold on/off
183 Enable/Disable bold text
184 --separator string
186 Changes the default ':' separator to the specified string.
187 COLOR BLOCKS:
189 --color_blocks on/off
190 Enable/Disable the color blocks
191 --col_offset auto/num
193 Left-padding of color blocks
194 --block_width num
196 Width of color blocks in spaces
197 --block_height num
199 Height of color blocks in lines
200 --block_range num num
202 Range of colors to print as blocks
203 BARS:
205 --bar_char 'elapsed char' 'total char'
206 Characters to use when drawing bars.
207 --bar_border on/off
209 Whether or not to surround the bar with '[]'
210 --bar_length num
212 Length in spaces to make the bars.
213 --bar_colors num num
215 Colors to make the bar. Set in this order: elapsed, total
216 --cpu_display mode
218 Bar mode. Possible values: bar, infobar, barinfo, off
219 --memory_display mode
221 Bar mode. Possible values: bar, infobar, barinfo, off
222 --battery_display mode
224 Bar mode. Possible values: bar, infobar, barinfo, off
225 --disk_display mode
227 Bar mode. Possible values: bar, infobar, barinfo, off
228 IMAGE BACKEND:
230 --backend backend
231 Which image backend to use. Possible values: 'ascii', 'caca',
232 'chafa', 'jp2a', 'iterm2', 'off', 'sixel', 'tycat', 'w3m',
233 'kitty'
234 --source source
236 Which image or ascii file to use. Possible values: 'auto',
237 'ascii', 'wallpaper', '/path/to/img', '/path/to/ascii',
238 '/path/to/dir/', 'command output' [ascii]
239 --ascii source
241 Shortcut to use 'ascii' backend.
242 NEW: neofetch --ascii "$(fortune | cowsay -W 30)"
244 --caca source
246 Shortcut to use 'caca' backend.
247 --chafa source
249 Shortcut to use 'chafa' backend.
250 --iterm2 source
252 Shortcut to use 'iterm2' backend.
253 --jp2a source
255 Shortcut to use 'jp2a' backend.
256 --kitty source
258 Shortcut to use 'kitty' backend.
259 --pixterm source
261 Shortcut to use 'pixterm' backend.
262 --sixel source
264 Shortcut to use 'sixel' backend.
265 --termpix source
267 Shortcut to use 'termpix' backend.
268 --tycat source
270 Shortcut to use 'tycat' backend.
271 --w3m source
273 Shortcut to use 'w3m' backend.
274 --off Shortcut to use 'off' backend (Disable ascii art).
276 NOTE: 'source; can be any of the following: 'auto', 'ascii',
278 'wallpaper', '/path/to/img', '/path/to/ascii', '/path/to/dir/'
279 ASCII:
281 --ascii_colors x x x x x x
282 Colors to print the ascii art
283 --ascii_distro distro
285 Which Distro's ascii art to print
286 NOTE: AIX, Alpine, Anarchy, Android, Antergos, antiX, AOSC,
288 Apricity, ArcoLinux, ArchBox, ARCHlabs, ArchStrike, XFerience,
289 ArchMerge, Arch, Artix, Arya, Bedrock, Bitrig, BlackArch, BLAG,
290 BlankOn, BlueLight, bonsai, BSD, BunsenLabs, Calculate, Carbs,
291 CentOS, Chakra, ChaletOS, Chapeau, Chrom, Cleanjaro, ClearOS,
292 Clear_Linux, Clover, Condres, Container_Linux, CRUX, Cucumber,
293 Debian, Deepin, DesaOS, Devuan, DracOS, DragonFly, Drauger, Ele‐
294 mentary, EndeavourOS, Endless, EuroLinux, Exherbo, Fedora,
295 Feren, FreeBSD, FreeMiNT, Frugalware, Funtoo, GalliumOS, Gentoo,
296 Pentoo, gNewSense, GNU, GoboLinux, Grombyang, Guix, Haiku,
297 Huayra, Hyperbola, janus, Kali, KaOS, KDE_neon, Kibojoe,
298 Kogaion, Korora, KSLinux, Kubuntu, LEDE, LFS, Linux_Lite, LMDE,
299 Lubuntu, Lunar, macos, Mageia, MagpieOS, Mandriva, Manjaro,
300 Maui, Mer, Minix, LinuxMint, MX_Linux, Namib, Neptune, NetBSD,
301 Netrunner, Nitrux, NixOS, Nurunner, NuTyX, OBRevenge, OpenBSD,
302 OpenIndiana, OpenMandriva, OpenWrt, osmc, Oracle, PacBSD, Para‐
303 bola, Pardus, Parrot, Parsix, TrueOS, PCLinuxOS, Peppermint,
304 popos, Porteus, PostMarketOS, Proxmox, Puppy, PureOS, Qubes,
305 Radix, Raspbian, Reborn_OS, Redstar, Redcore, Redhat,
306 Refracted_Devuan, Regata, Rosa, sabotage, Sabayon, Sailfish,
307 SalentOS, Scientific, Septor, SharkLinux, Siduction, Slackware,
308 SliTaz, SmartOS, Solus, Source_Mage, Sparky, Star, SteamOS,
309 SunOS, openSUSE_Leap, openSUSE_Tumbleweed, openSUSE, SwagArch,
310 Tails, Trisquel, Ubuntu-Budgie, Ubuntu-GNOME, Ubuntu-MATE,
311 Ubuntu-Studio, Ubuntu, Void, Obarun, windows10, Windows7,
312 Xubuntu, Zorin, and IRIX have ascii logos
313 NOTE: Arch, Ubuntu, Redhat, and Dragonfly have 'old' logo vari‐
315 ants.
316 NOTE: Use '{distro name}_old' to use the old logos.
318 NOTE: Ubuntu has flavor variants.
320 NOTE: Change this to Lubuntu, Kubuntu, Xubuntu, Ubuntu-GNOME,
322 Ubuntu-Studio, Ubuntu-Mate or Ubuntu-Budgie to use the flavors.
323 NOTE: Arcolinux, Dragonfly, Fedora, Alpine, Arch, Ubuntu,
325 CRUX, Debian, Gentoo, FreeBSD, Mac, NixOS, OpenBSD, android,
326 Antrix, CentOS, Cleanjaro, ElementaryOS, GUIX, Hyperbola, Man‐
327 jaro, MXLinux, NetBSD, Parabola, POP_OS, PureOS, Slackware,
328 SunOS, LinuxLite, OpenSUSE, Raspbian, postmarketOS, and Void
329 have a smaller logo variant.
330 NOTE: Use '{distro name}_small' to use the small variants.
332 --ascii_bold on/off
334 Whether or not to bold the ascii logo.
335 -L, --logo
337 Hide the info text and only show the ascii logo.
338 IMAGE:
340 --loop Redraw the image constantly until Ctrl+C is used. This fixes
341 issues in some terminals emulators when using image mode.
342 --size 00px | --size 00%
344 How to size the image. Possible values: auto, 00px, 00%, none
345 --crop_mode mode
347 Which crop mode to use Takes the values: normal, fit, fill
348 --crop_offset value
350 Change the crop offset for normal mode. Possible values: north‐
351 west, north, northeast, west, center, east, southwest, south,
352 southeast
353 --xoffset px
355 How close the image will be to the left edge of the window. This
356 only works with w3m.
357 --yoffset px
359 How close the image will be to the top edge of the window. This
360 only works with w3m.
361 --bg_color color
363 Background color to display behind transparent image. This only
364 works with w3m.
365 --gap num
367 Gap between image and text.
368 NOTE: --gap can take a negative value which will move the text
370 closer to the left side.
371 --clean
373 Delete cached files and thumbnails.
374 OTHER:
376 --config /path/to/config
377 Specify a path to a custom config file
378 --config none
380 Launch the script without a config file
381 --no_config
383 Don't create the user config file.
384 --print_config
386 Print the default config file to stdout.
387 --stdout
389 Turn off all colors and disables any ASCII/image backend.
390 --help Print this text and exit
392 --version
394 Show neofetch version
395 -v Display error messages.
397 -vv Display a verbose log for error reporting.
399 DEVELOPER:
401 --gen-man
402 Generate a manpage for Neofetch in your PWD. (Requires GNU
403 help2man)
404
406 Report bugs to https://github.com/dylanaraps/neofetch/issues
407Neofetch 7.0.0 January 2020 NEOFETCH(1)