A command-line system information tool written in bash 3.2+
3 | 4 |
5 | 
6 | 
7 | 
8 |
11 |
12 | Neofetch is a command-line system information tool written in `bash 3.2+`. Neofetch displays information about your operating system, software and hardware in an aesthetic and visually pleasing way.
13 |
14 | ### Note: @dylanaraps, the original maintainer, has archived neofetch, so I've forked it to allow for continued development.
15 |
16 | The overall purpose of Neofetch is to be used in screen-shots of your system. Neofetch shows the information other people want to see. There are other tools available for proper system statistic/diagnostics.
17 |
18 | The information by default is displayed alongside your operating system's logo. You can further configure Neofetch to instead use an image, a custom ASCII file, your wallpaper or nothing at all.
19 |
20 | 
21 |
22 | You can further configure Neofetch to display exactly what you want it to. Through the use of command-line flags and the configuration file you can change existing information outputs or add your own custom ones.
23 |
24 | Neofetch supports almost 150 different operating systems. From Linux to Windows, all the way to more obscure operating systems like Minix, AIX and Haiku. If your favourite operating system is unsupported: Open up an issue and support will be added.
25 |
26 |
27 | ### More: \[[Dependencies](https://github.com/dylanaraps/neofetch/wiki/Dependencies)\] \[[Installation](https://github.com/dylanaraps/neofetch/wiki/Installation)\] \[[Wiki](https://github.com/dylanaraps/neofetch/wiki)\]
28 |
--------------------------------------------------------------------------------
/CONTRIBUTING.md:
--------------------------------------------------------------------------------
1 | # How to Contribute
2 |
3 |
4 |
5 | * [Coding Conventions](#coding-conventions)
6 | * [ShellCheck](#shellcheck)
7 | * [No no's](#no-nos)
8 | * [If Statements](#if-statements)
9 | * [Case Statements](#case-statements)
10 | * [Making changes to Neofetch](#making-changes-to-neofetch)
11 | * [Adding support for a new Operating System / Distribution.](#adding-support-for-a-new-operating-system--distribution)
12 |
13 |
14 |
15 |
16 | ## Coding Conventions
17 |
18 | - Use `bash` built-ins wherever possible.
19 | - Try not to pipe (`|`) at all.
20 | - Limit usage of external commands `$(cmd)`.
21 | - Indent 4 spaces.
22 | - Use [snake_case](https://en.wikipedia.org/wiki/Snake_case) for function
23 | and variable names.
24 | - Keep lines below `100` characters long.
25 | - Use `[[ ]]` for tests.
26 | - Quote **EVERYTHING**.
27 |
28 | ### ShellCheck
29 |
30 | For your contribution to be accepted, your changes need to pass
31 | ShellCheck.
32 |
33 | ```sh
34 | shellcheck neofetch
35 | ```
36 |
37 | **Note**: If you have trouble installing ShellCheck. You can open a pull
38 | request on the repo and our Travis.ci hook will run ShellCheck for you.
39 |
40 |
41 | ### No no's
42 |
43 | - Don’t use GNU conventions in commands.
44 | - Use POSIX arguments and flags.
45 | - Don’t use `cut`.
46 | - Use `bash`'s built-in [parameter expansion](http://wiki.bash-hackers.org/syntax/pe).
47 | - Don’t use `echo`.
48 | - Use `printf "%s\n"`
49 | - Don’t use `bc`.
50 | - Don’t use `sed`.
51 | - Use `bash`'s built-in [parameter expansion](http://wiki.bash-hackers.org/syntax/pe).
52 | - Don’t use `cat`.
53 | - Use `bash`'s built-in syntax (`file="$(< /path/to/file.txt)")`).
54 | - Don’t use `grep "pattern" | awk '{ printf }'`.
55 | - Use `awk '/pattern/ { printf }'`
56 | - Don’t use `wc`.
57 | - Use `${#var}` or `${#arr[@]}`.
58 |
59 |
60 | ### If Statements
61 |
62 | If the test only has one command inside of it; use the compact test
63 | syntax. Otherwise the normal `if`/`fi` is just fine.
64 |
65 | ```sh
66 | # Bad
67 | if [[ "$var" ]]; then
68 | printf "%s\n" "$var"
69 | fi
70 |
71 | # Good
72 | [[ "$var" ]] && printf "%s\n" "$var"
73 |
74 | # Also good (Use this for longer lines).
75 | [[ "$var" ]] && \
76 | printf "%s\n" "$var"
77 | ```
78 |
79 |
80 | ### Case Statements
81 |
82 | Case statements need to be formatted in a specific way.
83 |
84 | ```sh
85 | # Good example (Notice the indentation).
86 | case "$var" in
87 | 1) printf "%s\n" 1 ;;
88 | 2)
89 | printf "%s\n" "1"
90 | printf "%s\n" "2"
91 | ;;
92 |
93 | *)
94 | printf "%s\n" "1"
95 | printf "%s\n" "2"
96 | printf "%s\n" "3"
97 | ;;
98 | esac
99 | ```
100 |
101 | ## Making changes to Neofetch
102 |
103 | ### Adding support for a new Operating System / Distribution.
104 |
105 | Adding support for a new OS/Distro requires adding the Name, Logo and
106 | Colors of the OS/Distro to the `get_distro_ascii()` function.
107 |
108 | The function is located right at the bottom of the script, one function
109 | above `main()`. Inside this function you’ll find an alphabetical list of
110 | each OS/Distro.
111 |
112 | Find the spot in the list your new OS/Distro fits into and start
113 | implementing your changes.
114 |
115 | If your OS/Distro requires changes to the actual information gathering
116 | functions then you can make these changes in the `get_*` functions.
117 |
118 | **Syntax**:
119 |
120 | - You have to escape back-slashes (`\`). (eg `\\`)
121 | - You can use `${c1}` to `${c6}`to color the ascii.
122 | - These are evaluated *after* we read the file.
123 |
124 |
125 | **Example**:
126 |
127 | ```sh
128 | "CRUX"*)
129 | set_colors 4 5 7 6
130 | read -rd '' ascii_data <<'EOF'
131 | ${c1} odddd
132 | oddxkkkxxdoo
133 | ddcoddxxxdoool
134 | xdclodod olol
135 | xoc xdd olol
136 | xdc ${c2}k00${c1}Okdlol
137 | xxd${c2}kOKKKOkd${c1}ldd
138 | xdco${c2}xOkdlo${c1}dldd
139 | ddc:cl${c2}lll${c1}oooodo
140 | odxxdd${c3}xkO000kx${c1}ooxdo
141 | oxdd${c3}x0NMMMMMMWW0od${c1}kkxo
142 | oooxd${c3}0WMMMMMMMMMW0o${c1}dxkx
143 | docldkXW${c3}MMMMMMMWWN${c1}Odolco
144 | xx${c2}dx${c1}kxxOKN${c3}WMMWN${c1}0xdoxo::c
145 | ${c2}xOkkO${c1}0oo${c3}odOW${c2}WW${c1}XkdodOxc:l
146 | ${c2}dkkkxkkk${c3}OKX${c2}NNNX0Oxx${c1}xc:cd
147 | ${c2} odxxdx${c3}xllod${c2}ddooxx${c1}dc:ldo
148 | ${c2} lodd${c1}dolccc${c2}ccox${c1}xoloo
149 | EOF
150 | ;;
151 | ```
152 |
--------------------------------------------------------------------------------
/neofetch.1:
--------------------------------------------------------------------------------
1 | .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.3.
2 | .TH NEOFETCH "1" "April 2021" "Neofetch 7.1.0" "User Commands"
3 | .SH NAME
4 | Neofetch \- A fast, highly customizable system info script
5 | .SH SYNOPSIS
6 | .B neofetch
7 | \fI\,func_name --option "value" --option "value"\/\fR
8 | .SH DESCRIPTION
9 | Neofetch is a CLI system information tool written in BASH. Neofetch
10 | displays information about your system next to an image, your OS logo,
11 | or any ASCII file of your choice.
12 | .PP
13 | NOTE: Every launch flag has a config option.
14 | .SH OPTIONS
15 | .SS "INFO:"
16 | .TP
17 | func_name
18 | Specify a function name (second part of info() from config) to
19 | quickly display only that function's information.
20 | .IP
21 | Example: neofetch uptime \fB\-\-uptime_shorthand\fR tiny
22 | .IP
23 | Example: neofetch uptime disk wm memory
24 | .IP
25 | This can be used in bars and scripts like so:
26 | .IP
27 | memory="$(neofetch memory)"; memory="${memory##*: }"
28 | .IP
29 | For multiple outputs at once (each line of info in an array):
30 | .IP
31 | IFS=$'\en' read \fB\-d\fR "" \fB\-ra\fR info < <(neofetch memory uptime wm)
32 | .IP
33 | info=("${info[@]##*: }")
34 | .TP
35 | \fB\-\-disable\fR infoname
36 | Allows you to disable an info line from appearing
37 | in the output. 'infoname' is the function name from the
38 | \&'print_info()' function inside the config file.
39 | For example: 'info "Memory" memory' would be '\-\-disable memory'
40 | .IP
41 | NOTE: You can supply multiple args. eg. 'neofetch \fB\-\-disable\fR cpu gpu'
42 | .TP
43 | \fB\-\-title_fqdn\fR on/off
44 | Hide/Show Fully Qualified Domain Name in title.
45 | .TP
46 | \fB\-\-package_managers\fR on/off
47 | Hide/Show Package Manager names . (on, tiny, off)
48 | .TP
49 | \fB\-\-os_arch\fR on/off
50 | Hide/Show OS architecture.
51 | .TP
52 | \fB\-\-speed_type\fR type
53 | Change the type of cpu speed to display.
54 | Possible values: current, min, max, bios,
55 | scaling_current, scaling_min, scaling_max
56 | .IP
57 | NOTE: This only supports Linux with cpufreq.
58 | .TP
59 | \fB\-\-speed_shorthand\fR on/off
60 | Whether or not to show decimals in CPU speed.
61 | .TP
62 | NOTE: This flag is not supported in systems with CPU speed less than
63 | 1 GHz.
64 | .TP
65 | \fB\-\-cpu_brand\fR on/off
66 | Enable/Disable CPU brand in output.
67 | .TP
68 | \fB\-\-cpu_cores\fR type
69 | Whether or not to display the number of CPU cores
70 | Possible values: logical, physical, off
71 | .IP
72 | NOTE: 'physical' doesn't work on BSD.
73 | .TP
74 | \fB\-\-cpu_speed\fR on/off
75 | Hide/Show cpu speed.
76 | .TP
77 | \fB\-\-cpu_temp\fR C/F/off
78 | Hide/Show cpu temperature.
79 | .IP
80 | NOTE: This only works on Linux and BSD.
81 | .TP
82 | NOTE: For FreeBSD and NetBSD\-based systems, you need to enable
83 | coretemp kernel module. This only supports newer Intel processors.
84 | .TP
85 | \fB\-\-distro_shorthand\fR on/off
86 | Shorten the output of distro (on, tiny, off)
87 | .IP
88 | NOTE: This option won't work in Windows (Cygwin)
89 | .TP
90 | \fB\-\-kernel_shorthand\fR on/off
91 | Shorten the output of kernel
92 | .IP
93 | NOTE: This option won't work in BSDs (except PacBSD and PC\-BSD)
94 | .TP
95 | \fB\-\-uptime_shorthand\fR on/off
96 | Shorten the output of uptime (on, tiny, off)
97 | .TP
98 | \fB\-\-refresh_rate\fR on/off
99 | Whether to display the refresh rate of each monitor
100 | Unsupported on Windows
101 | .TP
102 | \fB\-\-gpu_brand\fR on/off
103 | Enable/Disable GPU brand in output. (AMD/NVIDIA/Intel)
104 | .TP
105 | \fB\-\-gpu_type\fR type
106 | Which GPU to display. (all, dedicated, integrated)
107 | .IP
108 | NOTE: This only supports Linux.
109 | .TP
110 | \fB\-\-de_version\fR on/off
111 | Show/Hide Desktop Environment version
112 | .TP
113 | \fB\-\-gtk_shorthand\fR on/off
114 | Shorten output of gtk theme/icons
115 | .TP
116 | \fB\-\-gtk2\fR on/off
117 | Enable/Disable gtk2 theme/font/icons output
118 | .TP
119 | \fB\-\-gtk3\fR on/off
120 | Enable/Disable gtk3 theme/font/icons output
121 | .TP
122 | \fB\-\-shell_path\fR on/off
123 | Enable/Disable showing $SHELL path
124 | .TP
125 | \fB\-\-shell_version\fR on/off
126 | Enable/Disable showing $SHELL version
127 | .TP
128 | \fB\-\-disk_show\fR value
129 | Which disks to display.
130 | Possible values: '/', '/dev/sdXX', '/path/to/mount point'
131 | .IP
132 | NOTE: Multiple values can be given. (\fB\-\-disk_show\fR '/' '/dev/sdc1')
133 | .TP
134 | \fB\-\-disk_subtitle\fR type
135 | What information to append to the Disk subtitle.
136 | Takes: name, mount, dir, none
137 | .IP
138 | \&'name' shows the disk's name (sda1, sda2, etc)
139 | .IP
140 | \&'mount' shows the disk's mount point (/, \fI\,/mnt/Local\/\fP Disk, etc)
141 | .IP
142 | \&'dir' shows the basename of the disks's path. (/, Local Disk, etc)
143 | .IP
144 | \&'none' shows only 'Disk' or the configured title.
145 | .TP
146 | \fB\-\-disk_percent\fR on/off
147 | Hide/Show disk percent.
148 | .TP
149 | \fB\-\-ip_host\fR url
150 | URL to query for public IP
151 | .TP
152 | \fB\-\-ip_timeout\fR int
153 | Public IP timeout (in seconds).
154 | .TP
155 | \fB\-\-ip_interface\fR value
156 | Interface(s) to use for local IP
157 | .TP
158 | \fB\-\-song_format\fR format
159 | Print the song data in a specific format (see config file).
160 | .TP
161 | \fB\-\-song_shorthand\fR on/off
162 | Print the Artist/Album/Title on separate lines.
163 | .TP
164 | \fB\-\-memory_percent\fR on/off
165 | Display memory percentage.
166 | .TP
167 | \fB\-\-memory_unit\fR kib/mib/gib
168 | Memory output unit.
169 | .TP
170 | \fB\-\-music_player\fR player\-name
171 | Manually specify a player to use.
172 | Available values are listed in the config file
173 | .SS "TEXT FORMATTING:"
174 | .TP
175 | \fB\-\-colors\fR x x x x x x
176 | Changes the text colors in this order:
177 | title, @, underline, subtitle, colon, info
178 | .TP
179 | \fB\-\-underline\fR on/off
180 | Enable/Disable the underline.
181 | .TP
182 | \fB\-\-underline_char\fR char
183 | Character to use when underlining title
184 | .TP
185 | \fB\-\-bold\fR on/off
186 | Enable/Disable bold text
187 | .TP
188 | \fB\-\-separator\fR string
189 | Changes the default ':' separator to the specified string.
190 | .SS "COLOR BLOCKS:"
191 | .TP
192 | \fB\-\-color_blocks\fR on/off
193 | Enable/Disable the color blocks
194 | .TP
195 | \fB\-\-col_offset\fR auto/num
196 | Left\-padding of color blocks
197 | .TP
198 | \fB\-\-block_width\fR num
199 | Width of color blocks in spaces
200 | .TP
201 | \fB\-\-block_height\fR num
202 | Height of color blocks in lines
203 | .TP
204 | \fB\-\-block_range\fR num num
205 | Range of colors to print as blocks
206 | .SS "BARS:"
207 | .TP
208 | \fB\-\-bar_char\fR 'elapsed char' 'total char'
209 | Characters to use when drawing bars.
210 | .TP
211 | \fB\-\-bar_border\fR on/off
212 | Whether or not to surround the bar with '[]'
213 | .TP
214 | \fB\-\-bar_length\fR num
215 | Length in spaces to make the bars.
216 | .TP
217 | \fB\-\-bar_colors\fR num num
218 | Colors to make the bar.
219 | Set in this order: elapsed, total
220 | .TP
221 | \fB\-\-memory_display\fR mode
222 | Bar mode.
223 | Possible values: bar, infobar, barinfo, off
224 | .TP
225 | \fB\-\-battery_display\fR mode
226 | Bar mode.
227 | Possible values: bar, infobar, barinfo, off
228 | .TP
229 | \fB\-\-disk_display\fR mode
230 | Bar mode.
231 | Possible values: bar, infobar, barinfo, off
232 | .SS "IMAGE BACKEND:"
233 | .TP
234 | \fB\-\-backend\fR backend
235 | Which image backend to use.
236 | Possible values: 'ascii', 'caca', 'catimg', 'chafa', 'jp2a',
237 | \&'iterm2', 'off', 'sixel', 'tycat', 'w3m', 'kitty', 'viu'
238 | .TP
239 | \fB\-\-source\fR source
240 | Which image or ascii file to use.
241 | Possible values: 'auto', 'ascii', 'wallpaper', '/path/to/img',
242 | \&'/path/to/ascii', '/path/to/dir/', 'command output' [ascii]
243 | .TP
244 | \fB\-\-ascii\fR source
245 | Shortcut to use 'ascii' backend.
246 | .IP
247 | NEW: neofetch \fB\-\-ascii\fR "$(fortune | cowsay \fB\-W\fR 30)"
248 | .TP
249 | \fB\-\-caca\fR source
250 | Shortcut to use 'caca' backend.
251 | .TP
252 | \fB\-\-catimg\fR source
253 | Shortcut to use 'catimg' backend.
254 | .TP
255 | \fB\-\-chafa\fR source
256 | Shortcut to use 'chafa' backend.
257 | .TP
258 | \fB\-\-iterm2\fR source
259 | Shortcut to use 'iterm2' backend.
260 | .TP
261 | \fB\-\-jp2a\fR source
262 | Shortcut to use 'jp2a' backend.
263 | .TP
264 | \fB\-\-kitty\fR source
265 | Shortcut to use 'kitty' backend.
266 | .TP
267 | \fB\-\-pot\fR source
268 | Shortcut to use 'pot' backend.
269 | .TP
270 | \fB\-\-pixterm\fR source
271 | Shortcut to use 'pixterm' backend.
272 | .TP
273 | \fB\-\-sixel\fR source
274 | Shortcut to use 'sixel' backend.
275 | .TP
276 | \fB\-\-termpix\fR source
277 | Shortcut to use 'termpix' backend.
278 | .TP
279 | \fB\-\-tycat\fR source
280 | Shortcut to use 'tycat' backend.
281 | .TP
282 | \fB\-\-w3m\fR source
283 | Shortcut to use 'w3m' backend.
284 | .TP
285 | \fB\-\-ueberzug\fR source
286 | Shortcut to use 'ueberzug' backend
287 | .TP
288 | \fB\-\-viu\fR source
289 | Shortcut to use 'viu' backend
290 | .TP
291 | \fB\-\-off\fR
292 | Shortcut to use 'off' backend (Disable ascii art).
293 | .IP
294 | NOTE: 'source; can be any of the following: 'auto', 'ascii', 'wallpaper', '/path/to/img',
295 | \&'/path/to/ascii', '/path/to/dir/'
296 | .SS "ASCII:"
297 | .TP
298 | \fB\-\-ascii_colors\fR x x x x x x
299 | Colors to print the ascii art
300 | .TP
301 | \fB\-\-ascii_distro\fR distro
302 | Which Distro's ascii art to print
303 | .TP
304 | NOTE: AIX, Hash, Alpine, AlterLinux, Amazon, Anarchy, Android, instantOS,
305 | Antergos, antiX, "AOSC OS", "AOSC OS/Retro", Apricity, ArchCraft,
306 | ArcoLinux, ArchBox, ARCHlabs, ArchStrike, XFerience, ArchMerge, Arch,
307 | Artix, Arya, Bedrock, Bitrig, BlackArch, BLAG, BlankOn, BlueLight,
308 | bonsai, BSD, BunsenLabs, Calculate, Carbs, CentOS, Chakra, ChaletOS,
309 | Chapeau, Chrom*, Cleanjaro, ClearOS, Clear_Linux, Clover, Condres,
310 | Container_Linux, CRUX, Cucumber, dahlia, Debian, Deepin, DesaOS,
311 | Devuan, DracOS, DarkOs, Itc, DragonFly, Drauger, Elementary,
312 | EndeavourOS, Endless, EuroLinux, Exherbo, Fedora, Feren, FreeBSD,
313 | FreeMiNT, Frugalware, Funtoo, GalliumOS, Garuda, Gentoo, Pentoo,
314 | gNewSense, GNOME, GNU, GoboLinux, Grombyang, Guix, Haiku, Huayra, HydroOS,
315 | Hyperbola, janus, Kali, KaOS, KDE_neon, Kibojoe, Kogaion, Korora,
316 | KSLinux, Kubuntu, LEDE, LaxerOS, LibreELEC, LFS, Linux_Lite, LMDE,
317 | Lubuntu, Lunar, macos, Mageia, MagpieOS, Mandriva, Manjaro, TeArch, Maui,
318 | Mer, Minix, LinuxMint, Live_Raizo, MX_Linux, Namib, Neptune, NetBSD,
319 | Netrunner, Nitrux, NixOS, Nurunner, NuTyX, OBRevenge, OpenBSD,
320 | openEuler, OpenIndiana, openmamba, OpenMandriva, OpenStage, OpenWrt,
321 | osmc, Oracle, OS Elbrus, PacBSD, Parabola, Pardus, Parrot, Parsix,
322 | TrueOS, PCLinuxOS, Pengwin, Peppermint, Pisi, popos, Porteus, PostMarketOS,
323 | Proxmox, Puppy, PureOS, Qubes, Quibian, Radix, Raspbian, Reborn_OS,
324 | Redstar, Redcore, Redhat, Refracted_Devuan, Regata, Regolith, Rosa,
325 | sabotage, Sabayon, Sailfish, SalentOS, Scientific, Septor,
326 | SereneLinux, SharkLinux, Siduction, Slackware, SliTaz, SmartOS,
327 | Solus, Source_Mage, Sparky, Star, SteamOS, SunOS, openSUSE_Leap,
328 | t2, openSUSE_Tumbleweed, openSUSE, SwagArch, Tails, Trisquel,
329 | Ubuntu\-Cinnamon, Ubuntu\-Budgie, Ubuntu\-GNOME, Ubuntu\-MATE,
330 | Ubuntu\-Studio, Ubuntu, Univention, Venom, Void, VNux, semc, Obarun,
331 | windows10, Windows7, Xubuntu, Zorin, and IRIX have ascii logos.
332 | .IP
333 | NOTE: Arch, Ubuntu, Redhat, Fedora and Dragonfly have 'old' logo variants.
334 | .IP
335 | NOTE: Use '{distro name}_old' to use the old logos.
336 | .IP
337 | NOTE: Ubuntu has flavor variants.
338 | .TP
339 | NOTE: Change this to Lubuntu, Kubuntu, Xubuntu, Ubuntu\-GNOME,
340 | Ubuntu\-Studio, Ubuntu\-Mate or Ubuntu\-Budgie to use the flavors.
341 | .TP
342 | NOTE: Arcolinux, Dragonfly, Fedora, Alpine, Arch, Ubuntu,
343 | CRUX, Debian, Gentoo, FreeBSD, Mac, NixOS, OpenBSD, android,
344 | Artix, CentOS, Cleanjaro, ElementaryOS, GUIX, Hyperbola,
345 | Manjaro, MXLinux, NetBSD, Parabola, POP_OS, PureOS,
346 | Slackware, SunOS, LinuxLite, OpenSUSE, Raspbian,
347 | postmarketOS, and Void have a smaller logo variant.
348 | .IP
349 | NOTE: Use '{distro name}_small' to use the small variants.
350 | .TP
351 | \fB\-\-ascii_bold\fR on/off
352 | Whether or not to bold the ascii logo.
353 | .TP
354 | \fB\-L\fR, \fB\-\-logo\fR
355 | Hide the info text and only show the ascii logo.
356 | .SS "IMAGE:"
357 | .TP
358 | \fB\-\-loop\fR
359 | Redraw the image constantly until Ctrl+C is used. This fixes issues
360 | in some terminals emulators when using image mode.
361 | .TP
362 | \fB\-\-size\fR 00px | \fB\-\-size\fR 00%
363 | How to size the image.
364 | Possible values: auto, 00px, 00%, none
365 | .TP
366 | \fB\-\-catimg_size\fR 1/2
367 | Change the resolution of catimg.
368 | .TP
369 | \fB\-\-crop_mode\fR mode
370 | Which crop mode to use
371 | Takes the values: normal, fit, fill
372 | .TP
373 | \fB\-\-crop_offset\fR value
374 | Change the crop offset for normal mode.
375 | Possible values: northwest, north, northeast,
376 | west, center, east, southwest, south, southeast
377 | .TP
378 | \fB\-\-xoffset\fR px
379 | How close the image will be to the left edge of the
380 | window. This only works with w3m.
381 | .TP
382 | \fB\-\-yoffset\fR px
383 | How close the image will be to the top edge of the
384 | window. This only works with w3m.
385 | .TP
386 | \fB\-\-bg_color\fR color
387 | Background color to display behind transparent image.
388 | This only works with w3m.
389 | .TP
390 | \fB\-\-gap\fR num
391 | Gap between image and text.
392 | .TP
393 | NOTE: \fB\-\-gap\fR can take a negative value which will move the text
394 | closer to the left side.
395 | .TP
396 | \fB\-\-clean\fR
397 | Delete cached files and thumbnails.
398 | .SS "OTHER:"
399 | .TP
400 | \fB\-\-config\fR \fI\,/path/to/config\/\fP
401 | Specify a path to a custom config file
402 | .TP
403 | \fB\-\-config\fR none
404 | Launch the script without a config file
405 | .TP
406 | \fB\-\-no_config\fR
407 | Don't create the user config file.
408 | .TP
409 | \fB\-\-print_config\fR
410 | Print the default config file to stdout.
411 | .TP
412 | \fB\-\-stdout\fR
413 | Turn off all colors and disables any ASCII/image backend.
414 | .TP
415 | \fB\-\-help\fR
416 | Print this text and exit
417 | .TP
418 | \fB\-\-version\fR
419 | Show neofetch version
420 | .TP
421 | \fB\-v\fR
422 | Display error messages.
423 | .TP
424 | \fB\-vv\fR
425 | Display a verbose log for error reporting.
426 | .SS "DEVELOPER:"
427 | .TP
428 | \fB\-\-gen\-man\fR
429 | Generate a manpage for Neofetch in your PWD. (Requires GNU help2man)
430 | .SH "REPORTING BUGS"
431 | Report bugs to https://github.com/dylanaraps/neofetch/issues
432 |
--------------------------------------------------------------------------------