search

fastfetch-cli / fastfetch

Like neofetch, but much faster because written mostly in C.
MIT License
8.03k stars 347 forks source link
command-line fastfetch fetch flashfetch hacktoberfest terminal

readme

Fastfetch

GitHub Workflow Status (with event) GitHub license GitHub contributors GitHub top language GitHub commit activity (branch)
homebrew downloads GitHub all releases
GitHub release (with filter) latest packaged version(s) Packaging status

Fastfetch is a neofetch-like tool for fetching system information and displaying it prettily. It is written mainly in C, with performance and customizability in mind. Currently, Linux, Android, FreeBSD, macOS, SunOS and Windows 7+ are supported.

There are screenshots on different platforms.

Installation

Linux

Some distros packaged an outdated fastfetch version. Older version receive no support, so please try always to use the latest version.

Replace sudo with doas depending on what you use.

See also if fastfetch has been packaged for your favorite Linux distro.

If fastfetch is not packaged for your distro or an outdated version is packaged, linuxbrew is a good alternative: brew install fastfetch

macOS

Windows

You may also download the program directly from the GitHub releases page in the form of an archive file.

FreeBSD

Android (Termux)

Build from source

See Wiki: https://github.com/fastfetch-cli/fastfetch/wiki/Building

Usage

Customization

Fastfetch uses the JSONC (or JSON with comments) for configuration. See Wiki for detail. There are some premade config files in presets, including the ones used for the screenshots above. You can load them using -c <filename>. Those files can serve as examples of the configuration syntax.

Logos can be heavily customized too; see the logo documentation for more information.

Packaging

Repositories

Packaging status

Manual

FAQ

Q: Neofetch is good enough. Why do I need fastfetch?

  1. Fastfetch is actively maintained.
  2. Fastfetch is faster. As the name suggests.
  3. Fastfetch has a greater number of features, though by default fastfetch only has a few modules enabled; use fastfetch -c all to find what you want.
  4. Fastfetch is more configurable. You can find more information in the Wiki: https://github.com/fastfetch-cli/fastfetch/wiki/Configuration.
  5. Fastfetch is more polished. For example, neofetch prints 555MiB in Memory module and 23G in Disk module, whereas fastfetch prints 555.00 MiB and 22.97 GiB respectively.
  6. Fastfetch is more accurate. For example, neofetch never actually supports the Wayland protocol.

Q: Fastfetch shows my local IP address. It leaks my privacy!

A local IP (10.x.x.x, 172.x.x.x, 192.168.x.x) has nothing to do with privacy. It only makes sense if you are on the same network, for example, if you connect to the same Wi-Fi network.

Actually the Local IP module is the most useful module for me personally. I (@CarterLi) have several VMs installed to test fastfetch and often need to SSH into them. I have fastfetch running on shell startup and I never need to type ip addr manually.

If you really don't like it, you can disable the Local IP module in config.jsonc.

Q: Where is the config file? I can't find it.

Fastfetch does not generate config file automatically. You can use fastfetch --gen-config to generate one. The config file will be saved in ~/.config/fastfetch/config.jsonc by default. See Wiki for detail.

Q: The configuration is so complex. Where is the documentation?

Fastfetch uses JSON (with comments) for configuration. I suggest you use an IDE with JSON schema support (like VSCode) to edit it.

Alternatively, you can refer to the presets in presets directory.

Q: I WANT THE DOCUMENTATION!

Here is the documentation. It is generated from JSON schema but you won't like it.

Q: How can I customize the module output?

Fastfetch uses format to generate output. For example, to make the GPU module show only the GPU name (leaving other information undisplayed), you can use

{
    "modules": [
        {
            "type": "gpu",
            "format": "{2}" // See `fastfetch -h gpu-format` for detail
        }
    ]
}

. . which is equivalent to fastfetch -s gpu --gpu-format '{2}'

See fastfetch -h format for information on basic usage. For module specific formattion, see fastfetch -h <module>-format

Q: I have my own ascii-art / image file. How can I show it with fastfetch?

Try fastfetch -l /path/to/logo. See logo documentation for detail.

If you just want to display distro name in FIGlet text:

# install pyfiglet and jq first
pyfiglet -s -f small_slant $(fastfetch -s os --format json | jq -r '.[0].result.name') && fastfetch -l none

image

Q: Fastfetch runs in white and black on shell startup. Why?

This issue usually happens when using fastfetch with p10k. There are known incompatibility between fastfetch and p10k instant prompt. The p10k doc clearly states that you should NOT print anything to stdout after p10k-instant-prompt is initialized. You should either put fastfetch before initialization of p10k-instant-prompt (recommended)

You can always use fastfetch --pipe false to force fastfetch running in colorful mode.

Q: I want feature A / B / C. Will fastfetch support it?

Fastfetch is a system information tool. We only accept hardware or system level software feature requests. For most personal uses, I recommend using Command module to detect it yourself, which can be used to grab output from a custom shell script:

// This module shows the default editor
{
    "modules": [
        {
            "type": "command",
            "text": "$EDITOR --version | head -1",
            "key": "Editor"
        }
    ]
}

Otherwise, open a feature request in GitHub Issues.

Q: I have questions. Where can I get help?

Star History

Give it a star to support us!

Star History Chart