FASTFETCH(1)

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):

    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"

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

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.