Logo Catalog for xfetch

ASCII logos of Linux distributions, macOS and Windows, consumed by xfetch.

Menu

• Features
• Structure
• Usage
• Related Repos

Features

• 127+ logos: Linux distributions (Arch, Debian/Ubuntu, Fedora/RHEL, openSUSE, Void, Gentoo, ...), macOS (version-specific from Cheetah to Sequoia) and Windows (3.x to 11).
• Standard sizing: each logo is a rectangular block of ~12 rows, world-readable UTF-8 text.
• Machine-readable index: logos.json maps every distro id, aliases, family, colors and ANSI codes to its file.
• Resolution chain: exact ID → ID_LIKE → generic logo (used by xfetch --gen-config).

Structure

logos/
├── defaults/          # canonical logo per OS/distro
│   ├── linux/         # one file per distribution
│   ├── macos/         # version-specific macOS logos
│   └── windows/       # version-specific Windows logos
└── logos.json         # the index (contract between catalog and xfetch)

Usage

xfetch fetches the index and the raw art over HTTPS:

xfetch --gen-config                    # embed the detected distro's logo
xfetch --gen-config --logo arch        # force a specific logo
xfetch --gen-config --logo windows-11  # any catalog id works

The catalog base URL can be overridden for testing forks:

XFETCH_LOGOS_URL=https://raw.githubusercontent.com/<user>/logos/main xfetch --gen-config

Related Repos

• XFetch — the system info tool that consumes this catalog
• XFetch API — shared crates for the ecosystem
• XFetch Configs — curated presets and examples
• XFetch Plugins — official plugins

X

& &