theme-manager

Browses, searches, and installs themes from a remote or local registry.

  • Kind: info_provider
  • Binary: xfetch-plugin-theme-manager
  • Dependencies: curl in PATH (for remote registries)
  • Default registry: https://raw.githubusercontent.com/xfetch-cli/themes/main/index.json

Configuration

{
    "info_plugins": [{
        "plugin": "theme-manager",
        "args": {
            "action": "list",
            "name": "dracula",
            "query": "dark",
            "registry": "https://example.com/themes.json"
        }
    }]
}

Arguments

FieldRequiredDefaultDescription
actionNo"list"list, search, info, or install
nameFor info/installTheme name
queryFor searchSearch term (matches name, description, author, tags)
registryNoxfetch-cli/themesRegistry URL (HTTP or local path with / or ~)

Actions

ActionDescription
listLists all available themes from the registry
searchFilters themes matching the query
infoShows detailed info about a specific theme
installDownloads a theme to ~/.config/xfetch/themes/<name>.jsonc

After installing a theme, activate it with xfetch theme set <name> or add "theme": "<name>" to your config.jsonc.