hyfetch/neofetch.1

308 lines
7.1 KiB
Groff
Raw Normal View History

2016-11-10 17:15:05 -07:00
.TH NEOFETCH "1" "November 2016" "2.0" "User Commands"
2016-03-04 06:59:56 -07:00
.SH NAME
neofetch \- simple system information script
.SH SYNOPSIS
.B neofetch \fR[Optional Flags]
2016-03-04 06:59:56 -07:00
.SH DESCRIPTION
neofetch is a script that gathers information about your system and prints
2016-03-04 06:59:56 -07:00
it to the terminal next to an image, a distro's logo or any ASCII art of
your choice.
.SH OPTIONS
.TP
.B \--disable 'infoname'
2016-03-04 06:59:56 -07:00
Allows you to disable an info line from appearing in the output.
.br
NOTE: You can supply multiple args. eg.
.br
\'neofetch --disable cpu gpu disk shell\'
2016-11-25 00:34:01 -07:00
.br
NOTE: The arguments must all be lowercase.
2016-03-04 06:59:56 -07:00
.TP
.B \--os_arch 'on/off'
Hide/Show OS architecture.
2016-03-04 06:59:56 -07:00
.TP
.B \--speed_type 'type'
2016-03-04 06:59:56 -07:00
Change the type of cpu speed to display.
.br
Possible values: current, min, max, bios,
scaling_current, scaling_min, scaling_max
.br
NOTE: This only support Linux with cpufreq.
.TP
.B \--cpu_shorthand 'type'
Shorten the output of CPU
.br
Possible values: name, speed, tiny, on, off
.TP
2016-10-20 23:38:02 -06:00
.B \--cpu_cores 'logical/physical/off'
2016-03-15 01:55:35 -06:00
Whether or not to display the number of CPU cores
2016-10-20 23:54:05 -06:00
.br
2016-10-21 03:29:16 -06:00
Note: 'physical' doesn't work on BSD.
2016-03-15 01:55:35 -06:00
.TP
2016-10-22 16:45:03 -06:00
.B \--cpu_speed 'on/off'
Hide/Show cpu speed.
.TP
.B \--cpu_temp 'on/off'
Hide/Show cpu temperature.
.br
NOTE This only works on linux.
.TP
.B \--distro_shorthand 'on/off'
Shorten the output of distro (tiny, on, off)
.br
2016-10-30 01:18:15 -06:00
NOTE: This option won't work in Windows (Cygwin)
.TP
2016-10-30 03:55:14 -06:00
.B \--kernel_shorthand 'on/off'
2016-03-04 06:59:56 -07:00
Shorten the output of kernel
2016-10-30 01:18:15 -06:00
.br
NOTE: This option won't work in BSDs (except PacBSD and PC-BSD)
2016-03-04 06:59:56 -07:00
.TP
.B \--uptime_shorthand 'on/off'
2016-03-04 06:59:56 -07:00
Shorten the output of uptime (tiny, on, off)
.TP
2016-03-17 23:32:06 -06:00
.B \--refresh_rate 'on/off'
Whether to display the refresh rate of each monitor
2016-10-20 23:54:40 -06:00
.br
Note: Unsupported on Windows
2016-03-17 23:32:06 -06:00
.TP
.B \--gpu_brand on/off
Enable/Disable GPU brand in output. (AMD/NVIDIA/Intel)
.TP
.B \--gtk_shorthand 'on/off'
2016-03-04 06:59:56 -07:00
Shorten output of gtk theme/icons
.TP
.B \--gtk2 'on/off'
2016-03-04 06:59:56 -07:00
Enable/Disable GTK2 theme/icons output
.TP
.B \--gtk3 'on/off'
2016-03-04 06:59:56 -07:00
Enable/Disable gtk3 theme/icons output
.TP
.B \--shell_path 'on/off'
2016-10-03 00:05:29 -06:00
Enable/Disable showing $SHELL path
2016-03-04 06:59:56 -07:00
.TP
.B \--shell_version 'on/off'
2016-10-03 00:05:29 -06:00
Enable/Disable showing $SHELL version
2016-03-04 06:59:56 -07:00
.TP
.B \--ip_host 'url'
2016-10-26 01:24:37 -06:00
URL to query for public IP
2016-03-04 06:59:56 -07:00
.TP
.B \--song_shorthand 'on/off'
2016-03-04 06:59:56 -07:00
Print the Artist/Title on seperate lines
.TP
.B \--birthday_shorthand 'on/off'
2016-03-04 06:59:56 -07:00
Shorten the output of birthday
.TP
.B \--birthday_time 'on/off'
2016-03-04 06:59:56 -07:00
Enable/Disable showing the time in birthday output
.TP
.B \--birthday_format 'format'
Format the birthday output. (Uses 'date' cmd format)
2016-03-04 06:59:56 -07:00
.SH TEXT FORMATTING
2016-03-04 06:59:56 -07:00
.TP
.B \--colors x x x x x x
Changes the text colors in this order:
title, @, underline, subtitle, colon, info
2016-04-29 01:41:21 -06:00
.TP
.B \--underline on/off
enable/disable the underline.
.TP
.B \--underline_char 'char'
2016-03-04 07:18:22 -07:00
Character to use when underlining title
2016-03-04 06:59:56 -07:00
.TP
.B \--bold 'on/off'
2016-03-04 06:59:56 -07:00
Enable/Disable bold text
.TP
.B \--prompt_height 'num'
2016-03-04 06:59:56 -07:00
Set this to your prompt height to fix issues
with the text going off screen at the top
.SH COLOR BLOCKS
.TP
.B \--color_blocks 'on/off'
2016-03-04 06:59:56 -07:00
Enable/Disable the color blocks
.TP
.B \--block_width 'num'
Width of color blocks in spaces
.TP
.B \--block_height 'num'
Height of color blocks in lines
2016-03-04 06:59:56 -07:00
.TP
.B \--block_range 'start' 'end'
2016-03-04 06:59:56 -07:00
Range of colors to print as blocks
.SH BARS
2016-03-12 15:14:56 -07:00
.TP
.B \--bar_char 'elapsed char' 'total char'
Characters to use when drawing bars.
2016-04-29 01:41:21 -06:00
.TP
.B \--bar_border on/off
2016-04-29 01:41:21 -06:00
Whether or not to surround the bar with '[]'
2016-03-12 15:14:56 -07:00
.TP
.B \--bar_length 'num'
Length in spaces to make the bars.
2016-03-12 15:14:56 -07:00
.TP
.B \--bar_colors 'num' 'num'
Colors to make the bar.
2016-03-12 15:14:56 -07:00
.br
Set in this order: elapsed, total
.TP
2016-06-13 05:42:53 -06:00
.B \--cpu_display 'mode'
Bar mode.
2016-03-12 15:14:56 -07:00
.br
2016-06-13 05:42:53 -06:00
Takes: bar, infobar, barinfo, off
2016-03-12 15:14:56 -07:00
.TP
2016-06-13 05:42:53 -06:00
.B \--memory_display 'mode'
Bar mode.
2016-03-12 15:14:56 -07:00
.br
2016-06-13 05:42:53 -06:00
Takes: bar, infobar, barinfo, off
2016-03-12 15:14:56 -07:00
.TP
2016-06-13 05:42:53 -06:00
.B \--battery_display 'mode'
Bar mode.
2016-03-12 15:14:56 -07:00
.br
2016-06-13 05:42:53 -06:00
Takes: bar, infobar, barinfo, off
2016-03-12 15:14:56 -07:00
.TP
2016-06-13 05:42:53 -06:00
.B \--disk_display 'mode'
Bar mode.
2016-03-12 15:14:56 -07:00
.br
2016-06-13 05:42:53 -06:00
Takes: bar, infobar, barinfo, off
2016-03-12 15:14:56 -07:00
2016-03-04 06:59:56 -07:00
.SH IMAGE
.TP
.B \--image 'type'
2016-03-04 06:59:56 -07:00
Image source. Where and what image we display.
.br
2016-03-25 04:28:51 -06:00
Possible values: wall, ascii, /path/to/img, /path/to/dir/, off
2016-03-04 06:59:56 -07:00
.TP
.B \--size 'size'
2016-05-26 23:23:02 -06:00
How to size the image.
.br
Possible values: auto, 00px, 00%, none
2016-03-04 06:59:56 -07:00
.TP
.B \--crop_mode 'mode'
2016-03-04 06:59:56 -07:00
Which crop mode to use
2016-03-12 15:14:56 -07:00
.br
Takes the values: normal, fit, fill
2016-03-04 06:59:56 -07:00
.TP
.B \--crop_offset 'value'
2016-03-04 06:59:56 -07:00
Change the crop offset for normal mode.
.br
Possible values: northwest, north, northeast,
west, center, east, southwest, south, southeast
.TP
.B \--xoffset 'value'
2016-03-04 06:59:56 -07:00
How close the image will be to the left edge of the
window in pixel. This only works with w3m.
.TP
.B \--yoffset 'value'
2016-03-04 06:59:56 -07:00
How close the image will be to the top edge
of the window. This only works with w3m.
.TP
2016-10-21 08:14:02 -06:00
.B \--bg_color 'color'
Background color to display behind transparent image.
This only works with w3m.
.TP
.B \--gap 'num'
2016-03-04 06:59:56 -07:00
Gap between image and text.
.br
NOTE: --gap can take a negative value which
will move the text closer to the left side.
.TP
.B \--clean
2016-11-15 04:34:44 -07:00
Delete cached files and thumbnails.
2016-03-04 06:59:56 -07:00
.SH ASCII
.TP
.B \--ascii 'value'
2016-03-04 06:59:56 -07:00
Where to get the ASCII from
.br
Possible values: distro, /path/to/ascii
.TP
2016-03-05 15:08:59 -07:00
.B \--ascii_colors x x x x x x
Colors to print the ASCII art
2016-03-04 06:59:56 -07:00
.TP
.B \--ascii_distro 'distro'
2016-03-04 06:59:56 -07:00
Which Distro\'s ASCII art to print
2016-04-29 01:41:21 -06:00
.TP
.B \--ascii_logo_size 'size'
Size of ascii logo.
Supported distros: Arch, Gentoo, Crux, OpenBSD.
Possible values: small, normal
.TP
.B \--ascii_bold 'on/off'
Whether or not to bold the ascii logo.
2016-10-03 04:51:42 -06:00
.TP
.B \--logo | -L
Hide the info text and only show the ascii logo.
2016-03-04 06:59:56 -07:00
.SH SCREENSHOT
.TP
.B \--scrot 'path'
2016-03-04 06:59:56 -07:00
Take a screenshot, if path is left empty the screenshot
2016-10-03 15:26:31 -06:00
function will use $scrot_dir and $scrot_name.
.TP
.B \--upload | -su 'path'
Same as --scrot but uploads the scrot to a website.
.TP
.B \--image_host 'host'
Website to upload scrots to. Takes: imgur, teknik
2016-03-04 06:59:56 -07:00
.TP
2016-03-04 15:22:48 -07:00
.B \--scrot_cmd 'cmd'
2016-03-04 06:59:56 -07:00
Screenshot program to launch
.SH OTHER
.TP
.B \--config 'path'
2016-03-04 06:59:56 -07:00
Specify a path to a custom config file
2016-05-08 16:27:59 -06:00
.TP
.B \--config none
Launch the script without a config file
2016-03-04 06:59:56 -07:00
.TP
.B \--help
2016-04-29 01:41:21 -06:00
.TP
.B \--test
Launch the script with all functions / options enabled.
This should only be used for testing purposes, ie Travis.CI.
.TP
2016-05-29 23:14:16 -06:00
.B \--version
Show neofetch version.
.TP
2016-04-29 01:41:21 -06:00
.B \-v
Display error messages.
.TP
.B \-vv
Display a verbose log for error reporting.
2016-03-04 06:59:56 -07:00
.SH "SEE ALSO"
http://github.com/dylanaraps/neofetch
.SH BUGS
Report bugs to <https://github.com/dylanaraps/neofetch/issues>
.SH LICENSE
The MIT License (MIT)
Copyright (c) 2016 Dylan Araps
Permission is hereby granted, free of charge, to any person obtaining a
copy of this software and associated documentation files (the "Software"),
to deal in the Software without restriction, including without limitation
the rights to use, copy, modify, merge, publish, distribute, sublicense,
and/or sell copies of the Software, and to permit persons to whom
the Software is furnished to do so, subject to the following conditions:
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR
OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
OTHER DEALINGS IN THE SOFTWARE.
.SH AUTHOR
Created by Dylan Araps.