FASTFETCH(1)

📦
version 2.70.0 · 13 versions
, in arch rolling

💖 FASTFETCH(1) — the fastfetch manual, but make it make sense 💖

okay bestie, this is FASTFETCH(1), the manual page for fastfetch — part 1 of 2, so grab a snack 🍓. It's giving "terminal glow-up" and honestly? iconic.

🌸 NAME 🌸

fastfetch — a fast and feature-rich system information tool, similar to neofetch. yes, that neofetch. we're the spiritual successor and we ate 💅

🦋 SYNOPSIS 🦋

fastfetch [OPTIONS...]

✨ DESCRIPTION ✨

Fastfetch is a tool for displaying your system information in a way that's actually visually appealing 😍. It's written primarily in C, and it's lowkey obsessed with performance and customizability while giving you functionality similar to neofetch.

It supports Linux, Android, FreeBSD, macOS, and Windows 7 or newer. periodt, it runs everywhere 🫶

🎀 CONFIGURATION 🎀

🧚 Fetch Structure

The structure defines which modules to display and in what order — it's literally the lineup for your fetch's main character moment.

It's a list of module names separated by colons (:). For example:

title:separator:os:kernel:uptime

To see all available modules, use --list-modules 👑

📁 Config Files

Fastfetch uses JSONC (that's JSON with Comments, so yes, you can leave little notes for yourself 💜) for configuration files. These files must have the .jsonc extension — no exceptions, she's strict.

You can generate a default config file using --gen-config. By default, the config file gets saved at ~/.config/fastfetch/config.jsonc.

The configuration/preset files are searched in these locations, in this exact 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 also ships with several built-in presets — list them with --list-presets 🎁

🪄 JSON Schema

There's a JSON schema available for editor intelligence when you're editing the config file (yes, autocomplete in your config, we love to see it). Just add this line at the beginning of your config file:

"$schema": "https://github.com/fastfetch-cli/fastfetch/raw/dev/doc/json_schema.json"

💅 OPTIONS 💅

First, the house rules 🏠✨ — options are parsed in a case-insensitive manner. Like, --logo-type and --LOGO-TYPE are treated identically. no cap.

Arguments in square brackets are optional. Optional boolean arguments default to 'true' when you specify them without a value.

For more detailed information about a specific option, use: fastfetch -h <option_name_without_dashes>

And here's the slay part: 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 one specific command
  • -v, --version — show the full Fastfetch version
  • --version-raw — show the raw version string (major.minor.patch), no extra frills
  • --list-config-paths — list the search paths for config files
  • --list-data-paths — list the search paths for presets and logos
  • --list-logos — list all available logos
  • --list-modules — list all available modules
  • --list-presets — list all 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 the 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
  • -w, --watch [num] — alias of dynamic-interval, but the value is in seconds instead of milliseconds. If you don't give it a value, it defaults to 1 second ⏱️

⚙️ Config

  • -c, --config config — specify the config file or preset to load
  • --gen-config [path] — interactively generate a config file at the specified path
    • opens an interactive configuration UI when run in a terminal. Falls back to non-interactive generation when env-var $NO_COLOR is set or stdin/stdout is not a TTY. Defaults to "~/.config/fastfetch/config.jsonc". Prints the generated config if <path> is "-"

🛠️ 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
  • -l, --logo logo — set the logo source. Use "none" to disable logo output entirely
  • --logo-type enum — set the type of logo specified by "--logo"
  • --logo-width num — set the width of the logo (in characters) if it's an image
    • required for iTerm image protocol
  • --logo-height num — set the height of the logo (in characters) if it's 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-padding-bottom num — set the padding at the bottom of the logo
    • only used with "--logo-position top"
  • --logo-print-remaining [bool] — specify whether to print the remaining logo lines when the logo is taller than the module list
  • --logo-position enum — set the display position of the logo
  • --logo-cache [enum] — specify how the image logo cache is used
    • see "--help logo-animation-frame" for the one case where a cached rendering can outlive the image type that produced it
  • --logo-animation-frame [num] — select which frame of an animated image logo to render
    • animated kitty graphics only, and only if the image source is animated; 1 or higher renders that frame as a still image, 0 plays the animation
    • a selected frame is cached exactly like the first frame is, sharing its entries; the frame number is recorded next to them, so changing this option re-renders
    • that record is per cache directory, not per image type: switching --logo-type between two types that both have a cached rendering here, and asking for a different frame, can pair one type's rendering with the other's frame number ⚠️
    • run "--logo-cache regen" after such a switch
  • --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
  • --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 — sets the color of the title, periodt. Peep the color list with -h color ✨
  • --color-output color — sets the color of your module output (the actual deets, not the keys). Color list lives at -h color 🎨
  • --color-separator color — sets the color of that lil key-value separator. Yup, -h color again bestie 💅
  • --duration-abbreviation [bool] — says whether duration values get abbreviated. If true, you get 1h 2m instead of 1 hour, 2 mins — lowkey so much cleaner ⏱️
  • --duration-space-before-unit enum — controls whether there's a space before the unit in duration values 🫶
  • --key-width num — aligns the width of keys to num characters. Everything all neat and lined up, we love to see it 📏
  • --key-padding-left num — sets the left padding of keys to num characters 🌸
  • --key-type enum — decides whether to show an icon before string keys 👑
  • --key-language [enum] — picks the language used for module keys. Leave it empty and it auto-detects based on your system locale; unsupported locales fall back to English 🌈
  • --bright-color [bool] — says whether keys, title, and the ASCII logo should print in bright color. Main character brightness only 💖
  • --separator str — sets the separator between key and value ✨
  • --show-errors [bool] — prints errors when they occur. Not me wanting to know when things break 🙈
  • --disable-linewrap [bool] — says whether to disable line wrap during execution 📐
  • --hide-cursor [bool] — says whether to hide the cursor during execution. Cursor? Never heard of her 💀
  • --percent-type num — sets the percentage output style, and the options are giving variety:
    • 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 — sets how many decimal places to use when formatting percentages 🔢
  • --percent-color-green color — sets the color used for the green state of percentage bars and numbers. -h color for the list 🟢
  • --percent-color-yellow color — sets the color used for the yellow state of percentage bars and numbers. -h color, you know the drill 🟡
  • --percent-color-red color — sets the color used for the red state of percentage bars and numbers. -h color 🔴
  • --percent-space-before-unit enum — says whether to put a space before the percentage symbol 💫
  • --percent-width num — sets the width of the percentage number, in characters. Heads up: this only affects percentage numbers, not bars 🎀
  • --bar-char-elapsed str — sets the character used for the elapsed part of percentage bars 🦋
  • --bar-char-total str — sets the character used for the total part of percentage bars 🌸
  • --bar-border-left string — sets the string used at the left border of percentage bars ⬅️
  • --bar-border-right string — sets the string used 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 — same deal: 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 — sets 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 — sets the color used for the total part of percentage bars 🖌️
  • --bar-color-border color — sets the color used for percentage bar borders 🖍️
  • --bar-width num — sets the width of percentage bars in characters 📊
  • --no-buffer [bool] — says whether stdout buffering should be disabled ⚡
  • --size-ndigits num — sets how many decimal places to use when formatting sizes 🔢
  • --size-binary-prefix enum — sets the binary prefix to use when formatting sizes 💾
  • --size-max-prefix enum — sets the largest binary prefix to use when formatting sizes 📦
  • --size-space-before-unit enum — says whether to put a space before the unit 🫧
  • --freq-ndigits num — sets how many decimal places to use when printing CPU/GPU frequency in GHz 🖥️
  • --freq-space-before-unit enum — says whether to put a space before the unit 🌬️
  • --fraction-ndigits num — sets how many decimal places to use when printing fractional values. If it's negative, the number of digits gets automatically determined based on the value 🤯
  • --fraction-trailing-zeros enum — sets when to keep trailing zeros 🎯
  • --temp-unit enum — sets the temperature unit 🌡️
  • --temp-ndigits num — sets how many decimal places to use when printing temperatures 🔥
  • --temp-color-green color — sets the color used for the green state of temperature values. -h color 🟩
  • --temp-color-yellow color — sets the color used for the yellow state of temperature values. -h color 🟨
  • --temp-color-red color — sets the color used for the red state of temperature values. -h color 🟥
  • --temp-space-before-unit enum — says whether to put a space before the unit 💗

🌟 EXAMPLES 🌟

💫 Basic Usage

fastfetch
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 🌈

💀 BUGS 💀

Found a bug? Please report bugs to: https://github.com/fastfetch-cli/fastfetch/issues — the maintainers genuinely wanna know, no gatekeeping 🫶

👑 AUTHORS 👑

Fastfetch is developed by a team of contributors on GitHub. Visit https://github.com/fastfetch-cli/fastfetch for more information. A whole team, being iconic together 💜

That's the whole page bestie — go flex that fetch output, you absolute legend. ✨

So yeah, this was Fastfetch 2.70.0, dated Oct 14 2026 — screenshot it, memorize it, live it, slay it 💅🎀🦋

📦 where this page comes from