FASTFETCH(1) FASTFETCH FASTFETCH(1)
fastfetch - A fast and feature-rich system information tool similar
to neofetch
fastfetch [OPTIONS...]
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.
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
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.
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 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
-h, --help [command]
Show this help message or help for a specific command
-v, --version
Show the full Fastfetch version
--version-raw
Show 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 available presets
Presets can be loaded with "--config <preset-name>"
--list-features
List the supported features that fastfetch was compiled with
Mainly for development
--print-logos
Show available logos
--print-structure
Show the default structure
--format enum
Set the output format
-j, --json [bool]
Enable or disable JSON output
Shortcut for `--format json`
--dynamic-interval num
Keep Fastfetch running and refresh the output every <num>
milliseconds
Set to 0 (default) to disable this behavior; does not work
with --json
-c, --config config
Specify the config file or preset to load
The file is searched in the order shown by "fastfetch --list-
config-paths". Use "-" to read config from stdin, or "none" to
disable further config loading. See also
https://github.com/fastfetch-cli/fastfetch/wiki/Configuration
for details
--gen-config [path]
Generate a minimal config file at the specified path
Defaults to "~/.config/fastfetch/config.jsonc". Prints the
generated config if <path> is "-"
--gen-config-full [path]
Generate a full config file with all optional settings at the
specified path
Defaults to "~/.config/fastfetch/config.jsonc". Prints 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"
--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 display detection should use DRM only
Use this option if you encounter problems with other
detection methods.
Linux only
--detect-version [bool]
Specify whether to detect and display versions for terminal,
shell, editor, and others
Mainly for benchmarking
-l, --logo logo
Set the logo source. Use "none" to disable logo output
Use either a built-in logo name 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 logo specified by "--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 remaining logo lines when the logo
is taller than the module list
--logo-position enum
Set the display position of the logo
--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 the Chafa documentation for details
--chafa-symbols str
Specify character symbols to employ in final output
See the Chafa documentation for details
--chafa-canvas-mode enum
Determine how colors are used in the output
This value maps to the integer value of enum ChafaCanvasMode.
See the Chafa documentation for details
--chafa-color-space enum
Set the color space used for quantization
This value maps to the integer value of enum ChafaColorSpace.
See the Chafa documentation for details
--chafa-dither-mode enum
Set the output dithering mode (no effect with 24-bit color)
This value maps to the integer value of enum ChafaDitherMode.
See the Chafa documentation for details
-s, --structure structure
Set the structure of the fetch
Must be a colon-separated list of module keys. Use "fastfetch
--list-modules" to see available options
--structure-disabled structure
Disable specific modules in the structure
Must be a colon-separated list of keys
--stat [bool]
Show execution time (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, output is shown as "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 style
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 decimal places to use when formatting
percentages
--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 characters
This option affects only percentage numbers, not bars
--bar-char-elapsed str
Set the character used for the elapsed part of percentage
bars
--bar-char-total str
Set the character used for 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 is used as part of the bar content
--bar-border-right-elapsed string
If both bar-border-left-elapsed and bar-border-right-elapsed
are set, the border is used as part of the bar content
--bar-color-elapsed color
Set the color used for the elapsed part of percentage bars
By default, this is auto-selected by percent-
color-{green,yellow,red}
--bar-color-total color
Set the color used for the total part of percentage bars
--bar-color-border color
Set the color used for percentage bar borders
--bar-width num
Set the width of percentage bars in characters
--no-buffer [bool]
Specify whether stdout buffering should be disabled
--size-ndigits num
Set the number of decimal places to use 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 decimal places to use 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 decimal places to use when printing
fractional values
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 decimal places to use when printing
temperatures
--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
fastfetch
fastfetch --logo arch
fastfetch --structure title:os:kernel:uptime:memory
fastfetch --gen-config
fastfetch --config neofetch
// ~/.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}%)"
}
]
}
neofetch(1)
Please report bugs to: https://github.com/fastfetch-
cli/fastfetch/issues
Fastfetch is developed by a team of contributors on GitHub. Visit
https://github.com/fastfetch-cli/fastfetch for more information.
Fastfetch 2.63.1 May 25 2026 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
-h, --help [command]
Show this help message or help for a specific command
-v, --version
Show the full Fastfetch version
--version-raw
Show 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 available presets
Presets can be loaded with "--config <preset-name>"
--list-features
List the supported features that fastfetch was compiled with
Mainly for development
--print-logos
Show available logos
--print-structure
Show the default structure
--format enum
Set the output format
-j, --json [bool]
Enable or disable JSON output
Shortcut for `--format json`
--dynamic-interval num
Keep Fastfetch running and refresh the output every <num>
milliseconds
Set to 0 (default) to disable this behavior; does not work
with --json
Config
-c, --config config
Specify the config file or preset to load
The file is searched in the order shown by "fastfetch --list-
config-paths". Use "-" to read config from stdin, or "none" to
disable further config loading. See also
https://github.com/fastfetch-cli/fastfetch/wiki/Configuration
for details
--gen-config [path]
Generate a minimal config file at the specified path
Defaults to "~/.config/fastfetch/config.jsonc". Prints the
generated config if <path> is "-"
--gen-config-full [path]
Generate a full config file with all optional settings at the
specified path
Defaults to "~/.config/fastfetch/config.jsonc". Prints 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 display detection should use DRM only
Use this option if you encounter problems with other
detection methods.
Linux only
--detect-version [bool]
Specify whether to detect and display versions for terminal,
shell, editor, and others
Mainly for benchmarking
Logo
-l, --logo logo
Set the logo source. Use "none" to disable logo output
Use either a built-in logo name 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 logo specified by "--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 remaining logo lines when the logo
is taller than the module list
--logo-position enum
Set the display position of the logo
--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 the Chafa documentation for details
--chafa-symbols str
Specify character symbols to employ in final output
See the Chafa documentation for details
--chafa-canvas-mode enum
Determine how colors are used in the output
This value maps to the integer value of enum ChafaCanvasMode.
See the Chafa documentation for details
--chafa-color-space enum
Set the color space used for quantization
This value maps to the integer value of enum ChafaColorSpace.
See the Chafa documentation for details
--chafa-dither-mode enum
Set the output dithering mode (no effect with 24-bit color)
This value maps to the integer value of enum ChafaDitherMode.
See the Chafa documentation for details
Display
-s, --structure structure
Set the structure of the fetch
Must be a colon-separated list of module keys. Use "fastfetch
--list-modules" to see available options
--structure-disabled structure
Disable specific modules in the structure
Must be a colon-separated list of keys
--stat [bool]
Show execution time (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, output is shown as "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 style
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 decimal places to use when formatting
percentages
--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 characters
This option affects only percentage numbers, not bars
--bar-char-elapsed str
Set the character used for the elapsed part of percentage
bars
--bar-char-total str
Set the character used for 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 is used as part of the bar content
--bar-border-right-elapsed string
If both bar-border-left-elapsed and bar-border-right-elapsed
are set, the border is used as part of the bar content
--bar-color-elapsed color
Set the color used for the elapsed part of percentage bars
By default, this is auto-selected by percent-
color-{green,yellow,red}
--bar-color-total color
Set the color used for the total part of percentage bars
--bar-color-border color
Set the color used for percentage bar borders
--bar-width num
Set the width of percentage bars in characters
--no-buffer [bool]
Specify whether stdout buffering should be disabled
--size-ndigits num
Set the number of decimal places to use 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 decimal places to use 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 decimal places to use when printing
fractional values
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 decimal places to use when printing
temperatures
--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.63.1 May 25 2026 FASTFETCH(1)