335 lines
8.4 KiB
Groff
335 lines
8.4 KiB
Groff
.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.47.6.
|
|
.TH NEOFETCH "1" "May 2018" "Neofetch 4.0.3" "User Commands"
|
|
.SH NAME
|
|
Neofetch \- A fast, highly customizable system info script
|
|
.SH SYNOPSIS
|
|
.B neofetch
|
|
\fI\,--option "value" --option "value"\/\fR
|
|
.SH 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.
|
|
.PP
|
|
NOTE: Every launch flag has a config option.
|
|
.SH OPTIONS
|
|
.SS "INFO:"
|
|
.TP
|
|
\fB\-\-disable\fR infoname
|
|
Allows you to disable an info line from appearing
|
|
in the output.
|
|
.IP
|
|
NOTE: You can supply multiple args. eg. 'neofetch \fB\-\-disable\fR cpu gpu'
|
|
.TP
|
|
\fB\-\-os_arch\fR on/off
|
|
Hide/Show OS architecture.
|
|
.TP
|
|
\fB\-\-speed_type\fR type
|
|
Change the type of cpu speed to display.
|
|
Possible values: current, min, max, bios,
|
|
scaling_current, scaling_min, scaling_max
|
|
.IP
|
|
NOTE: This only supports Linux with cpufreq.
|
|
.TP
|
|
\fB\-\-speed_shorthand\fR on/off
|
|
Whether or not to show decimals in CPU speed.
|
|
.TP
|
|
NOTE: This flag is not supported in systems with CPU speed less than
|
|
1 GHz.
|
|
.TP
|
|
\fB\-\-cpu_brand\fR on/off
|
|
Enable/Disable CPU brand in output.
|
|
.TP
|
|
\fB\-\-cpu_cores\fR type
|
|
Whether or not to display the number of CPU cores
|
|
Possible values: logical, physical, off
|
|
.IP
|
|
NOTE: 'physical' doesn't work on BSD.
|
|
.TP
|
|
\fB\-\-cpu_speed\fR on/off
|
|
Hide/Show cpu speed.
|
|
.TP
|
|
\fB\-\-cpu_temp\fR C/F/off
|
|
Hide/Show cpu temperature.
|
|
.IP
|
|
NOTE: This only works on Linux and BSD.
|
|
.TP
|
|
NOTE: For FreeBSD and NetBSD\-based systems, you need to enable
|
|
coretemp kernel module. This only supports newer Intel processors.
|
|
.TP
|
|
\fB\-\-distro_shorthand\fR on/off
|
|
Shorten the output of distro (tiny, on, off)
|
|
.IP
|
|
NOTE: This option won't work in Windows (Cygwin)
|
|
.TP
|
|
\fB\-\-kernel_shorthand\fR on/off
|
|
Shorten the output of kernel
|
|
.IP
|
|
NOTE: This option won't work in BSDs (except PacBSD and PC\-BSD)
|
|
.TP
|
|
\fB\-\-uptime_shorthand\fR on/off
|
|
Shorten the output of uptime (tiny, on, off)
|
|
.TP
|
|
\fB\-\-refresh_rate\fR on/off
|
|
Whether to display the refresh rate of each monitor
|
|
Unsupported on Windows
|
|
.TP
|
|
\fB\-\-gpu_brand\fR on/off
|
|
Enable/Disable GPU brand in output. (AMD/NVIDIA/Intel)
|
|
.TP
|
|
\fB\-\-gpu_type\fR type
|
|
Which GPU to display. (all, dedicated, integrated)
|
|
.IP
|
|
NOTE: This only supports Linux.
|
|
.TP
|
|
\fB\-\-gtk_shorthand\fR on/off
|
|
Shorten output of gtk theme/icons
|
|
.TP
|
|
\fB\-\-gtk2\fR on/off
|
|
Enable/Disable gtk2 theme/font/icons output
|
|
.TP
|
|
\fB\-\-gtk3\fR on/off
|
|
Enable/Disable gtk3 theme/font/icons output
|
|
.TP
|
|
\fB\-\-shell_path\fR on/off
|
|
Enable/Disable showing $SHELL path
|
|
.TP
|
|
\fB\-\-shell_version\fR on/off
|
|
Enable/Disable showing $SHELL version
|
|
.TP
|
|
\fB\-\-disk_show\fR value
|
|
Which disks to display.
|
|
Possible values: '/', '/dev/sdXX', '/path/to/mount point'
|
|
.IP
|
|
NOTE: Multiple values can be given. (\fB\-\-disk_show\fR '/' '/dev/sdc1')
|
|
.TP
|
|
\fB\-\-disk_subtitle\fR type
|
|
What information to append to the Disk subtitle.
|
|
Takes: name, mount, dir
|
|
.IP
|
|
\&'name' shows the disk's name (sda1, sda2, etc)
|
|
.IP
|
|
\&'mount' shows the disk's mount point (/, \fI\,/mnt/Local\/\fP Disk, etc)
|
|
.IP
|
|
\&'dir' shows the basename of the disks's path. (/, Local Disk, etc)
|
|
.TP
|
|
\fB\-\-ip_host\fR url
|
|
URL to query for public IP
|
|
.TP
|
|
\fB\-\-song_format\fR format
|
|
Print the song data in a specific format (see config file).
|
|
.TP
|
|
\fB\-\-song_shorthand\fR on/off
|
|
Print the Artist/Album/Title on separate lines.
|
|
.TP
|
|
\fB\-\-music_player\fR player\-name
|
|
Manually specify a player to use.
|
|
Available values are listed in the config file
|
|
.TP
|
|
\fB\-\-install_time\fR on/off
|
|
Enable/Disable showing the time in Install Date output.
|
|
.TP
|
|
\fB\-\-install_time_format\fR 12h/24h
|
|
Set time format in Install Date to be 12 hour or 24 hour.
|
|
.SS "TEXT FORMATTING:"
|
|
.TP
|
|
\fB\-\-colors\fR x x x x x x
|
|
Changes the text colors in this order:
|
|
title, @, underline, subtitle, colon, info
|
|
.TP
|
|
\fB\-\-underline\fR on/off
|
|
Enable/Disable the underline.
|
|
.TP
|
|
\fB\-\-underline_char\fR char
|
|
Character to use when underlining title
|
|
.TP
|
|
\fB\-\-bold\fR on/off
|
|
Enable/Disable bold text
|
|
.SS "COLOR BLOCKS:"
|
|
.TP
|
|
\fB\-\-color_blocks\fR on/off
|
|
Enable/Disable the color blocks
|
|
.TP
|
|
\fB\-\-block_width\fR num
|
|
Width of color blocks in spaces
|
|
.TP
|
|
\fB\-\-block_height\fR num
|
|
Height of color blocks in lines
|
|
.TP
|
|
\fB\-\-block_range\fR num num
|
|
Range of colors to print as blocks
|
|
.SS "BARS:"
|
|
.TP
|
|
\fB\-\-bar_char\fR 'elapsed char' 'total char'
|
|
Characters to use when drawing bars.
|
|
.TP
|
|
\fB\-\-bar_border\fR on/off
|
|
Whether or not to surround the bar with '[]'
|
|
.TP
|
|
\fB\-\-bar_length\fR num
|
|
Length in spaces to make the bars.
|
|
.TP
|
|
\fB\-\-bar_colors\fR num num
|
|
Colors to make the bar.
|
|
Set in this order: elapsed, total
|
|
.TP
|
|
\fB\-\-cpu_display\fR mode
|
|
Bar mode.
|
|
Possible values: bar, infobar, barinfo, off
|
|
.TP
|
|
\fB\-\-memory_display\fR mode
|
|
Bar mode.
|
|
Possible values: bar, infobar, barinfo, off
|
|
.TP
|
|
\fB\-\-battery_display\fR mode
|
|
Bar mode.
|
|
Possible values: bar, infobar, barinfo, off
|
|
.TP
|
|
\fB\-\-disk_display\fR mode
|
|
Bar mode.
|
|
Possible values: bar, infobar, barinfo, off
|
|
.SS "IMAGE BACKEND:"
|
|
.TP
|
|
\fB\-\-backend\fR backend
|
|
Which image backend to use.
|
|
Possible values: 'ascii', 'caca', 'jp2a', 'iterm2', 'off',
|
|
\&'sixel', 'tycat', 'w3m'
|
|
.TP
|
|
\fB\-\-source\fR source
|
|
Which image or ascii file to use.
|
|
Possible values: 'auto', 'ascii', 'wallpaper', '/path/to/img',
|
|
\&'/path/to/ascii', '/path/to/dir/'
|
|
.TP
|
|
\fB\-\-ascii\fR source
|
|
Shortcut to use 'ascii' backend.
|
|
.TP
|
|
\fB\-\-caca\fR source
|
|
Shortcut to use 'caca' backend.
|
|
.TP
|
|
\fB\-\-iterm2\fR source
|
|
Shortcut to use 'iterm2' backend.
|
|
.TP
|
|
\fB\-\-jp2a\fR source
|
|
Shortcut to use 'jp2a' backend.
|
|
.TP
|
|
\fB\-\-kitty\fR source
|
|
Shortcut to use 'kitty' backend.
|
|
.TP
|
|
\fB\-\-pixterm\fR source
|
|
Shortcut to use 'pixterm' backend.
|
|
.TP
|
|
\fB\-\-sixel\fR source
|
|
Shortcut to use 'sixel' backend.
|
|
.TP
|
|
\fB\-\-termpix\fR source
|
|
Shortcut to use 'termpix' backend.
|
|
.TP
|
|
\fB\-\-tycat\fR source
|
|
Shortcut to use 'tycat' backend.
|
|
.TP
|
|
\fB\-\-w3m\fR source
|
|
Shortcut to use 'w3m' backend.
|
|
.TP
|
|
\fB\-\-off\fR
|
|
Shortcut to use 'off' backend.
|
|
.IP
|
|
NOTE: 'source; can be any of the following: 'auto', 'ascii', 'wallpaper', '/path/to/img',
|
|
\&'/path/to/ascii', '/path/to/dir/'
|
|
.SS "ASCII:"
|
|
.TP
|
|
\fB\-\-ascii_colors\fR x x x x x x
|
|
Colors to print the ascii art
|
|
.TP
|
|
\fB\-\-ascii_distro\fR distro
|
|
Which Distro's ascii art to print
|
|
.IP
|
|
NOTE: Arch and Ubuntu have 'old' logo variants.
|
|
.IP
|
|
NOTE: Use 'arch_old' or 'ubuntu_old' to use the old logos.
|
|
.IP
|
|
NOTE: Ubuntu has flavor variants.
|
|
.TP
|
|
NOTE: Change this to 'Lubuntu', 'Xubuntu', 'Ubuntu\-GNOME',
|
|
\&'Ubuntu\-Studio' or 'Ubuntu\-Budgie' to use the flavors.
|
|
.TP
|
|
NOTE: Alpine, Arch, CRUX, Debian, Gentoo, FreeBSD, Mac, NixOS,
|
|
OpenBSD, and Void have a smaller logo variant.
|
|
.IP
|
|
NOTE: Use '{distro name}_small' to use the small variants.
|
|
.TP
|
|
\fB\-\-ascii_bold\fR on/off
|
|
Whether or not to bold the ascii logo.
|
|
.TP
|
|
\fB\-L\fR, \fB\-\-logo\fR
|
|
Hide the info text and only show the ascii logo.
|
|
.IP
|
|
Possible values: bar, infobar, barinfo, off
|
|
.SS "IMAGE:"
|
|
.TP
|
|
\fB\-\-loop\fR
|
|
Redraw the image constantly until Ctrl+C is used. This fixes issues
|
|
in some terminals emulators when using image mode.
|
|
.TP
|
|
\fB\-\-size\fR 00px | \fB\-\-size\fR 00%
|
|
How to size the image.
|
|
Possible values: auto, 00px, 00%, none
|
|
.TP
|
|
\fB\-\-crop_mode\fR mode
|
|
Which crop mode to use
|
|
Takes the values: normal, fit, fill
|
|
.TP
|
|
\fB\-\-crop_offset\fR value
|
|
Change the crop offset for normal mode.
|
|
Possible values: northwest, north, northeast,
|
|
west, center, east, southwest, south, southeast
|
|
.TP
|
|
\fB\-\-xoffset\fR px
|
|
How close the image will be to the left edge of the
|
|
window. This only works with w3m.
|
|
.TP
|
|
\fB\-\-yoffset\fR px
|
|
How close the image will be to the top edge of the
|
|
window. This only works with w3m.
|
|
.TP
|
|
\fB\-\-bg_color\fR color
|
|
Background color to display behind transparent image.
|
|
This only works with w3m.
|
|
.TP
|
|
\fB\-\-gap\fR num
|
|
Gap between image and text.
|
|
.TP
|
|
NOTE: \fB\-\-gap\fR can take a negative value which will move the text
|
|
closer to the left side.
|
|
.TP
|
|
\fB\-\-clean\fR
|
|
Delete cached files and thumbnails.
|
|
.SS "OTHER:"
|
|
.TP
|
|
\fB\-\-config\fR \fI\,/path/to/config\/\fP
|
|
Specify a path to a custom config file
|
|
.TP
|
|
\fB\-\-config\fR none
|
|
Launch the script without a config file
|
|
.TP
|
|
\fB\-\-print_config\fR
|
|
Print the default config file to stdout.
|
|
.TP
|
|
\fB\-\-stdout\fR
|
|
Turn off all colors and disables any ASCII/image backend.
|
|
.TP
|
|
\fB\-\-help\fR
|
|
Print this text and exit
|
|
.TP
|
|
\fB\-\-version\fR
|
|
Show neofetch version
|
|
.TP
|
|
\fB\-v\fR
|
|
Display error messages.
|
|
.TP
|
|
\fB\-vv\fR
|
|
Display a verbose log for error reporting.
|
|
.SS "DEVELOPER:"
|
|
.TP
|
|
\fB\-\-gen\-man\fR
|
|
Generate a manpage for Neofetch in your PWD. (Requires GNU help2man)
|
|
.SH "REPORTING BUGS"
|
|
Report bugs to https://github.com/dylanaraps/neofetch/issues
|