Themes

Das Theme-System trennt das visuelle Erscheinungsbild (Farben, Icons, Layout) von der Modulkonfiguration, sodass du das Aussehen wechseln kannst, ohne deine Moduleinrichtung anzutasten.

Architektur

Themes arbeiten auf der Konfigurationsebene, bevor eine Darstellung oder Plugin-Ausfuhrung erfolgt.

config.jsonc (theme: "dracula", modules: [...])
       |
       v
   Lade Standardkonfiguration
       |
       v
   Lade theme/<name>.jsonc
       |
       v
   Zusammenfuhrung: defaults <- theme <- config.jsonc
       |
       v
   Endgultige Konfiguration (vom Renderer verwendet)

Merge-Reihenfolge (letzter gewinnt)

Jede Ebene kann jedes visuelle Feld uberschreiben:

Ebene	Quelle	Inhalt
1. Standardwerte	Fest codiert in config.rs	Standard-Icons, Farben, Layout
2. Theme-Datei	themes/<name>.jsonc	colors, icons, layout, palette_style, logo_path, header_icons, footer_text, show_colors
3. Benutzerkonfiguration	config.jsonc	modules, info_plugins, sowie Uberschreibungen fur jedes visuelle Feld

Ein Feld in config.jsonc gewinnt immer gegenuber demselben Feld in der Theme-Datei.

Theme-Dateiformat

Eine Theme-Datei ist ein JSONC-Dokument, das nur visuelle Felder enthalt. Sie darf modules oder info_plugins nicht enthalten.

{
    "layout": "section",
    "show_colors": true,
    "palette_style": "circles",
    "colors": {
        "os": "Magenta",
        "cpu": "Red",
        "memory": "Yellow",
        "disk": "Cyan",
        "shell": "Green",
        "wm": "Blue"
    },
    "icons": {
        "os": "\uf17c",
        "cpu": "\uf2db",
        "memory": "\ue266",
        "disk": "\uf0a0",
        "shell": "\uf0e7",
        "wm": "\uf08e"
    },
    "logo_path": null,
    "header_icons": null,
    "footer_text": null
}

Unterstutzte Felder

Feld	Typ	Beschreibung
layout	string oder null	Name des Layout-Stils
colors	object	Modulspezifische Farbzuordnung
icons	object	Modulspezifische Icon-Zuordnung
palette_style	string oder null	Palettenanzeige: squares, circles, triangles, lines, dots
show_colors	boolean	ANSI-Farbausgabe aktivieren oder deaktivieren
logo_path	string oder null	Pfad zu einer Logo-Datei
header_icons	array oder null	Header-Icons fur Pac-Man-Layout
footer_text	string oder null	Footer-Text fur Pac-Man-Layout

Theme-Auflosung

Wenn xfetch eine Konfiguration mit theme: "dracula" ladet, durchsucht der Resolver in dieser Reihenfolge:

1. Direkter Pfad -- Wenn der Wert ein Dateipfad ist (enthalt / oder beginnt mit ~), wird er direkt geladen
2. Themes-Verzeichnis -- Suche nach <name>.jsonc in ~/.config/xfetch/themes/

Wenn das Theme nicht gefunden wird, wird die Konfiguration unverandert ohne das Theme geladen.

CLI-Befehle

# Installierte Themes auflisten
xfetch theme list

# Ein Theme aktivieren (setzt das Feld "theme" in config.jsonc)
xfetch theme set nord

# Eine Theme-Datei entfernen
xfetch theme remove nord

# Aktuelle visuelle Konfiguration als Theme-Datei exportieren
xfetch theme export my-theme

Exportverhalten

xfetch theme export <name> erfasst den aktuellen Laufzeit-Status (nach der Zusammenfuhrung) und schreibt ihn nach ~/.config/xfetch/themes/<name>.jsonc. Dies ermoglicht es, dein Aussehen zu teilen, ohne deine Modulliste offenzulegen.

Die exportierte Datei enthalt nur:

• layout
• colors
• icons
• palette_style
• header_icons
• footer_text
• logo_path
• show_colors

Abwartskompatibilitat

Das Theme-System ist vollstandig abwartskompatibel:

• Ohne theme-Feld: Alles funktioniert genau wie zuvor. Die Konfigurationsdatei enthalt alle visuellen Felder direkt.
• Vorhandene Konfigurationen: Konnen durch Exportieren migriert werden: xfetch theme export current, danach setze `"theme": "current"" und entferne die visuellen Felder aus der Hauptkonfiguration.
• Plugin-Konfigurationen: Plugin-Referenzen (info_plugins) bleiben ausschlieblich in config.jsonc, niemals in Theme-Dateien.

Verzeichnisstruktur

~/.config/xfetch/
    config.jsonc            # Module, Plugins und optionale Theme-Referenz
    themes/
        dracula.jsonc       # Theme-Dateien: Farben, Icons, Layout
        nord.jsonc
        catppuccin-mocha.jsonc
        retro-pacman.jsonc
        berlin.jsonc
        tree-compact.jsonc

Integrierte Themes

Das offizielle Theme-Repository befindet sich unter github.com/xfetch-cli/configs im Verzeichnis themes/:

Theme	Layout	Stil
dracula	section	Dunkle Magenta-, Rot- und Cyan-Palette
nord	section	Kühle Blau- und Arktis-Cyan-Palette
catppuccin-mocha	section	Warme Mokka-Pastell-Palette
retro-pacman	pacman	Klassischer Pac-Man-Arcade-Stil mit Header-Icons und Footer-Text
berlin	default	Monochrom: keine Farben, keine Icons
tree-compact	tree	Hierarchisches Baum-Layout

Implementierungsdetails

Konfigurationsladung (config.rs)

Die Zusammenfuhrung verwendet serde_json::Value Deep-Merge vor der Deserialisierung:

1. Parse config.jsonc als serde_json::Value
2. Deserialisiere zu Config, um das theme-Feld zu extrahieren
3. Wenn theme gesetzt ist, lade die Theme-Datei als serde_json::Value
4. Erstelle ein leeres Value und fuhre in der Reihenfolge zusammen: defaults -> theme -> config
5. Deserialisiere das zusammengefuhrte Ergebnis zu Config

Theme-Verwaltung (themes/mod.rs)

• list_themes() -- Durchsucht ~/.config/xfetch/themes/ nach *.jsonc-Dateien
• set_active_theme() -- Liest config.jsonc, setzt das theme-Feld, schreibt zuruck
• remove_theme() -- Loscht eine Theme-Datei aus dem Themes-Verzeichnis
• export_current_theme() -- Erstellt eine JSONC-Datei aus den visuellen Feldern der aktuellen Config