142 lines
4.6 KiB
Markdown
142 lines
4.6 KiB
Markdown
# Neofetch
|
|
|
|
[](https://gitter.im/dylanaraps/fetch?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge) [](https://travis-ci.org/dylanaraps/neofetch) [](./LICENSE.md) [](https://github.com/dylanaraps/neofetch/releases)
|
|
|
|
This is the home of my fetch script! This script gathers info <br />
|
|
about your system and prints it to the terminal next to an image, <br \>
|
|
your distro's logo or any ascii art of your choice!
|
|
|
|
Have a look at the wiki, I've updated/added some new pages!<br \>
|
|
**https://github.com/dylanaraps/neofetch/wiki**
|
|
|
|
|
|
|
|
|
|
## Features
|
|
|
|
- Supports **Linux**, **MacOS**, **iOS**, **BSD**, **Solaris**, **Android**, **Haiku OS**, **GNU Hurd** and **Windows (Cygwin/Windows 10 Linux subsystem)**
|
|
- Display a **full color image**, a file containing **ascii art** or your **distro's logo** in ascii next to the info.
|
|
- The script is **fast**. We use bash builtins wherever possible and only spawn external processes when necessary.
|
|
- Take a screenshot of your desktop on script finish.
|
|
- Customize **which** info is displayed, **where** it's displayed and **when** it's displayed.
|
|
- See this **[wiki page](https://github.com/dylanaraps/neofetch/wiki/Customizing-Info)**
|
|
|
|
|
|
## Dependencies
|
|
|
|
https://github.com/dylanaraps/neofetch/wiki/Dependencies
|
|
|
|
|
|
## Installation
|
|
|
|
https://github.com/dylanaraps/neofetch/wiki/Installation
|
|
|
|
|
|
## Post Install
|
|
|
|
|
|
#### Using the config file
|
|
|
|
Neofetch will by default create a config file at `$HOME/.config/neofetch/config` and this file<br \>
|
|
contains all of the script's options/settings. The config file allows you to keep your<br \>
|
|
customizations between script versions and allows you to easily share your customizations<br \>
|
|
with other people.
|
|
|
|
You can launch the script without a config file by using the flag `--config none` and you can<br \>
|
|
specify a custom config location using `--config path/to/config`.
|
|
|
|
|
|
#### Customizing what info gets displayed
|
|
|
|
https://github.com/dylanaraps/fetch/wiki/Customizing-Info
|
|
|
|
|
|
#### Customizing the script using a custom alias
|
|
|
|
If you don't want to use the config file you can customize almost everything using launch flags!
|
|
|
|
Here's an example neofetch alias:
|
|
|
|
```sh
|
|
alias neofetch2="neofetch \
|
|
--config off \
|
|
--block_range 1 8 \
|
|
--bold off \
|
|
--uptime_shorthand on \
|
|
--gtk_shorthand on \
|
|
--colors 4 1 8 8 8 7 \
|
|
"
|
|
```
|
|
|
|
|
|
## Frequently Asked Questions
|
|
|
|
|
|
#### How do I enable screenfetch mode?
|
|
|
|
Launching the script with `--ascii` or setting `image="ascii"` <br \>
|
|
inside the config file will launch the script in "screenfetch mode". The script will<br \>
|
|
display your distro's ascii next to the info, exactly like screenfetch.
|
|
|
|
**NOTE:** If you **don't** have `w3m-img` or `imagemagick` installed screenfetch mode will be<br \>
|
|
used automatically
|
|
|
|
#### Why doesn't Neofetch support my wallpaper setter?
|
|
|
|
It's hard to add support for other wallpaper setters as they don't provide a way of <br \>
|
|
getting the current wallpaper from the cli.
|
|
|
|
If your wallpaper setter **does** provide a way of getting the current wallpaper or you<br \>
|
|
know where it's stored then adding support won't be a problem!<br \>
|
|
|
|
|
|
## Issues and Workarounds
|
|
|
|
|
|
#### The text is pushed over too far to the right
|
|
|
|
The easiest way to fix this is to change the value of `--gap` or `$gap`<br \>
|
|
to a negative value. For example `--gap -10` will move the text 10 spaces to the left.
|
|
|
|
|
|
#### getgpu doesn't show my exact video card name
|
|
|
|
If your `lspci | grep "VGA"` output looks like this:
|
|
|
|
```
|
|
01:00.0 VGA compatible controller: NVIDIA Corporation Device 1401 (rev a1)
|
|
```
|
|
|
|
Instead of this:
|
|
|
|
```
|
|
01:00.0 VGA compatible controller: NVIDIA Corporation GM206 [GeForce GTX 960] (rev a1)
|
|
```
|
|
|
|
Then you're affected by the issue.
|
|
|
|
This is caused by your `/usr/share/misc/pci.ids\*` files being outdated and you can fix it<br \>
|
|
by running this command as root.
|
|
|
|
```
|
|
sudo update-pciids
|
|
```
|
|
|
|
#### Neofetch doesn't work correctly with ConEmu.
|
|
|
|
You need to be using the CYGWIN/Msys connector for Neofetch to work seamlessly with ConEmu.
|
|
|
|
https://conemu.github.io/en/CygwinMsysConnector.html
|
|
|
|
|
|
## Thanks
|
|
|
|
Thanks to:
|
|
|
|
- [Screenfetch](https://github.com/KittyKatt/screenFetch):
|
|
- I've used some snippets as a base for a few functions in this script.
|
|
- Some of the ascii logos.
|
|
- [ufetch](https://github.com/jschx/ufetch):
|
|
- Tiny ascii logos
|
|
- Everyone else helped out in one way or another. I'd list all of the names<br \>
|
|
but there's just too many of you. :)
|