Provided by: fastfetch_2.55.1+dfsg-1_amd64 
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
-h, --help [command]
Display this help message or help for a specific command
-v, --version
Show the full version of fastfetch
--version-raw
Display the raw version string (major.minor.patch)
--list-config-paths
List search paths for config files
--list-data-paths
List search paths for presets and logos
--list-logos
List available logos
--list-modules
List available modules
--list-presets
List presets that fastfetch knows about
Presets can be loaded with "--config <preset-name>"
--list-features
List the supported features that fastfetch was compiled with
Mainly for development
--print-logos
Display available logos
--print-structure
Display the default structure
--format enum
Set output format
-j, --json [bool]
Enable or disable JSON output
Shortcut for `--format json`
--dynamic-interval num
Keep fastfetch open and update the output every <num> milliseconds
0 (default) to disable the behavior; don't work with --json
Config
-c, --config 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
--gen-config [path]
Generate a minimal config file at the specified path
Defaults to "~/.config/fastfetch/config.jsonc". Will print the generated config if <path> is "-"
--gen-config-full [path]
Generate a full config file with all optional options at the specified path
Defaults to "~/.config/fastfetch/config.jsonc". Will print the generated config if <path> is "-"
--gen-config-force [path]
Generate a config file at the specified path, overwriting any existing file
Defaults to "~/.config/fastfetch/config.jsonc"
General
--thread [bool]
Use separate threads for HTTP requests
--wmi-timeout num
Set the timeout (ms) for WMI queries
Windows only
--processing-timeout num
Set the timeout (ms) when waiting for child processes
--ds-force-drm [enum]
Specify whether only DRM should be used to detect displays
Use this option if you encounter problems with other detection methods.
Linux only
--detect-version [bool]
Specify whether to detect and display versions of terminal, shell, editor, and others
Mainly for benchmarking
Logo
-l, --logo logo
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
--logo-type enum
Set the type of the logo specified in "--logo"
See also https://github.com/fastfetch-cli/fastfetch/wiki/Logo-options
--logo-width num
Set the width of the logo (in characters) if it is an image
Required for iTerm image protocol
--logo-height num
Set the height of the logo (in characters) if it is an image
Required for iTerm image protocol
--logo-preserve-aspect-ratio [bool]
Specify whether the logo should fill the specified width and height as much as possible without
stretching
Supported by iTerm image protocol only
--logo-color-[1-9] color
Override a color in the logo
See `-h color` for the list of available colors
--logo-padding num
Set the padding on the left and right sides of the logo
--logo-padding-left num
Set the padding on the left side of the logo
--logo-padding-right num
Set the padding on the right side of the logo
--logo-padding-top num
Set the padding at the top of the logo
--logo-print-remaining [bool]
Specify whether to print the remaining logo if it has more lines than modules to display
--logo-position enum
Set the position where the logo should be displayed
--logo-recache [bool]
If true, regenerate the image logo cache
--file path
Short for --logo-type file --logo <path>
See "--help logo-type" for more info
--file-raw path
Short for --logo-type file-raw --logo <path>
See "--help logo-type" for more info
--data data
Short for --logo-type data --logo <data>
See "--help logo-type" for more info
--data-raw data
Short for --logo-type data-raw --logo <data>
See "--help logo-type" for more info
--raw path
Short for --logo-type raw --logo <path>
See "--help logo-type" for more info
--sixel path
Short for --logo-type sixel --logo <path>
See "--help logo-type" for more info
--kitty path
Short for --logo-type kitty --logo <path>
See "--help logo-type" for more info
--kitty-direct path
Short for --logo-type kitty-direct --logo <path>
See "--help logo-type" for more info
--kitty-icat path
Short for --logo-type kitty-icat --logo <path>
See "--help logo-type" for more info
--iterm path
Short for --logo-type iterm --logo <path>
See "--help logo-type" for more info
--chafa path
Short for --logo-type chafa --logo <path>
See "--help logo-type" for more info
--chafa-fg-only [bool]
Produce character-cell output using foreground colors only
See chafa document for detail
--chafa-symbols str
Specify character symbols to employ in final output
See chafa document for detail
--chafa-canvas-mode enum
Determine how colors are used in the output
This value maps the int value of enum ChafaCanvasMode. See chafa document for detail
--chafa-color-space enum
Set color space used for quantization
This value maps the int value of enum ChafaColorSpace. See chafa document for detail
--chafa-dither-mode enum
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
-s, --structure structure
Set the structure of the fetch
Must be a colon-separated list of keys. Use "fastfetch --list-modules" to see available options
--stat [bool]
Show time usage (in ms) for individual modules
--pipe [bool]
Disable colors
Auto-detected based on isatty(1) by default
--color color
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>
--color-keys color
Set the color of the keys
Doesn't affect Title, Separator, and Colors modules. See `-h color` for the list of available
colors
--color-title color
Set the color of the title
See `-h color` for the list of available colors
--color-output color
Set the color of module output
See `-h color` for the list of available colors
--color-separator color
Set the color of the key-value separator
See `-h color` for the list of available colors
--duration-abbreviation [bool]
Specify whether to abbreviate duration values
If true, the output will be in the form of "1h 2m" instead of "1 hour, 2 mins"
--duration-space-before-unit enum
Specify whether to put a space before the unit in duration values
--key-width num
Align the width of keys to <num> characters
--key-padding-left num
Set the left padding of keys to <num> characters
--key-type enum
Specify whether to show an icon before string keys
--bright-color [bool]
Specify whether keys, title, and ASCII logo should be printed in bright color
--separator str
Set the separator between key and value
--show-errors [bool]
Print errors when they occur
--disable-linewrap [bool]
Specify whether to disable line wrap during execution
--hide-cursor [bool]
Specify whether to hide the cursor during execution
--percent-type num
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
--percent-ndigits num
Set the number of digits to keep after the decimal point when formatting percentage numbers
--percent-color-green color
Set color used for the green state of percentage bars and numbers
See `-h color` for the list of available colors
--percent-color-yellow color
Set color used for the yellow state of percentage bars and numbers
See `-h color` for the list of available colors
--percent-color-red color
Set color used for the red state of percentage bars and numbers
See `-h color` for the list of available colors
--percent-space-before-unit enum
Specify whether to put a space before the percentage symbol
--percent-width num
Specify the width of the percentage number, in number of characters
This option affects only percentage numbers, not bars
--bar-char-elapsed str
Set the character to use in the elapsed part of percentage bars
--bar-char-total str
Set the character to use in the total part of percentage bars
--bar-border-left string
Set the string to use at the left border of percentage bars
--bar-border-right string
Set the string to use at the right border of percentage bars
--bar-border-left-elapsed string
If both bar-border-left-elapsed and bar-border-right-elapsed are set, the border will be used as
parts of bar content
--bar-border-right-elapsed string
If both bar-border-left-elapsed and bar-border-right-elapsed are set, the border will be used as
parts of bar content
--bar-color-elapsed color
Set the color to use in the elapsed part of percentage bars
By default, auto selected by percent-color-{green,yellow,red}
--bar-color-total color
Set the color to use in the total part of percentage bars
--bar-color-border color
Set the color to use in the borders of percentage bars
--bar-width num
Set the width of percentage bars in characters
--no-buffer [bool]
Specify whether the stdout application buffer should be disabled
--size-ndigits num
Set the number of digits to keep after the decimal point when formatting sizes
--size-binary-prefix enum
Set the binary prefix to use when formatting sizes
--size-max-prefix enum
Set the largest binary prefix to use when formatting sizes
--size-space-before-unit enum
Specify whether to put a space before the unit
--freq-ndigits num
Set the number of digits to keep after the decimal point when printing CPU/GPU frequency in GHz
--freq-space-before-unit enum
Specify whether to put a space before the unit
--fraction-ndigits num
Set the number of digits to keep after the decimal point when printing ordinary fraction numbers
If negative, the number of digits will be automatically determined based on the value
--fraction-trailing-zeros enum
Set when to keep trailing zeros
--temp-unit enum
Set the temperature unit
--temp-ndigits num
Set the number of digits to keep after the decimal point when printing temperature
--temp-color-green color
Set color used for the green state of temperature values
See `-h color` for the list of available colors
--temp-color-yellow color
Set color used for the yellow state of temperature values
See `-h color` for the list of available colors
--temp-color-red color
Set color used for the red state of temperature values
See `-h color` for the list of available colors
--temp-space-before-unit enum
Specify whether to put a space before the unit
EXAMPLES
Basic Usage
fastfetch
Use a specific logo
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.
Fastfetch 2.55.1 Nov 17 2025 FASTFETCH(1)