June neofetch update
This commit is contained in:
Ohio2
parent
b179513002
commit
db0a5343ae
10 changed files with 12077 additions and 1 deletions
1
neofetch
1
neofetch
|
|
@ -1 +0,0 @@
|
||||||
Subproject commit bc71e732a905e6f27518058970cfe5b789ef2e7f
|
|
||||||
20
neofetch/.github/ISSUE_TEMPLATE.md
vendored
Normal file
20
neofetch/.github/ISSUE_TEMPLATE.md
vendored
Normal file
|
|
@ -0,0 +1,20 @@
|
||||||
|
## Description
|
||||||
|
|
||||||
|
If you're suggesting a new feature then just a description will suffice.
|
||||||
|
|
||||||
|
- [ ] Does this issue still occur in the master branch? (**Required if issue**)
|
||||||
|
|
||||||
|
|
||||||
|
#### Neofetch version
|
||||||
|
|
||||||
|
## Screenshot
|
||||||
|
|
||||||
|
## Config file
|
||||||
|
|
||||||
|
## Verbose log
|
||||||
|
|
||||||
|
1. Run `neofetch -vv 2> neofetchlog`
|
||||||
|
2. Upload the contents of `neofetchlog` to pastebin, gist or equivalent.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
10
neofetch/.github/PULL_REQUEST_TEMPLATE.md
vendored
Normal file
10
neofetch/.github/PULL_REQUEST_TEMPLATE.md
vendored
Normal file
|
|
@ -0,0 +1,10 @@
|
||||||
|
## Description
|
||||||
|
|
||||||
|
Only fill in the fields below if relevant.
|
||||||
|
|
||||||
|
|
||||||
|
## Features
|
||||||
|
|
||||||
|
## Issues
|
||||||
|
|
||||||
|
## TODO
|
||||||
16
neofetch/.travis.yml
Normal file
16
neofetch/.travis.yml
Normal file
|
|
@ -0,0 +1,16 @@
|
||||||
|
language: bash
|
||||||
|
sudo: required
|
||||||
|
|
||||||
|
os:
|
||||||
|
- linux
|
||||||
|
- osx
|
||||||
|
|
||||||
|
before_install:
|
||||||
|
- if [[ "$TRAVIS_OS_NAME" == "osx" ]]; then brew update; fi
|
||||||
|
- if [[ "$TRAVIS_OS_NAME" == "osx" ]]; then brew install screenresolution; fi
|
||||||
|
|
||||||
|
script:
|
||||||
|
- time ./neofetch --travis -v
|
||||||
|
- if [[ "$TRAVIS_OS_NAME" == "linux" ]]; then shellcheck -e SC2244 -e SC2243 neofetch; fi
|
||||||
|
# Check for lines longer than 100 chars.
|
||||||
|
- if grep '.\{102\}' neofetch; then (exit 1); else (exit 0); fi
|
||||||
151
neofetch/CONTRIBUTING.md
Normal file
151
neofetch/CONTRIBUTING.md
Normal file
|
|
@ -0,0 +1,151 @@
|
||||||
|
# How to Contribute
|
||||||
|
|
||||||
|
<!-- vim-markdown-toc GFM -->
|
||||||
|
|
||||||
|
* [Coding Conventions](#coding-conventions)
|
||||||
|
* [ShellCheck](#shellcheck)
|
||||||
|
* [No no's](#no-nos)
|
||||||
|
* [If Statements](#if-statements)
|
||||||
|
* [Case Statements](#case-statements)
|
||||||
|
* [Making changes to Neofetch](#making-changes-to-neofetch)
|
||||||
|
* [Adding support for a new Operating System / Distribution.](#adding-support-for-a-new-operating-system--distribution)
|
||||||
|
|
||||||
|
<!-- vim-markdown-toc -->
|
||||||
|
|
||||||
|
|
||||||
|
## Coding Conventions
|
||||||
|
|
||||||
|
- Use `bash` built-ins wherever possible.
|
||||||
|
- Try not to pipe (`|`) at all.
|
||||||
|
- Limit usage of external commands `$(cmd)`.
|
||||||
|
- Indent 4 spaces.
|
||||||
|
- Use [snake_case](https://en.wikipedia.org/wiki/Snake_case) for function
|
||||||
|
and variable names.
|
||||||
|
- Keep lines below `100` characters long.
|
||||||
|
- Use `[[ ]]` for tests.
|
||||||
|
- Quote **EVERYTHING**.
|
||||||
|
|
||||||
|
### ShellCheck
|
||||||
|
|
||||||
|
For your contribution to be accepted, your changes need to pass
|
||||||
|
ShellCheck.
|
||||||
|
|
||||||
|
```sh
|
||||||
|
shellcheck neofetch
|
||||||
|
```
|
||||||
|
|
||||||
|
**Note**: If you have trouble installing ShellCheck. You can open a pull
|
||||||
|
request on the repo and our Travis.ci hook will run ShellCheck for you.
|
||||||
|
|
||||||
|
|
||||||
|
### No no's
|
||||||
|
|
||||||
|
- Don’t use GNU conventions in commands.
|
||||||
|
- Use POSIX arguments and flags.
|
||||||
|
- Don’t use `cut`.
|
||||||
|
- Use `bash`'s built-in [parameter expansion](http://wiki.bash-hackers.org/syntax/pe).
|
||||||
|
- Don’t use `echo`.
|
||||||
|
- Use `printf "%s\n"`
|
||||||
|
- Don’t use `bc`.
|
||||||
|
- Don’t use `sed`.
|
||||||
|
- Use `bash`'s built-in [parameter expansion](http://wiki.bash-hackers.org/syntax/pe).
|
||||||
|
- Don’t use `cat`.
|
||||||
|
- Use `bash`'s built-in syntax (`file="$(< /path/to/file.txt)")`).
|
||||||
|
- Don’t use `grep "pattern" | awk '{ printf }'`.
|
||||||
|
- Use `awk '/pattern/ { printf }'`
|
||||||
|
- Don’t use `wc`.
|
||||||
|
- Use `${#var}` or `${#arr[@]}`.
|
||||||
|
|
||||||
|
|
||||||
|
### If Statements
|
||||||
|
|
||||||
|
If the test only has one command inside of it; use the compact test
|
||||||
|
syntax. Otherwise the normal `if`/`fi` is just fine.
|
||||||
|
|
||||||
|
```sh
|
||||||
|
# Bad
|
||||||
|
if [[ "$var" ]]; then
|
||||||
|
printf "%s\n" "$var"
|
||||||
|
fi
|
||||||
|
|
||||||
|
# Good
|
||||||
|
[[ "$var" ]] && printf "%s\n" "$var"
|
||||||
|
|
||||||
|
# Also good (Use this for longer lines).
|
||||||
|
[[ "$var" ]] && \
|
||||||
|
printf "%s\n" "$var"
|
||||||
|
```
|
||||||
|
|
||||||
|
|
||||||
|
### Case Statements
|
||||||
|
|
||||||
|
Case statements need to be formatted in a specific way.
|
||||||
|
|
||||||
|
```sh
|
||||||
|
# Good example (Notice the indentation).
|
||||||
|
case "$var" in
|
||||||
|
1) printf "%s\n" 1 ;;
|
||||||
|
2)
|
||||||
|
printf "%s\n" "1"
|
||||||
|
printf "%s\n" "2"
|
||||||
|
;;
|
||||||
|
|
||||||
|
*)
|
||||||
|
printf "%s\n" "1"
|
||||||
|
printf "%s\n" "2"
|
||||||
|
printf "%s\n" "3"
|
||||||
|
;;
|
||||||
|
esac
|
||||||
|
```
|
||||||
|
|
||||||
|
## Making changes to Neofetch
|
||||||
|
|
||||||
|
### Adding support for a new Operating System / Distribution.
|
||||||
|
|
||||||
|
Adding support for a new OS/Distro requires adding the Name, Logo and
|
||||||
|
Colors of the OS/Distro to the `get_distro_ascii()` function.
|
||||||
|
|
||||||
|
The function is located right at the bottom of the script, one function
|
||||||
|
above `main()`. Inside this function you’ll find an alphabetical list of
|
||||||
|
each OS/Distro.
|
||||||
|
|
||||||
|
Find the spot in the list your new OS/Distro fits into and start
|
||||||
|
implementing your changes.
|
||||||
|
|
||||||
|
If your OS/Distro requires changes to the actual information gathering
|
||||||
|
functions then you can make these changes in the `get_*` functions.
|
||||||
|
|
||||||
|
**Syntax**:
|
||||||
|
|
||||||
|
- You have to escape back-slashes (`\`). (eg `\\`)
|
||||||
|
- You can use `${c1}` to `${c6}`to color the ascii.
|
||||||
|
- These are evaluated *after* we read the file.
|
||||||
|
|
||||||
|
|
||||||
|
**Example**:
|
||||||
|
|
||||||
|
```sh
|
||||||
|
"CRUX"*)
|
||||||
|
set_colors 4 5 7 6
|
||||||
|
read -rd '' ascii_data <<'EOF'
|
||||||
|
${c1} odddd
|
||||||
|
oddxkkkxxdoo
|
||||||
|
ddcoddxxxdoool
|
||||||
|
xdclodod olol
|
||||||
|
xoc xdd olol
|
||||||
|
xdc ${c2}k00${c1}Okdlol
|
||||||
|
xxd${c2}kOKKKOkd${c1}ldd
|
||||||
|
xdco${c2}xOkdlo${c1}dldd
|
||||||
|
ddc:cl${c2}lll${c1}oooodo
|
||||||
|
odxxdd${c3}xkO000kx${c1}ooxdo
|
||||||
|
oxdd${c3}x0NMMMMMMWW0od${c1}kkxo
|
||||||
|
oooxd${c3}0WMMMMMMMMMW0o${c1}dxkx
|
||||||
|
docldkXW${c3}MMMMMMMWWN${c1}Odolco
|
||||||
|
xx${c2}dx${c1}kxxOKN${c3}WMMWN${c1}0xdoxo::c
|
||||||
|
${c2}xOkkO${c1}0oo${c3}odOW${c2}WW${c1}XkdodOxc:l
|
||||||
|
${c2}dkkkxkkk${c3}OKX${c2}NNNX0Oxx${c1}xc:cd
|
||||||
|
${c2} odxxdx${c3}xllod${c2}ddooxx${c1}dc:ldo
|
||||||
|
${c2} lodd${c1}dolccc${c2}ccox${c1}xoloo
|
||||||
|
EOF
|
||||||
|
;;
|
||||||
|
```
|
||||||
21
neofetch/LICENSE.md
Normal file
21
neofetch/LICENSE.md
Normal file
|
|
@ -0,0 +1,21 @@
|
||||||
|
The MIT License (MIT)
|
||||||
|
|
||||||
|
Copyright (c) 2015-2020 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 above copyright notice and this permission notice shall be included in all
|
||||||
|
copies or substantial portions of the Software.
|
||||||
|
|
||||||
|
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.
|
||||||
16
neofetch/Makefile
Normal file
16
neofetch/Makefile
Normal file
|
|
@ -0,0 +1,16 @@
|
||||||
|
PREFIX ?= /usr
|
||||||
|
MANDIR ?= $(PREFIX)/share/man
|
||||||
|
|
||||||
|
all:
|
||||||
|
@echo Run \'make install\' to install Neofetch.
|
||||||
|
|
||||||
|
install:
|
||||||
|
@mkdir -p $(DESTDIR)$(PREFIX)/bin
|
||||||
|
@mkdir -p $(DESTDIR)$(MANDIR)/man1
|
||||||
|
@cp -p neofetch $(DESTDIR)$(PREFIX)/bin/neofetch
|
||||||
|
@cp -p neofetch.1 $(DESTDIR)$(MANDIR)/man1
|
||||||
|
@chmod 755 $(DESTDIR)$(PREFIX)/bin/neofetch
|
||||||
|
|
||||||
|
uninstall:
|
||||||
|
@rm -rf $(DESTDIR)$(PREFIX)/bin/neofetch
|
||||||
|
@rm -rf $(DESTDIR)$(MANDIR)/man1/neofetch.1*
|
||||||
25
neofetch/README.md
Normal file
25
neofetch/README.md
Normal file
|
|
@ -0,0 +1,25 @@
|
||||||
|
<h3 align="center"><img src="https://i.imgur.com/ZQI2EYz.png" alt="logo" height="100px"></h3>
|
||||||
|
<p align="center">A command-line system information tool written in bash 3.2+</p>
|
||||||
|
|
||||||
|
<p align="center">
|
||||||
|
<a href="./LICENSE.md"><img src="https://img.shields.io/badge/license-MIT-blue.svg"></a>
|
||||||
|
<a href="https://github.com/dylanaraps/neofetch/releases"><img src="https://img.shields.io/github/release/dylanaraps/neofetch.svg"></a>
|
||||||
|
<a href="https://repology.org/metapackage/neofetch"><img src="https://repology.org/badge/tiny-repos/neofetch.svg" alt="Packaging status"></a>
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<img src="https://i.imgur.com/GFmC5Ad.png" alt="neofetch" align="right" height="240px">
|
||||||
|
|
||||||
|
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.
|
||||||
|
|
||||||
|
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.
|
||||||
|
|
||||||
|
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.
|
||||||
|
|
||||||
|
<img src="https://i.imgur.com/lUrkQBN.png" alt="neofetch" align="right" height="240px">
|
||||||
|
|
||||||
|
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.
|
||||||
|
|
||||||
|
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.
|
||||||
|
|
||||||
|
|
||||||
|
### More: \[[Dependencies](https://github.com/dylanaraps/neofetch/wiki/Dependencies)\] \[[Installation](https://github.com/dylanaraps/neofetch/wiki/Installation)\] \[[Wiki](https://github.com/dylanaraps/neofetch/wiki)\]
|
||||||
11395
neofetch/neofetch
Executable file
11395
neofetch/neofetch
Executable file
File diff suppressed because it is too large
Load diff
423
neofetch/neofetch.1
Normal file
423
neofetch/neofetch.1
Normal file
|
|
@ -0,0 +1,423 @@
|
||||||
|
.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.47.16.
|
||||||
|
.TH NEOFETCH "1" "August 2020" "Neofetch 7.1.0" "User Commands"
|
||||||
|
.SH NAME
|
||||||
|
Neofetch \- A fast, highly customizable system info script
|
||||||
|
.SH SYNOPSIS
|
||||||
|
.B neofetch
|
||||||
|
\fI\,func_name --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
|
||||||
|
func_name
|
||||||
|
Specify a function name (second part of info() from config) to
|
||||||
|
quickly display only that function's information.
|
||||||
|
.IP
|
||||||
|
Example: neofetch uptime \fB\-\-uptime_shorthand\fR tiny
|
||||||
|
.IP
|
||||||
|
Example: neofetch uptime disk wm memory
|
||||||
|
.IP
|
||||||
|
This can be used in bars and scripts like so:
|
||||||
|
.IP
|
||||||
|
memory="$(neofetch memory)"; memory="${memory##*: }"
|
||||||
|
.IP
|
||||||
|
For multiple outputs at once (each line of info in an array):
|
||||||
|
.IP
|
||||||
|
IFS=$'\en' read \fB\-d\fR "" \fB\-ra\fR info < <(neofetch memory uptime wm)
|
||||||
|
.IP
|
||||||
|
info=("${info[@]##*: }")
|
||||||
|
.TP
|
||||||
|
\fB\-\-disable\fR infoname
|
||||||
|
Allows you to disable an info line from appearing
|
||||||
|
in the output. 'infoname' is the function name from the
|
||||||
|
\&'print_info()' function inside the config file.
|
||||||
|
For example: 'info "Memory" memory' would be '\-\-disable memory'
|
||||||
|
.IP
|
||||||
|
NOTE: You can supply multiple args. eg. 'neofetch \fB\-\-disable\fR cpu gpu'
|
||||||
|
.TP
|
||||||
|
\fB\-\-title_fqdn\fR on/off
|
||||||
|
Hide/Show Fully Qualified Domain Name in title.
|
||||||
|
.TP
|
||||||
|
\fB\-\-package_managers\fR on/off
|
||||||
|
Hide/Show Package Manager names . (on, tiny, off)
|
||||||
|
.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 (on, tiny, 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 (on, tiny, 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\-\-de_version\fR on/off
|
||||||
|
Show/Hide Desktop Environment version
|
||||||
|
.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, none
|
||||||
|
.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)
|
||||||
|
.IP
|
||||||
|
\&'none' shows only 'Disk' or the configured title.
|
||||||
|
.TP
|
||||||
|
\fB\-\-disk_percent\fR on/off
|
||||||
|
Hide/Show disk percent.
|
||||||
|
.TP
|
||||||
|
\fB\-\-ip_host\fR url
|
||||||
|
URL to query for public IP
|
||||||
|
.TP
|
||||||
|
\fB\-\-ip_timeout\fR int
|
||||||
|
Public IP timeout (in seconds).
|
||||||
|
.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\-\-memory_percent\fR on/off
|
||||||
|
Display memory percentage.
|
||||||
|
.TP
|
||||||
|
\fB\-\-memory_unit\fR kib/mib/gib
|
||||||
|
Memory output unit.
|
||||||
|
.TP
|
||||||
|
\fB\-\-music_player\fR player\-name
|
||||||
|
Manually specify a player to use.
|
||||||
|
Available values are listed in the config file
|
||||||
|
.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
|
||||||
|
.TP
|
||||||
|
\fB\-\-separator\fR string
|
||||||
|
Changes the default ':' separator to the specified string.
|
||||||
|
.SS "COLOR BLOCKS:"
|
||||||
|
.TP
|
||||||
|
\fB\-\-color_blocks\fR on/off
|
||||||
|
Enable/Disable the color blocks
|
||||||
|
.TP
|
||||||
|
\fB\-\-col_offset\fR auto/num
|
||||||
|
Left\-padding of 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', 'chafa', 'jp2a', 'iterm2',
|
||||||
|
\&'off', 'sixel', 'tycat', 'w3m', 'kitty', 'ueberzug'
|
||||||
|
.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/', 'command output' [ascii]
|
||||||
|
.TP
|
||||||
|
\fB\-\-ascii\fR source
|
||||||
|
Shortcut to use 'ascii' backend.
|
||||||
|
.IP
|
||||||
|
NEW: neofetch \fB\-\-ascii\fR "$(fortune | cowsay \fB\-W\fR 30)"
|
||||||
|
.TP
|
||||||
|
\fB\-\-caca\fR source
|
||||||
|
Shortcut to use 'caca' backend.
|
||||||
|
.TP
|
||||||
|
\fB\-\-chafa\fR source
|
||||||
|
Shortcut to use 'chafa' 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\-\-pot\fR source
|
||||||
|
Shortcut to use 'pot' 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\-\-ueberzug\fR source
|
||||||
|
Shortcut to use 'ueberzug' backend.
|
||||||
|
.TP
|
||||||
|
\fB\-\-off\fR
|
||||||
|
Shortcut to use 'off' backend (Disable ascii art).
|
||||||
|
.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
|
||||||
|
.TP
|
||||||
|
NOTE: AIX, Hash, Alpine, AlterLinux, Amazon, Anarchy, Android, instantOS,
|
||||||
|
Antergos, antiX, "AOSC OS", "AOSC OS/Retro", Apricity, ArchCraft,
|
||||||
|
ArcoLinux, ArchBox, ARCHlabs, ArchStrike, XFerience, ArchMerge, Arch,
|
||||||
|
Artix, Arya, Bedrock, Bitrig, BlackArch, BLAG, BlankOn, BlueLight,
|
||||||
|
bonsai, BSD, BunsenLabs, Calculate, Carbs, CentOS, Chakra, ChaletOS,
|
||||||
|
Chapeau, Chrom*, Cleanjaro, ClearOS, Clear_Linux, Clover, Condres,
|
||||||
|
Container_Linux, CRUX, Cucumber, dahlia, Debian, Deepin, DesaOS,
|
||||||
|
Devuan, DracOS, DarkOs, Itc, DragonFly, Drauger, Elementary,
|
||||||
|
EndeavourOS, Endless, EuroLinux, Exherbo, Fedora, Feren, FreeBSD,
|
||||||
|
FreeMiNT, Frugalware, Funtoo, GalliumOS, Garuda, Gentoo, Pentoo,
|
||||||
|
gNewSense, GNOME, GNU, GoboLinux, Grombyang, Guix, Haiku, Huayra, HydroOS,
|
||||||
|
Hyperbola, janus, Kali, KaOS, KDE_neon, Kibojoe, Kogaion, Korora,
|
||||||
|
KSLinux, Kubuntu, LEDE, LaxerOS, LibreELEC, LFS, Linux_Lite, LMDE,
|
||||||
|
Lubuntu, Lunar, macos, Mageia, MagpieOS, Mandriva, Manjaro, TeArch, Maui,
|
||||||
|
Mer, Minix, LinuxMint, Live_Raizo, MX_Linux, Namib, Neptune, NetBSD,
|
||||||
|
Netrunner, Nitrux, NixOS, Nurunner, NuTyX, OBRevenge, OpenBSD,
|
||||||
|
openEuler, OpenIndiana, openmamba, OpenMandriva, OpenStage, OpenWrt,
|
||||||
|
osmc, Oracle, OS Elbrus, PacBSD, Parabola, Pardus, Parrot, Parsix,
|
||||||
|
TrueOS, PCLinuxOS, Pengwin, Peppermint, popos, Porteus, PostMarketOS,
|
||||||
|
Proxmox, Puppy, PureOS, Qubes, Quibian, Radix, Raspbian, Reborn_OS,
|
||||||
|
Redstar, Redcore, Redhat, Refracted_Devuan, Regata, Regolith, Rosa,
|
||||||
|
sabotage, Sabayon, Sailfish, SalentOS, Scientific, Septor,
|
||||||
|
SereneLinux, SharkLinux, Siduction, Slackware, SliTaz, SmartOS,
|
||||||
|
Solus, Source_Mage, Sparky, Star, SteamOS, SunOS, openSUSE_Leap, t2,
|
||||||
|
openSUSE_Tumbleweed, openSUSE, SwagArch, Tails, Trisquel,
|
||||||
|
Ubuntu-Cinnamon, Ubuntu-Budgie, Ubuntu-GNOME, Ubuntu-MATE,
|
||||||
|
Ubuntu-Studio, Ubuntu, Univention, Venom, Void, semc, Obarun,
|
||||||
|
windows10, Windows7, Xubuntu, Zorin, and IRIX have ascii logos.
|
||||||
|
.IP
|
||||||
|
NOTE: Arch, Ubuntu, Redhat, Fedora and Dragonfly have 'old' logo variants.
|
||||||
|
.IP
|
||||||
|
NOTE: Use '{distro name}_old' to use the old logos.
|
||||||
|
.IP
|
||||||
|
NOTE: Ubuntu has flavor variants.
|
||||||
|
.TP
|
||||||
|
Change this to Lubuntu, Kubuntu, Xubuntu, Ubuntu-GNOME,
|
||||||
|
Ubuntu-Studio, Ubuntu-Mate or Ubuntu-Budgie to use the flavors.
|
||||||
|
.TP
|
||||||
|
NOTE: Arcolinux, Dragonfly, Fedora, Alpine, Arch, Ubuntu,
|
||||||
|
CRUX, Debian, Gentoo, FreeBSD, Mac, NixOS, OpenBSD, android,
|
||||||
|
Antrix, CentOS, Cleanjaro, ElementaryOS, GUIX, Hyperbola,
|
||||||
|
Manjaro, MXLinux, NetBSD, Parabola, POP_OS, PureOS,
|
||||||
|
Slackware, SunOS, LinuxLite, OpenSUSE, Raspbian,
|
||||||
|
postmarketOS, 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.
|
||||||
|
.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 and ueberzug.
|
||||||
|
.TP
|
||||||
|
\fB\-\-yoffset\fR px
|
||||||
|
How close the image will be to the top edge of the
|
||||||
|
window. This only works with w3m and ueberzug.
|
||||||
|
.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\-\-no_config\fR
|
||||||
|
Don't create the user 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
|
||||||
Loading…
Reference in a new issue