FASTFETCH(1) General Commands Manual FASTFETCH(1)

# [NAME](#NAME)

fastfetch - a fast and customizable system information tool similar to neofetch

# [SYNOPSIS](#SYNOPSIS)

**fastfetch** *\[options...]*

# [DESCRIPTION](#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](#EXIT_STATUS)

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

# [OPTIONS](#OPTIONS)

## [Informative Options](#Informative_Options)

[**-h, --help *\[command\]***](#h,)

Display help information for all available options or for a specific command

[**-v, --version**](#v,)

Display the version of fastfetch

[**--version-raw**](#version)

Display the raw version string (major.minor.patch)

[**--list-config-paths**](#list)

List search paths for configuration files

[**--list-data-paths**](#list~2)

List search paths for presets and logos

[**--list-logos**](#list~3)

List available logos that can be loaded with *--logo*

[**--list-modules**](#list~4)

List all available modules

[**--list-presets**](#list~5)

List available presets that can be loaded with *--config*

[**--list-features**](#list~6)

List the features that fastfetch was compiled with (mainly for development)

[**--print-logos**](#print)

Display all available logos

[**--print-structure**](#print~2)

Display the default structure

[**--format *<type>***](#format)

Set the output format. Available options are:

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

## [Config Options](#Config_Options)

[**-c, --config *<config>***](#c,)

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\]***](#gen)

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\]***](#gen~2)

Same as **--gen-config**, but overwrites any existing file at the destination path.

## [Logo Options](#Logo_Options)

[**-l, --logo *<logo>***](#l,)

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>***](#logo)

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>***](#logo~2)

Set the width of the logo in characters (for image logos)

[**--logo-height *<height>***](#logo~3)

Set the height of the logo in characters (for image logos)

[**--logo-color-\[1-9\] *<color>***](#logo~4)

Override specific colors in the logo

## [Display Options](#Display_Options)

[**-s, --structure *<structure>***](#s,)

Set the structure of the fetch (a colon-separated list of module names)

[**--color *<color>***](#color)

Set the color of keys and title. See **--help color** for available colors.

[**--color-keys *<color>***](#color~2)

Set the color of keys only

[**--color-title *<color>***](#color~3)

Set the color of the title only

[**--separator *<string>***](#separator)

Set the separator between key and value (default: ": ")

[**--key-width *<num>***](#key)

Align the width of keys to *<num>* characters

[**--show-errors**](#show)

Display errors when they occur (default: false)

[**--pipe**](#pipe)

Disable colors (automatically detected based on whether stdout is a terminal)

To list all available options including module-specific options, use **--help**.

# [CONFIGURATION](#CONFIGURATION)

## [Fetch Structure](#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](#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](#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](#EXAMPLES)

[Basic usage:](#Basic)

**fastfetch**

[Use a specific logo:](#Use)

**fastfetch --logo arch**

[Custom structure:](#Custom)

**fastfetch --structure title:os:kernel:uptime:memory**

[Generate a config file:](#Generate)

**fastfetch --gen-config**

[Use a preset:](#Use~2)

**fastfetch --config neofetch**

# [SEE ALSO](#SEE_ALSO)

[**neofetch**(1)](/man/os/fastfetch/neofetch.1)

# [BUGS](#BUGS)

Please report bugs to: *https://github.com/fastfetch-cli/fastfetch/issues*

# [AUTHORS](#AUTHORS)

Fastfetch is developed by a team of contributors on GitHub. Visit *https://github.com/fastfetch-cli/fastfetch* for more information.

14 October 2026 fastfetch 2.70.0

---

Document: fastfetch(1) from fastfetch 2.70.0-r0 (Chainguard OS)
Source: https://github.com/fastfetch-cli/fastfetch