Skip to content

theme-manager.md

Latest commit

 

History

History
194 lines (146 loc) · 5.61 KB

theme-manager.md

File metadata and controls

194 lines (146 loc) · 5.61 KB
Raw

Theme Manager Plugin

Das theme-manager Plugin ermoglicht das Durchsuchen, Suchen, Inspizieren und Installieren von xfetch Themes aus der entfernten Theme-Registry.

Ubersicht

Im Gegensatz zu anderen info-Plugins, die Systemdaten anzeigen, interagiert theme-manager mit der Theme-Registry unter github.com/xfetch-cli/themes, um Theme-Dateien zu finden und herunterzuladen.

Eigenschaft Wert
Art info_provider
Binar xfetch-plugin-theme-manager
Abhangigkeiten curl CLI (fur entfernte Registry)

Installation

xfetch plugin install theme-manager

Aktionen

Das Verhalten des Plugins wird durch das Feld action in den Plugin-Argumenten gesteuert.

list (Standard)

Zeigt alle verfugbaren Themes aus der Registry an:

{
    "info_plugins": [
        { "plugin": "theme-manager" }
    ],
    "modules": ["plugin:theme-manager"]
}

search

Filtert Themes nach Name, Beschreibung, Autor oder Tags:

{
    "info_plugins": [
        {
            "plugin": "theme-manager",
            "args": {
                "action": "search",
                "query": "dark"
            }
        }
    ],
    "modules": ["plugin:theme-manager"]
}

info

Zeigt detaillierte Informationen zu einem bestimmten Theme an:

{
    "info_plugins": [
        {
            "plugin": "theme-manager",
            "args": {
                "action": "info",
                "name": "dracula"
            }
        }
    ],
    "modules": ["plugin:theme-manager"]
}

install

Ladt eine Theme-Datei aus der Registry herunter und speichert sie unter ~/.config/xfetch/themes/<name>.jsonc:

{
    "info_plugins": [
        {
            "plugin": "theme-manager",
            "args": {
                "action": "install",
                "name": "dracula"
            }
        }
    ],
    "modules": ["plugin:theme-manager"]
}

Nach der Installation aktivieren Sie das Theme mit xfetch theme set <name> oder indem Sie "theme": "<name>" zu Ihrer config.jsonc hinzufugen.

Argumente

Feld Typ Erforderlich Beschreibung
action string Nein Einer von list (Standard), search, info, install
name string Fur info und install Theme-Kennung (z. B. dracula, nord)
query string Fur search Suchbegriff, der mit Name, Beschreibung, Autor oder Tags ubereinstimmt
registry string Nein Benutzerdefinierte Registry-URL oder lokaler Dateipfad

Ausgabebeispiele

Ausgabe von list

Theme Manager -- 17 themes available

  dracula  xscriptor  section  (#dark #dracula #popular)
       Dark magenta, red, and cyan palette inspired by the Dracula color scheme.

  nord  xscriptor  section  (#light #nord #arctic #minimal)
       Cool blue and arctic cyan palette based on the Nord color scheme.

  catppuccin-mocha  xscriptor  section  (#dark #catppuccin #mocha #pastel)
       Warm mocha pastel palette from the Catppuccin Mocha color scheme.

  retro-pacman  xscriptor  pacman  (#retro #pacman #arcade #game)
       Classic Pac-Man arcade style with game-inspired header icons.

  berlin  xscriptor  default  (#monochrome #minimal #no-icons #no-colors)
       Monochrome theme with no colors and no icons.

  tree-compact  xscriptor  tree  (#tree #hierarchical #compact #nested)
       Hierarchical tree layout with a cool blue-green color scheme.

Ausgabe von install

Theme 'dracula' installed successfully.
  Path: /home/user/.config/xfetch/themes/dracula.jsonc
  Author: xscriptor
  Layout: section

Activate with: xfetch theme set dracula
Or add to config.jsonc: "theme": "dracula"

Registry

Die Standard-Registry-URL lautet:

https://raw.githubusercontent.com/xfetch-cli/themes/main/index.json

Die Registry ist eine JSON-Datei, die Metadaten zu allen verfugbaren Themes enthalt. Jeder Theme-Eintrag umfasst:

Feld Beschreibung
name Theme-Kennung verwendet in "theme": "<name>"
author Theme-Ersteller
version Semantische Version
description Kurzbeschreibung des Themes
layout Standard-Layout des Themes
palette_style Standard-Paletten-Anzeigestil
tags Durchsuchbare Schlagworter
source URL zum Herunterladen der Theme-JSONC-Datei

Benutzerdefinierte Registry

Sie konnen eine selbst gehostete oder lokale Registry verwenden:

{
    "plugin": "theme-manager",
    "args": {
        "registry": "/home/user/my-themes/index.json"
    }
}

Lokale Pfade (beginnend mit / oder ~) werden direkt vom Dateisystem gelesen. Entfernte URLs werden uber curl abgerufen.

Funktionsweise

  1. xfetch sendet eine JSON-Anfrage mit kind: "info_provider" und den konfigurierten Argumenten.
  2. Das Plugin liest die Registry-Datei (lokaler Pfad oder entfernte URL uber curl).
  3. Basierend auf dem Feld action filtert oder zeigt das Plugin Theme-Informationen an.
  4. Bei install wird die Theme-JSONC-Datei heruntergeladen und im Themes-Verzeichnis gespeichert.
  5. Das Plugin gibt die formatierten Zeilen als JSON-Antwort zuruck.
  6. xfetch zeigt sie unter dem Modul-Schlussel plugin:theme-manager an.

Hinweise

  • Erfordert curl fur den Zugriff auf die entfernte Registry. Lokale Dateipfade funktionieren ohne curl.
  • Fur Operationen mit der entfernten Registry wird eine Netzwerkverbindung benotigt.
  • Das Argument registry ermoglicht die Verwendung einer benutzerdefinierten oder gespiegelten Registry.
  • Nach der Installation eines Themes aktivieren Sie es mit dem Kernbefehl xfetch theme set oder durch direktes Bearbeiten der config.jsonc.