NAME

fastfetch - a fast and customizable 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, *BSD, macOS, Haiku, and Windows 7 or newer.

EXIT STATUS

Fastfetch returns zero on successful execution. Any errors result in a non-zero exit code.

OPTIONS

Informative Options

-h, --help [command]: Display help information for all available options or for a specific command
-v, --version: Display the version of fastfetch
--version-raw: Display the raw version string (major.minor.patch)
--list-config-paths: List search paths for configuration files
--list-data-paths: List search paths for presets and logos
--list-logos: List available logos that can be loaded with --logo
--list-modules: List all available modules
--list-presets: List available presets that can be loaded with --config
--list-features: List the features that fastfetch was compiled with (mainly for development)
--print-logos: Display all available logos
--print-structure: Display the default structure
--format <type>: Set the output format. Available options are:

default: Default human-readable format
json: JSON format for machine processing

Config Options

-c, --config <config>: Use the specified config file or preset. Specify none to disable further config loading. See the CONFIGURATION section for details on config files.
--gen-config [path]: Generate a config file with options specified on the command line. If path is not specified, it defaults to ~/.config/fastfetch/config.jsonc. If path is "-", the configuration will be written to stdout.
--gen-config-force [path]: Same as --gen-config, but overwrites any existing file at the destination path.

Logo Options

-l, --logo <logo>: Set the logo to display. Can be the name of a built-in logo or a path to an image file. Use none to disable the logo.
--logo-type <type>: Set the type of the logo specified with --logo. Available types include auto, builtin, file, sixel, kitty, and others. See --help logo-type for details.
--logo-width <width>: Set the width of the logo in characters (for image logos)
--logo-height <height>: Set the height of the logo in characters (for image logos)
--logo-color-[1-9] <color>: Override specific colors in the logo

Display Options

-s, --structure <structure>: Set the structure of the fetch (a colon-separated list of module names)
--color <color>: Set the color of keys and title. See --help color for available colors.
--color-keys <color>: Set the color of keys only
--color-title <color>: Set the color of the title only
--separator <string>: Set the separator between key and value (default: ": ")
--key-width <num>: Align the width of keys to <num> characters
--show-errors: Display errors when they occur (default: false)
--pipe: Disable colors (automatically detected based on whether stdout is a terminal)
To list all available options including module-specific options, use --help.

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 for configuration files. JSONC is JSON with support for comments (// and /* */). Configuration 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):