Official plugins for xfetch live in this repository. Each plugin is a standalone executable that communicates with the core binary over stdin/stdout using the JSON plugin protocol.
Keeping plugins outside the core repository allows the plugin ecosystem to evolve independently while preserving the same installation and runtime model.
From the default remote repository:
xfetch plugin install animate-logo
By default, xfetch plugin install <name> fetches plugins from
https://github.com/xfetch-cli/plugins.git.
| Plugin | Description |
|---|---|
animate-logo |
Animated ASCII logos with sweep, wave, rainbow, sparkle, breathing, and frame modes. |
banner-text |
Emits text lines from a file or literal argument; works with image logos. |
chocolatey |
Counts packages installed via Chocolatey (Windows package manager). |
docker |
Displays Docker container statistics using the local Docker CLI. |
github-stats |
Displays GitHub user statistics such as stars, repos, pull requests, and followers. |
display-resolution |
Displays monitor resolution and refresh rate. |
music-player |
Displays the currently playing track from MPD and/or Spotify. |
temperature |
CPU/SoC temperature module, reading the kernel thermal zones (Linux). |
theme-detection |
Detects and displays current GTK and KDE Plasma theme settings. |
theme-manager |
Browse, search, install, and inspect xfetch themes from the remote registry. |
timezone |
Displays current time, date, and timezone information. |
user-info |
Displays user account information (name, UID, GID, home, shell, groups). |
weather |
Displays current weather conditions. |
wasm-crypto |
Live crypto spot prices (BTC, ETH, ...) fetched through the sandboxed HTTP host call. |
wasm-ip-geo |
Public IP, location, network and timezone from ipapi.co (Python component). |
wasm-pacman |
Repository vs AUR package counts from the local pacman database (Go). |
wasm-proc |
Load average, memory usage and uptime read from /proc (freestanding C). |
The wasm-* plugins ship sandboxed WebAssembly artifacts and
manifest-declared capabilities; see
xfetch/docs/WASM.md.
See Platform Compatibility for which plugins work on Linux, macOS and Windows.
This repository is a Cargo workspace, so you can build every plugin together:
cargo test --workspace
Official plugin implementations are grouped under the repository folder
plugins/<name>, which keeps the root clean as the ecosystem grows.
The shared wire protocol used by the core and plugins is maintained in xfetch-cli/api.
- Linux/macOS:
~/.config/xfetch/plugins/ - Windows:
%APPDATA%/xfetch/plugins/
See docs/README.md for the protocol specification, naming conventions, testing workflow, and contribution guidelines for new plugins.