FASTFETCH(1)                General Commands Manual               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:

              o default: Default human-readable format

              o 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.

fastfetch 2.61.0                 28 March 2026                    FASTFETCH(1)