Scroll to navigation

FASTFETCH(1) FASTFETCH FASTFETCH(1)

NAME

fastfetch - A fast and feature-rich system information tool similar to neofetch

SYNOPSIS

fastfetch [OPTIONS...]

DESCRIPTION

Fastfetch is a tool for displaying system information in a visually appealing way. Written primarily in C, it focuses on performance and customizability while providing functionality similar to neofetch. It supports Linux, Android, FreeBSD, macOS, and Windows 7 or newer.

CONFIGURATION

Fetch Structure

The structure defines which modules to display and in what order. It consists of module names separated by colons (:). For example: title:separator:os:kernel:uptime

To list all available modules, use --list-modules

Config Files

Fastfetch uses JSONC (JSON with Comments) for configuration files. These files must have the .jsonc extension.

You can generate a default config file using --gen-config. By default, the config file is saved at ~/.config/fastfetch/config.jsonc.

The configuration/preset files are searched in the following locations (in order):

1. Relative to the current working directory

2. Relative to ~/.local/share/fastfetch/presets/

3. Relative to /usr/share/fastfetch/presets/

For detailed information on logo options, module configuration, and formatting, visit: https://github.com/fastfetch-cli/fastfetch/wiki/Configuration

Fastfetch provides several built-in presets. List them with --list-presets.

JSON Schema

A JSON schema is available for editor intelligence when editing the configuration file. Add the following line at the beginning of your config file:

"$schema": "https://github.com/fastfetch-cli/fastfetch/raw/dev/doc/json_schema.json"

OPTIONS

Options are parsed in a case-insensitive manner. For example, --logo-type and --LOGO-TYPE are treated identically.

Arguments in square brackets are optional. Optional boolean arguments default to 'true' when specified without a value.

For more detailed information about a specific option, use: fastfetch -h <option_name_without_dashes>

Any combination of options can be made permanent by generating a configuration file: fastfetch <options> --gen-config

Informative


Display this help message or help for a specific command


Show the full version of fastfetch


Display the raw version string (major.minor.patch)


List search paths for config files


List search paths for presets and logos


List available logos


List available modules


List presets that fastfetch knows about


Presets can be loaded with "--config <preset-name>"


List the supported features that fastfetch was compiled with


Mainly for development


Display available logos


Display the default structure


Set output format

Config


Specify the config file or preset to load


The file will be searched according to the order shown by "fastfetch --list-config-paths". Use "none" to disable further config loading. See also https://github.com/fastfetch-cli/fastfetch/wiki/Configuration for more info


Generate a config file at the specified path with options from the command line (if any)


Defaults to "~/.config/fastfetch/config.jsonc". Will print the generated config if <path> is "-"


Generate a config file at the specified path, overwriting any existing file


Defaults to "~/.config/fastfetch/config.jsonc"

General


Use separate threads for HTTP requests


Set the timeout (ms) for WMI queries


Windows only


Set the timeout (ms) when waiting for child processes


Specify whether only DRM should be used to detect displays


Use this option if you encounter problems with other detection methods.
Linux only


Specify whether to detect and display versions of terminal, shell, editor, and others


Mainly for benchmarking


Set the logo source. Use "none" to disable the logo


Should be the name of a built-in logo or a path to an image file. See also https://github.com/fastfetch-cli/fastfetch/wiki/Logo-options


Set the type of the logo specified in "--logo"


See also https://github.com/fastfetch-cli/fastfetch/wiki/Logo-options


Set the width of the logo (in characters) if it is an image


Required for iTerm image protocol


Set the height of the logo (in characters) if it is an image


Required for iTerm image protocol


Specify whether the logo should fill the specified width and height as much as possible without stretching


Supported by iTerm image protocol only


Override a color in the logo


See `-h color` for the list of available colors


Set the padding on the left and right sides of the logo


Set the padding on the left side of the logo


Set the padding on the right side of the logo


Set the padding at the top of the logo


Specify whether to print the remaining logo if it has more lines than modules to display


Set the position where the logo should be displayed


If true, regenerate the image logo cache


Short for --logo-type file --logo <path>


See "--help logo-type" for more info


Short for --logo-type file-raw --logo <path>


See "--help logo-type" for more info


Short for --logo-type data --logo <data>


See "--help logo-type" for more info


Short for --logo-type data-raw --logo <data>


See "--help logo-type" for more info


Short for --logo-type raw --logo <path>


See "--help logo-type" for more info


Short for --logo-type sixel --logo <path>


See "--help logo-type" for more info


Short for --logo-type kitty --logo <path>


See "--help logo-type" for more info


Short for --logo-type kitty-direct --logo <path>


See "--help logo-type" for more info


Short for --logo-type kitty-icat --logo <path>


See "--help logo-type" for more info


Short for --logo-type iterm --logo <path>


See "--help logo-type" for more info


Short for --logo-type chafa --logo <path>


See "--help logo-type" for more info


Produce character-cell output using foreground colors only


See chafa document for detail


Specify character symbols to employ in final output


See chafa document for detail


Determine how colors are used in the output


This value maps the int value of enum ChafaCanvasMode. See chafa document for detail


Set color space used for quantization


This value maps the int value of enum ChafaColorSpace. See chafa document for detail


Set output dither mode (No effect with 24-bit color)


This value maps the int value of enum ChafaDitherMode. See chafa document for detail

Display


Set the structure of the fetch


Must be a colon-separated list of keys. Use "fastfetch --list-modules" to see available options


Show time usage (in ms) for individual modules


Disable colors


Auto-detected based on isatty(1) by default


Set the color of both keys and title


Shortcut for "--color-keys <color>" and "--color-title <color>"
For color syntax, see <https://github.com/fastfetch-cli/fastfetch/wiki/Color-Format-Specification>


Set the color of the keys


Doesn't affect Title, Separator, and Colors modules. See `-h color` for the list of available colors


Set the color of the title


See `-h color` for the list of available colors


Set the color of module output


See `-h color` for the list of available colors


Set the color of the key-value separator


See `-h color` for the list of available colors


Align the width of keys to <num> characters


Set the left padding of keys to <num> characters


Specify whether to show an icon before string keys


Specify whether keys, title, and ASCII logo should be printed in bright color


Set the separator between key and value


Print errors when they occur


Specify whether to disable line wrap during execution


Specify whether to hide the cursor during execution


Set the percentage output type


1 for percentage number
2 for multi-color bar
3 for both
6 for bar only
9 for colored number
10 for monochrome bar


Set the number of digits to keep after the decimal point when formatting percentage numbers


Set color used for the green state of percentage bars and numbers


See `-h color` for the list of available colors


Set color used for the yellow state of percentage bars and numbers


See `-h color` for the list of available colors


Set color used for the red state of percentage bars and numbers


See `-h color` for the list of available colors


Set the character to use in the elapsed part of percentage bars


Set the character to use in the total part of percentage bars


Set the string to use at the left border of percentage bars


Set the string to use at the right border of percentage bars


Set the width of percentage bars in characters


Specify whether the stdout application buffer should be disabled


Set the number of digits to keep after the decimal point when formatting sizes


Set the binary prefix to use when formatting sizes


Set the largest binary prefix to use when formatting sizes


Set the number of digits to keep after the decimal point when printing CPU/GPU frequency in GHz


Set the temperature unit


Set the number of digits to keep after the decimal point when printing temperature


Set color used for the green state of temperature values


See `-h color` for the list of available colors


Set color used for the yellow state of temperature values


See `-h color` for the list of available colors


Set color used for the red state of temperature values


See `-h color` for the list of available colors

Module specific


Specify whether the title should use fully qualified domain name


Set the color of the user name (left part)


See `-h color` for the list of available colors


Set the color of the @ symbol (middle part)


See `-h color` for the list of available colors


Set the color of the host name (right part)


See `-h color` for the list of available colors


Set the string to be printed by the separator line


Set the color of the separator line


Set the length of the separator line


Set to 0 to automatically calculate it based on the title length


A colon (semicolon on Windows) separated list of folder paths to detect


On Windows, a drive letter must be upper-cased and end with "


A colon (semicolon on Windows) separated list of folder paths to hide from the disk output


A colon separated list of file systems to hide from the disk output


Specify whether regular volumes should be displayed


Specify whether external volumes should be displayed


Specify whether hidden volumes should be displayed


Specify whether subvolumes should be displayed


Specify whether read-only volumes should be displayed


Specify whether unknown volumes (unable to detect sizes) should be displayed


Use f_bavail (lpFreeBytesAvailableToCaller for Windows) instead of f_bfree to calculate used bytes


May be required for macOS to display correct results


Detect total bytes instead of current rate


Show only disks with the given name prefix


Set the wait time (in ms) when detecting disk usage


Show only disks with the given name prefix


Detect and display SSD temperature if supported


Specify whether disconnected Bluetooth devices should be displayed


A colon-separated list of package managers to disable when detecting


Some detection methods can be very slow.
You may need to increase the value of '--processing-timeout' to make it work properly.
Use `--packages-disabled none` to enable all.


Specify whether all displays should be printed in one line


Specify whether decimal refresh rates should not be rounded to integers when printing


Set the order to use when printing displays


Set the sleep time (in ms) when sending DDC/CI requests


See <https://www.ddcutil.com/performance_options/#option-sleep-multiplier> for details


Specify whether multiple results should be printed in one line


Set which types of sound devices should be displayed


Specify whether "SetupAPI" should be used on Windows to detect battery info


SetupAPI supports multiple batteries, but is slower.
Windows only


Detect and display CPU temperature if supported


Detect and display CPU frequency of different core types (e.g., P-cores and E-cores) if supported


Show all CPU caches in one line


Display CPU usage per logical core, instead of an average result


Set the wait time (in ms) when detecting CPU usage


Specify whether DE version should be detected with slower operations


This is only used as a fallback method. Please file a bug report if you encounter any issues.
Linux only


Detect and display GPU temperature if supported


Use driver-specific methods to detect more detailed GPU information (memory usage, core count, etc.)


Requires the latest GPU drivers to be installed.


Force using a specified method to detect GPUs


Will fall back to other methods if the specified method fails


Specify which types of GPUs should not be displayed (default: all GPUs are shown, regardless of recognition)


Detect and display battery temperature if supported


Set the number of digits to keep after the decimal point when printing load average


Show load average values in one line


Show IPv4 addresses in the local IP module


Show IPv6 addresses in the local IP module


Show MAC addresses in the local IP module


Show loopback addresses (127.0.0.1) in the local IP module


Show network interface MTU (Maximum Transmission Unit) size in bytes


Show network interface link speed in human-readable format (or as a 1Mb units integer in JSON format)


Show network prefix length (/N) in the local IP module


Show only interfaces with the given interface name prefix


Show only the interface that is used for default routing


Doesn't work on Android


Show all IPs bound to the same interface. By default, only the first IP is shown


Show network interface flags in the local IP module


Show all IPs in one line


Specify which types of DNS servers should be detected


Show only interfaces with the given name prefix


Show only the interface that is used for default routing


Doesn't work on Android


Detect total bytes instead of current rate


Set the wait time (in ms) when detecting network usage


Time in milliseconds to wait for the public IP server to respond


0 to disable timeout


The URL of the public IP detection server to use


Specify whether to use IPv6 for the public IP detection server


Set the location to use


Must be URI encoded (e.g., a whitespace must be encoded as "+")


Time in milliseconds to wait for the weather server to respond


0 to disable timeout


The output weather format to use


Must be URI encoded


Specify whether window manager plugins should be detected on supported platforms


Show all active users in one line


Show only the current user


The name of the player to use for the Media and Player modules


Linux only


Set the OpenGL context creation library to use


Set the shell program to execute the command text


Set the parameter to use when starting the shell


If set to an empty string, it will be ignored


Set the module key to display


Set the command text to execute


Set the symbol to be printed by the Colors module


Set the number of white spaces to print before the symbol


Set the block width in spaces


Set the start range of colors in the blocks to print


Display colors 0-15 in the blocks. (16 colors)
Display colors 0-7 in the blocks. (8 colors)
Only works for `--colors-symbol block`.
Must be in range 0-15
See also `--colors-range-end`


Set the end range of colors in the blocks to print


Display colors 0-15 in the blocks. (16 colors)
Display colors 0-7 in the blocks. (8 colors)
Only works for `--colors-symbol block`.
Must be in range 0-15
See also `--colors-range-start`

General module

--<module>-format format

Set the format string to use for a specific module
See <https://github.com/fastfetch-cli/fastfetch/wiki/Format-String-Guide>
For help about a specific format string, use "fastfetch -h <module>-format"

--<module>-key key

Set the key to use for a specific module.
For modules that print multiple lines, the string is parsed
as a format string with the index as the first character

--<module>-key-color color

Override the global "--color-keys" option for a specific module

--<module>-key-icon string

Set the icon to be displayed by "--key-type icon"

--<module>-output-color color

Override the global "--color-output" option for a specific module

--<module>-key-width num

Override the global "--key-width" option for a specific module

--<module>-percent-green num

Threshold for percentage color ranges
Values less than percent-green will be shown in green

--<module>-percent-yellow num

Threshold for percentage color ranges
Values greater than percent-green and less than percent-yellow will be shown in yellow
Values greater than percent-yellow will be shown in red

--<module>-percent-type num

Set the percentage output type


0 to use global `--percent-type` value
1 for percentage number
2 for multi-color bar
3 for both
6 for bar only
9 for colored number
10 for monochrome bar

--<module>-temp-green num

Threshold for temperature color ranges
Values less than temp-green will be shown in green

--<module>-temp-yellow num

Threshold for temperature color ranges
Values greater than temp-green and less than temp-yellow will be shown in yellow
Values greater than temp-yellow will be shown in red

EXAMPLES

Basic Usage

fastfetch

fastfetch --logo arch

Custom structure

fastfetch --structure title:os:kernel:uptime:memory

Generate a config file

fastfetch --gen-config

Use a preset

fastfetch --config neofetch

Config File Example

// ~/.config/fastfetch/config.jsonc
{

"$schema": "https://github.com/fastfetch-cli/fastfetch/raw/dev/doc/json_schema.json",
"logo": {
"type": "auto",
"source": "arch"
},
"display": {
"separator": ": ",
"color": {
"keys": "blue",
"title": "red"
},
"key": {
"width": 12
}
},
"modules": [
"title",
"separator",
"os",
"kernel",
"uptime",
{
"type": "memory",
"format": "{used}/{total} ({used_percent}%)"
}
] }

SEE ALSO

neofetch(1)

BUGS

Please report bugs to: https://github.com/fastfetch-cli/fastfetch/issues

AUTHORS

Fastfetch is developed by a team of contributors on GitHub. Visit https://github.com/fastfetch-cli/fastfetch for more information.

Jun 06 2025 Fastfetch 2.45.0