Change the fastfetch logo#
Fastfetch detects your OS and picks the matching logo automatically. To choose one yourself, pass its name to -l (short for --logo). Names are not case-sensitive, and many logos answer to several names, which the gallery lists as aliases.
fastfetch -l archfastfetch -l "Windows 11"To make it permanent, set the logo in your config file. The simplest form is a string:
{
"$schema": "https://github.com/fastfetch-cli/fastfetch/raw/dev/doc/json_schema.json",
"logo": "arch"
}If the logo doesn't change, the name is probably misspelled: fastfetch then falls back to your own logo without a word. Run it with --show-errors to see Logo: Failed to resolve logo source: … (more causes).
List all logos#
The gallery above shows all 545 in color. In the terminal, fastfetch --list-logos prints every name, and fastfetch --print-logos draws them all.
Small logos and alternative designs#
78 logos are compact "small" versions, such as arch_small or macos_small. Use --logo-type small (or the shortcut -l small) to get the small version of the detected logo:
fastfetch --logo-type small46 more are alternative designs of an existing logo, usually ending in 2 or _old, for example alpine2 or AerynOS_old. Request them by name.
Make the logo spin (2.71.0+)#
fastfetch 2.71.0 added a spin logo type. It draws a built-in logo, or a text logo of your own, as a 3D slab that turns a little every time the output refreshes. The turning needs --watch (or --dynamic-interval), which keeps fastfetch running and redraws it:
fastfetch --logo-type spin --watch 1turns every second; Ctrl+C to stopfastfetch -l arch --logo-type spin -w 1a chosen logo, short flagsWithout --watch, fastfetch draws a single frame at --logo-spin-angle and exits, so --logo-spin-angle 30 --logo-spin-tilt 20 gives you a still, tilted logo. The source can be auto (your detected OS), any built-in logo name, or a text file in the usual $1…$9 logo syntax.
| Option | Config key | Range | What it does |
|---|---|---|---|
--logo-spin-speed-per-frame | logo.spin.speed.perFrame | -360 to 360 | Degrees per drawn frame. 10 is used when no speed is set. Negative turns the other way. |
--logo-spin-speed-per-round | logo.spin.speed.perRound | -3600 to 3600 | Seconds per full turn, measured on the clock, so a slow refresh doesn't slow the logo down. Wins over perFrame when both are set. |
--logo-spin-tilt | logo.spin.tilt | -80 to 80 | Camera tilt in degrees. |
--logo-spin-angle | logo.spin.angle | 0 to 360 | Angle of the first frame, and the only frame drawn without --watch. |
{
"$schema": "https://github.com/fastfetch-cli/fastfetch/raw/dev/doc/json_schema.json",
"logo": {
"type": "spin",
"source": "arch",
"spin": { "speed": { "perRound": 6 }, "tilt": 20 }
}
}There is no config key for the refresh interval, so start it with fastfetch -w 1. A value outside a range stops fastfetch with Error: --logo-spin-tilt must be a number between -80 and 80 or, in a config, JsonConfig Error (logo.spin): Property 'logo.spin.tilt' must be a number between -80 and 80 (exit 221, or 477 on Windows). --watch can't be combined with JSON output, and a spinning greeting in ~/.bashrc never returns to the prompt, so keep it for screenshots and dashboards. On an older fastfetch the type doesn't exist: 2.70.0 answers Error: unknown --logo-type value: spin, or JsonConfig Error (logo.type): Invalid enum string in a config.
✓ tested We ran all of this with the official 2.71.0 release on Linux, macOS and Windows on 2026-11-06: the still frame at angle 0 is identical to the built-in logo, angle and tilt give a turned frame, a text file works as the source, the config above runs without errors, and with a 400 ms refresh the logo kept redrawing until we stopped it.
Change the logo colors#
Each built-in logo uses up to nine color slots, written $1 to $9 in its source file. Override any slot with --logo-color-N, using a color name or an ANSI code:
fastfetch --logo-color-1 red --logo-color-2 greenExact colors work too: --logo-color-1 '#cba6f7'. We checked that fastfetch passes that hex color to the terminal unchanged. The color themes set logo colors from real palettes.
{
"logo": {
"source": "arch",
"color": { "1": "magenta", "2": "cyan" }
}
}Hide the logo#
fastfetch -l none prints no logo but keeps the key colors from your detected logo. In a config file, "logo": null disables it.