Customization

Default ASCII Logo#

When no custom logo is specified, xfetch displays its built-in ASCII art:

__  __
  \ \/ /
   \  /
   /  \
  /_/\_\
 /____/linux
---------BEGIN PUBLIC KEY----------
MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMII
...
----------END PUBLIC KEY-----------

Custom ASCII Logo#

To use a custom ASCII logo, set the logo_path or ascii field:

{
    "logo_path": "~/.config/xfetch/logos/arch.txt"
}

ASCII logo files are plain text files. ANSI escape codes can be used for coloring:

\x1b[34m    /\            /\
\x1b[34m   /  \          /  \
\x1b[34m  /\   \        /   /\
\x1b[34m /  \   \      /   /  \
\x1b[34m/   /\   \    /   /\   \
\x1b[34m   /  \   \  /   /  \
\x1b[34m  /    \   \/   /    \
\x1b[34m /______\      /______\
\x1b[0m

Sample logos are included in the xfetch installation at ~/.config/xfetch/logos/:

ASCII Logo Options

{
    "ascii": "~/.config/xfetch/logos/arch.txt",
    "logo_color": "#00FF87",
    "logo_padding": 2
}

Image Logos#

xfetch can render PNG, JPG, and SVG images as logos using the viuer library. This requires terminal support for image display (iTerm2, Kitty, or Sixel-compatible terminals):

{
    "logo_path": "~/.config/xfetch/logos/my-logo.png"
}

Image rendering uses the terminal's native image protocol:

• iTerm2: inline image protocol
• Kitty: Kitty's native image protocol (high resolution)
• Sixel: Sixel graphics (compatible terminals like xterm, mlterm)

If the terminal does not support image display, xfetch falls back to ASCII.

Image Sizing and Positioning

Control image dimensions and spacing with these configuration fields:

{
    "logo_path": "~/.config/xfetch/images/my-image.png",
    "logo_width": 30,
    "logo_height": null,
    "logo_gap": 5
}

The auto-width calculation scales with your terminal: wider terminals get proportionally larger images.

ASCII Logo Fields

Kitty Terminal Image Rendering

In Kitty terminals, xfetch supports two rendering modes controlled by logo_kitty:

{
    "logo_kitty": true
}

Set logo_kitty: false if you experience layout issues with native Kitty rendering (e.g., text overlap or misalignment). The half-block fallback guarantees correct side-by-side layout at the cost of some image fidelity.

Configuration#

{
    "logo_animation": {
        "plugin": "animate-logo",
        "fps": 12,
        "duration_ms": 1200,
        "loop": false,
        "style": "sweep"
    }
}

Animation Styles#

Frame-Based Animation#

The frame style cycles through pre-defined ASCII frame sets. Frame sets are loaded from a file specified in frames_path:

{
    "logo_animation": {
        "plugin": "animate-logo",
        "style": "frame",
        "fps": 60,
        "duration_ms": 7500,
        "loop": true,
        "frames_path": "~/.config/xfetch/logos/frames.txt"
    }
}

The frames file format uses === as a separator between frame sets:

frame 1 line 1
frame 1 line 2

===

frame 2 line 1
frame 2 line 2

===

frame 3 line 1
frame 3 line 2

Default Icons#

If not specified in the configuration, xfetch uses built-in default icon mappings for all standard modules.

Available Colors#

Color Modes#

Color output can be disabled entirely:

{
    "show_colors": false
}

Keys#

By default xfetch renders each module as icon value. To display the module label as well, enable show_keys; use key_width to pad the labels to a fixed column count so values align vertically.

{
    "show_keys": true,
    "key_width": 12
}

Example with show_keys and key_width: 12:

cpu       : Apple M4 (10) @ 4.46 GHz
memory    : 10.88 GiB / 16.00 GiB (68%)
disk      : 152.80 GiB / 931.32 GiB (16%) - apfs

Palette Styles#

The palette displays 8 colors matching the ANSI standard palette: Black, Red, Green, Yellow, Blue, Magenta, Cyan, White.

Showcase Presets (23 examples)#

Located in configs/xfetch/presets/showcase/, these presets demonstrate various icon, color, and logo combinations:

Layout Presets (6 examples)#

Located in configs/xfetch/presets/layouts/:

Using Presets#

# Run with a specific preset
xfetch --config /path/to/presets/showcase/arch_compact_cyan.jsonc

Or copy a preset to use as your default:

cp configs/xfetch/presets/showcase/neon_hardware_compact.jsonc ~/.config/xfetch/config.jsonc