1NEOFETCH(1) User Commands NEOFETCH(1)
2
6 Neofetch - A fast, highly customizable system info script
7
9 neofetch --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 --disable infoname
21 Allows you to disable an info line from appearing in the output.
22 'infoname' is the function name from the 'print_info()' function
23 inside the config file. For example: 'info "Memory" memory'
24 would be '--disable memory'
25 NOTE: You can supply multiple args. eg. 'neofetch --disable cpu
27 gpu'
28 --package_managers on/off
30 Hide/Show Package Manager names . (tiny, on, off)
31 --os_arch on/off
33 Hide/Show OS architecture.
34 --speed_type type
36 Change the type of cpu speed to display. Possible values: cur‐
37 rent, min, max, bios, scaling_current, scaling_min, scaling_max
38 NOTE: This only supports Linux with cpufreq.
40 --speed_shorthand on/off
42 Whether or not to show decimals in CPU speed.
43 NOTE: This flag is not supported in systems with CPU speed less than
45 1 GHz.
46 --cpu_brand on/off
48 Enable/Disable CPU brand in output.
49 --cpu_cores type
51 Whether or not to display the number of CPU cores Possible val‐
52 ues: logical, physical, off
53 NOTE: 'physical' doesn't work on BSD.
55 --cpu_speed on/off
57 Hide/Show cpu speed.
58 --cpu_temp C/F/off
60 Hide/Show cpu temperature.
61 NOTE: This only works on Linux and BSD.
63 NOTE: For FreeBSD and NetBSD-based systems, you need to enable
65 coretemp kernel module. This only supports newer Intel proces‐
66 sors.
67 --distro_shorthand on/off
69 Shorten the output of distro (tiny, on, off)
70 NOTE: This option won't work in Windows (Cygwin)
72 --kernel_shorthand on/off
74 Shorten the output of kernel
75 NOTE: This option won't work in BSDs (except PacBSD and PC-BSD)
77 --uptime_shorthand on/off
79 Shorten the output of uptime (tiny, on, off)
80 --refresh_rate on/off
82 Whether to display the refresh rate of each monitor Unsupported
83 on Windows
84 --gpu_brand on/off
86 Enable/Disable GPU brand in output. (AMD/NVIDIA/Intel)
87 --gpu_type type
89 Which GPU to display. (all, dedicated, integrated)
90 NOTE: This only supports Linux.
92 --gtk_shorthand on/off
94 Shorten output of gtk theme/icons
95 --gtk2 on/off
97 Enable/Disable gtk2 theme/font/icons output
98 --gtk3 on/off
100 Enable/Disable gtk3 theme/font/icons output
101 --shell_path on/off
103 Enable/Disable showing $SHELL path
104 --shell_version on/off
106 Enable/Disable showing $SHELL version
107 --disk_show value
109 Which disks to display. Possible values: '/', '/dev/sdXX',
110 '/path/to/mount point'
111 NOTE: Multiple values can be given. (--disk_show '/'
113 '/dev/sdc1')
114 --disk_subtitle type
116 What information to append to the Disk subtitle. Takes: name,
117 mount, dir
118 'name' shows the disk's name (sda1, sda2, etc)
120 'mount' shows the disk's mount point (/, /mnt/Local Disk, etc)
122 'dir' shows the basename of the disks's path. (/, Local Disk,
124 etc)
125 --ip_host url
127 URL to query for public IP
128 --song_format format
130 Print the song data in a specific format (see config file).
131 --song_shorthand on/off
133 Print the Artist/Album/Title on separate lines.
134 --music_player player-name
136 Manually specify a player to use. Available values are listed
137 in the config file
138 TEXT FORMATTING:
140 --colors x x x x x x
141 Changes the text colors in this order: title, @, underline, sub‐
142 title, colon, info
143 --underline on/off
145 Enable/Disable the underline.
146 --underline_char char
148 Character to use when underlining title
149 --bold on/off
151 Enable/Disable bold text
152 COLOR BLOCKS:
154 --color_blocks on/off
155 Enable/Disable the color blocks
156 --block_width num
158 Width of color blocks in spaces
159 --block_height num
161 Height of color blocks in lines
162 --block_range num num
164 Range of colors to print as blocks
165 BARS:
167 --bar_char 'elapsed char' 'total char'
168 Characters to use when drawing bars.
169 --bar_border on/off
171 Whether or not to surround the bar with '[]'
172 --bar_length num
174 Length in spaces to make the bars.
175 --bar_colors num num
177 Colors to make the bar. Set in this order: elapsed, total
178 --cpu_display mode
180 Bar mode. Possible values: bar, infobar, barinfo, off
181 --memory_display mode
183 Bar mode. Possible values: bar, infobar, barinfo, off
184 --battery_display mode
186 Bar mode. Possible values: bar, infobar, barinfo, off
187 --disk_display mode
189 Bar mode. Possible values: bar, infobar, barinfo, off
190 IMAGE BACKEND:
192 --backend backend
193 Which image backend to use. Possible values: 'ascii', 'caca',
194 'jp2a', 'iterm2', 'off', 'sixel', 'tycat', 'w3m'
195 --source source
197 Which image or ascii file to use. Possible values: 'auto',
198 'ascii', 'wallpaper', '/path/to/img', '/path/to/ascii',
199 '/path/to/dir/'
200 --ascii source
202 Shortcut to use 'ascii' backend.
203 --caca source
205 Shortcut to use 'caca' backend.
206 --iterm2 source
208 Shortcut to use 'iterm2' backend.
209 --jp2a source
211 Shortcut to use 'jp2a' backend.
212 --kitty source
214 Shortcut to use 'kitty' backend.
215 --pixterm source
217 Shortcut to use 'pixterm' backend.
218 --sixel source
220 Shortcut to use 'sixel' backend.
221 --termpix source
223 Shortcut to use 'termpix' backend.
224 --tycat source
226 Shortcut to use 'tycat' backend.
227 --w3m source
229 Shortcut to use 'w3m' backend.
230 --off Shortcut to use 'off' backend (Disable ascii art).
232 NOTE: 'source; can be any of the following: 'auto', 'ascii',
234 'wallpaper', '/path/to/img', '/path/to/ascii', '/path/to/dir/'
235 ASCII:
237 --ascii_colors x x x x x x
238 Colors to print the ascii art
239 --ascii_distro distro
241 Which Distro's ascii art to print
242 NOTE: Arch and Ubuntu have 'old' logo variants.
244 NOTE: Use 'arch_old' or 'ubuntu_old' to use the old logos.
246 NOTE: Ubuntu has flavor variants.
248 NOTE: Change this to 'Lubuntu', 'Xubuntu', 'Ubuntu-GNOME',
250 'Ubuntu-Studio' or 'Ubuntu-Budgie' to use the flavors.
251 NOTE: Alpine, Arch, CRUX, Debian, Gentoo, FreeBSD, Mac, NixOS,
253 OpenBSD, and Void have a smaller logo variant.
254 NOTE: Use '{distro name}_small' to use the small variants.
256 --ascii_bold on/off
258 Whether or not to bold the ascii logo.
259 -L, --logo
261 Hide the info text and only show the ascii logo.
262 IMAGE:
264 --loop Redraw the image constantly until Ctrl+C is used. This fixes
265 issues in some terminals emulators when using image mode.
266 --size 00px | --size 00%
268 How to size the image. Possible values: auto, 00px, 00%, none
269 --crop_mode mode
271 Which crop mode to use Takes the values: normal, fit, fill
272 --crop_offset value
274 Change the crop offset for normal mode. Possible values: north‐
275 west, north, northeast, west, center, east, southwest, south,
276 southeast
277 --xoffset px
279 How close the image will be to the left edge of the window. This
280 only works with w3m.
281 --yoffset px
283 How close the image will be to the top edge of the window. This
284 only works with w3m.
285 --bg_color color
287 Background color to display behind transparent image. This only
288 works with w3m.
289 --gap num
291 Gap between image and text.
292 NOTE: --gap can take a negative value which will move the text
294 closer to the left side.
295 --clean
297 Delete cached files and thumbnails.
298 OTHER:
300 --config /path/to/config
301 Specify a path to a custom config file
302 --config none
304 Launch the script without a config file
305 --print_config
307 Print the default config file to stdout.
308 --stdout
310 Turn off all colors and disables any ASCII/image backend.
311 --help Print this text and exit
313 --version
315 Show neofetch version
316 -v Display error messages.
318 -vv Display a verbose log for error reporting.
320 DEVELOPER:
322 --gen-man
323 Generate a manpage for Neofetch in your PWD. (Requires GNU
324 help2man)
325
327 Report bugs to https://github.com/dylanaraps/neofetch/issues
328Neofetch 5.0.0 June 2018 NEOFETCH(1)