Plugin Theme Manager

El plugin theme-manager permite navegar, buscar, inspeccionar e instalar temas de xfetch desde el registro remoto de temas.

Descripción general

A diferencia de otros plugins info que muestran datos del sistema, theme-manager interactúa con el registro de temas en github.com/xfetch-cli/themes para descubrir y descargar archivos de tema.

Propiedad	Valor
Tipo	`info_provider`
Binario	`xfetch-plugin-theme-manager`
Dependencias	CLI `curl` (para el registro remoto)

Instalación

xfetch plugin install theme-manager

Acciones

El comportamiento del plugin se controla mediante el campo action en los argumentos del plugin.

list (predeterminado)

Muestra todos los temas disponibles del registro:

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

search

Filtra temas por nombre, descripcion, autor o etiquetas:

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

info

Muestra información detallada sobre un tema especifico:

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

install

Descarga un archivo de tema desde el registro y lo guarda en ~/.config/xfetch/themes/<nombre>.jsonc:

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

Después de la instalación, active el tema con xfetch theme set <nombre> o añadiendo "theme": "<nombre>" a su config.jsonc.

Argumentos

Campo	Tipo	Requerido	Descripcion
`action`	`string`	No	Uno de `list` (predeterminado), `search`, `info`, `install`
`name`	`string`	Para `info` y `install`	Identificador del tema (ej., `dracula`, `nord`)
`query`	`string`	Para `search`	Término de búsqueda que coincide con nombre, descripcion, autor o etiquetas
`registry`	`string`	No	URL de registro personalizada o ruta de archivo local

Ejemplos de salida

Salida de 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.

Salida de 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"

Registro

La URL del registro predeterminado es:

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

El registro es un archivo JSON que contiene metadatos de todos los temas disponibles. Cada entrada de tema incluye:

Campo	Descripcion
`name`	Identificador del tema usado en `"theme": "<nombre>"`
`author`	Creador del tema
`version`	Versión semántica
`description`	Descripción breve del tema
`layout`	Diseño predeterminado del tema
`palette_style`	Estilo de visualizacion de paleta predeterminado
`tags`	Palabras clave para busqueda
`source`	URL para descargar el archivo JSONC del tema

Registro personalizado

Puede usar un registro autogestionado o local:

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

Las rutas locales (que comienzan con / o ~) se leen directamente del sistema de archivos. Las URL remotas se obtienen mediante curl.

Cómo funciona

xfetch envia una solicitud JSON con kind: "info_provider" y los argumentos configurados.
El plugin lee el archivo de registro (ruta local o URL remota mediante curl).
Según el campo action, el plugin filtra o muestra informacion del tema.
Para install, el archivo JSONC del tema se descarga y guarda en el directorio de temas.
El plugin devuelve las lineas formateadas como una respuesta JSON.
xfetch las muestra bajo la clave de modulo plugin:theme-manager.

Notas

Requiere curl para acceder al registro remoto. Las rutas de archivo locales funcionan sin curl.
Se necesita conectividad de red para operaciones con el registro remoto.
El argumento registry permite apuntar a un registro personalizado o reflejado.
Despues de instalar un tema, actívelo usando el comando principal xfetch theme set o editando config.jsonc directamente.

FilesExpand file tree

theme-manager.md

Latest commit

History