🖼️ A command-line system information tool written in bash 3.2+
Find a file
2017-05-07 09:55:24 +10:00
.github Github: Require config file for new issues 2017-01-26 16:52:51 +11:00
ascii/distro Ascii: Add ubuntu-mate ascii, closes #712 2017-05-04 08:51:06 +10:00
config Merge branch 'master' of https://github.com/dylanaraps/neofetch 2017-04-26 11:48:54 +10:00
.travis.yml Config: Remove '--config travis' in favor of '--config path/to/travis' 2017-01-24 11:48:09 +11:00
CHANGELOG.md Docs: CHANGELOG 2017-05-04 08:51:49 +10:00
LICENSE.md Misc: Update Copyright to 2017 2017-01-06 19:16:44 +07:00
Makefile Makefile: New Makefile 2017-01-18 08:22:32 +07:00
neofetch W3m: Fix zws 2017-05-07 09:55:24 +10:00
neofetch.1 Merge branch 'master' of https://github.com/dylanaraps/neofetch 2017-04-26 11:48:54 +10:00
README.md General: Bash version docs 2017-04-28 11:24:30 +10:00

Neofetch

Gitter Freenode Build Status MIT licensed Latest release

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. The main purpose of Neofetch is to be used in screenshots to show other users what OS/Distro you're running, what Theme/Icons you're using etc.

Neofetch is highly customizable through the use of command line flags or the user config file. There are over 50 config options to mess around with and there's the print_info() function and friends which let you add your own custom info.

Neofetch can be used on any OS that has BASH 3.2+, it's just a matter of adding support. If your OS/Distro isn't in the list below, feel free to open an issue on the repo and I'll gladly add support. Neofetch currently supports Linux, MacOS, iOS, BSD, Solaris, Android, Haiku, GNU Hurd, MINIX, AIX, and Windows (Cygwin/MSYS2/MinGW/Windows 10 Linux subsystem).

For more information:

https://github.com/dylanaraps/neofetch/wiki

neofetch screenshot

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 contains all of the script's options/settings. The config file allows you to keep your customizations between script versions and allows you to easily share your customizations with other people.

You can launch the script without a config file by using the flag --config none and you can specify a custom config location using --config path/to/config.

See this wiki page for the default config: https://github.com/dylanaraps/neofetch/wiki/Config-File

Customizing what info gets displayed

https://github.com/dylanaraps/neofetch/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:

alias neofetch2="neofetch \
--config off \
--block_range 1 8 \
--bold off \
--uptime_shorthand on \
--gtk_shorthand on \
--colors 4 1 8 8 8 7 \
"

Thanks

Thanks to:

  • Contributors
    • Thanks for making Neofetch better, I really appreciate it.
  • Packagers
    • Thanks for maintaining Neofetch packages.
  • Users
    • Thanks for using Neofetch!
  • Screenfetch:
    • We've used some snippets as a base for a few functions in this script.
    • Some of the ASCII logos.
  • ufetch:
    • Tiny ASCII logos