DocsErste Schritte

Erste Schritte mit xfetch

xfetch ist ein plattformunabhangiges Systeminformations-Tool geschrieben in Rust. Es zeigt Details zu Ihrem Betriebssystem, Ihrer Hardware, Software und Ihrem Netzwerk in einer anpassbaren Terminalausgabe mit ASCII-Kunst oder Bildern an.

Schnellinstallation

Linux und macOS

curl -fsSL https://raw.githubusercontent.com/xfetch-cli/xfetch/main/install.sh | bash

Dies installiert xfetch nach ~/.local/bin/, generiert eine erste Konfiguration unter ~/.config/xfetch/config.jsonc mit xfetch --gen-config und fugt optional das Binarbildverzeichnis zu Ihrem PATH hinzu.

So passen Sie den Installationspfad an:

curl -fsSL https://raw.githubusercontent.com/xfetch-cli/xfetch/main/install.sh | bash -s -- --prefix ~/myapps

Flags:

FlagBeschreibung
--localDas lokale Repository anstelle von Klonen verwenden
--prefix <dir>Installationspraefix (Standard: ~/.local)
--bin-dir <dir>Binarbildverzeichnis (Standard: ~/.local/bin)
--config-dir <dir>Konfigurationsverzeichnis (Standard: ~/.config/xfetch)
--no-modify-pathDas Binardir nicht zum PATH in der Shell-RC hinzufugen
--yesAutomatische Bestatigung aller Eingabeaufforderungen
--skip-configKopieren der Standardkonfiguration uberspringen
--no-cargo-installEin vorgebautes Binary anstelle von Cargo-Build verwenden
--install-depsFehlende Systemabhangigkeiten automatisch installieren

Vorgebautes Binary (keine Rust-Toolchain nötig):

curl -fsSL https://raw.githubusercontent.com/xfetch-cli/xfetch/main/install-prebuilt.sh | bash

Der Prebuilt-Installer akzeptiert --version <v>, --prefix <dir>, --bin-dir <dir> und --no-modify-path.

Windows (PowerShell)

Vorgebautes Binary (keine Rust-Toolchain nötig):

irm https://raw.githubusercontent.com/xfetch-cli/xfetch/main/install-prebuilt.ps1 | iex

Aus dem Quellcode:

irm https://raw.githubusercontent.com/xfetch-cli/xfetch/main/install.ps1 | iex

Manueller Build aus dem Quellcode

git clone https://github.com/xfetch-cli/xfetch.git
cd xfetch
cargo build --release
cp target/release/xfetch ~/.local/bin/

Arch Linux (AUR)

xfetch ist im AUR als xfetch-core-bin (vorgebautes Binary) und xfetch-git (Build aus dem Quellcode) verpackt. Mit einem AUR-Helfer wie yay:

yay -S xfetch-core-bin   # vorgebautes Binary
yay -S xfetch-git        # Build aus dem Quellcode

Ohne AUR-Helfer:

git clone https://aur.archlinux.org/xfetch-core-bin.git
cd xfetch-core-bin
makepkg -si

Paketmanager

xfetch ist über Homebrew verfügbar:

brew tap xfetch-cli/tap
brew install xfetch

Von crates.io:

cargo install xfetch-cli

Erster Start

Nach der Installation fuhren Sie einfach aus:

xfetch

Sie sollten Systeminformationen zusammen mit einem ASCII-Logo sehen, das dieser Struktur ahnelt:

__  __                               OS: Arch Linux x86_64
  \ \/ /                             Kernel: 6.6.87.2-arch1-1
   \  /                              Uptime: 2 hours, 15 mins
   /  \                              Packages: 657 (pacman)
  /_/\_\                             WM: Hyprland
 /____/linux                         Shell: zsh
---------BEGIN PUBLIC KEY----------   CPU: Intel(R) Core(TM) i5-7400 @ 3.00GHz (4)
...                                  GPU: NVIDIA GeForce RTX 3060
----------END PUBLIC KEY-----------   Memory: 3.10 GiB / 7.74 GiB (40%)
                                     Disk: 120.5 GiB / 256 GiB (47%) - ext4
                                     Battery: 85% [Charging]

Befehlszeilen-Schnittstelle

Globale Flags

FlagBeschreibung
-c, --config <PATH>Pfad zu einer benutzerdefinierten Konfigurationsdatei (JSONC-Format)
--gen-configStandardkonfigurationsdatei am Standard-Konfigurationspfad generieren
--layout <name>Layout fur --gen-config (Standard: section)
--logo <id>Logo-Id (z. B. arch, windows-11) fur --gen-config (erfordert Netzwerkzugriff auf den Logo-Katalog)
--clean-cacheDie Cache-Datenbank leeren
--benchmarkZeitinformationen fur parallele Proben anzeigen
--daemonDen animierten Daemon starten
--daemon-stopDen Daemon stoppen
--no-daemon-liveDen Live-Statistik-Daemon deaktivieren, auch wenn er in der Konfiguration aktiviert ist
--daemon-live-stopDen laufenden Live-Statistik-Daemon stoppen
--daemon-live-reloadHot-Reload im Live-Statistik-Daemon erzwingen

Plugin-Unterbefehle

xfetch plugin install <name>      Ein Plugin installieren (lokaler Pfad oder aus Repository)
xfetch plugin list                Alle installierten Plugins auflisten
xfetch plugin remove <name>       Ein installiertes Plugin entfernen

Erweiterungs-Unterbefehle

xfetch extension install <name>   Eine Erweiterung installieren (lokaler Pfad oder aus Repository)
xfetch extension list             Alle installierten Erweiterungen auflisten
xfetch extension remove <name>    Eine installierte Erweiterung entfernen

Theme-Unterbefehle

xfetch theme list                 Installierte Themes auflisten
xfetch theme set <name>           Ein Theme aktivieren (setzt das Feld "theme" in config.jsonc)
xfetch theme remove <name>        Eine Theme-Datei entfernen
xfetch theme export <name>        Aktuelle visuelle Konfiguration als Theme-Datei exportieren

Effekt-Unterbefehle

xfetch effects install <name>     Ein Intro-Effekt installieren
xfetch effects list               Installierte Effekte auflisten
xfetch effects remove <name>      Einen Effekt entfernen

Update-Unterbefehl

xfetch update                     Nach neuerer Version suchen und installieren
xfetch update --check             Nur melden; Exit 1 bei neuerer Version
xfetch update --prebuilt          In-Place-Prebuilt-Update erzwingen (Unix)
xfetch update --bin-dir <dir>     Verzeichnis des Binaries mit --prebuilt
xfetch update --yes               Bestätigung überspringen

Nutzungsbeispiele

# Mit Standardkonfiguration ausfuhren
xfetch

# Mit einer benutzerdefinierten Konfiguration ausfuhren
xfetch --config ~/.config/xfetch/my-config.jsonc

# Eine Standardkonfiguration generieren
xfetch --gen-config

# Im Benchmark-Modus ausfuhren
xfetch --benchmark

# Zwischengespeicherte Daten loschen
xfetch --clean-cache

# Ein Plugin installieren
xfetch plugin install animate-logo

# Installierte Plugins auflisten
xfetch plugin list

# Ein Plugin entfernen
xfetch plugin remove docker

# Nach einer neueren Version suchen
xfetch update --check

# Auf die neueste Version aktualisieren
xfetch update

Umgebungsvariablen

VariableBeschreibung
XFETCH_PLUGIN_REPODie Standard-Plugin-Git-Repository-URL uberschreiben
XFETCH_PLUGIN_DEV_DIRDen Suchpfad fur das Plugin-Entwicklungsverzeichnis uberschreiben
XFETCH_LOGOS_URLDie URL des Logo-Katalogs uberschreiben (verwendet von --logo mit --gen-config)
XFETCH_EFFECT_REPODie URL des Effekt-Git-Repositorys uberschreiben
XFETCH_WASM_LOG_LEVELLog-Schwelle fuer WebAssembly-Gaeste: off, error, warn (Standard), info, debug
XFETCH_UPDATE_APIUeberschreibt den GitHub-API-Endpunkt fuer xfetch update (Mirrors)
GH_TOKEN / GITHUB_TOKENGitHub-Token für xfetch update, um das API-Rate-Limit zu erhöhen
CARGO_NET_GIT_FETCH_WITH_CLIGit CLI zum Abrufen verwenden (wird bei Plugin-Installation automatisch gesetzt)

Aktualisierung

xfetch kann selbst nach neueren Releases suchen und sie installieren:

xfetch update --check   # nur melden; Exit 1 bei neuerer Version
xfetch update           # neueste Version installieren
xfetch update --yes     # Bestätigung überspringen

Der Befehl erkennt zuerst, wie das Binary installiert wurde:

  • Prebuilt-Installationen (install-prebuilt.sh, meist ~/.local/bin): Das Release-Asset wird geladen, gegen SHA256SUMS geprueft, entpackt und atomar ueber die aktuelle Datei verschoben. Ein einzelnes xfetch.bak behaelt das vorherige Binary.
  • cargo install-Binaries: Aktualisierung ueber cargo install xfetch-cli --force --locked.
  • Paketmanager und lokale Builds: werden nie ersetzt; der Befehl zeigt den passenden Befehl an.

xfetch update --prebuilt --bin-dir <dir> erzwingt das In-Place-Update von <dir>/xfetch (nur Unix). Unter Windows gibt es den Prebuilt-Pfad noch nicht; nutze cargo install xfetch-cli --force.

Deinstallation

Schnelldeinstallation

curl -fsSL https://raw.githubusercontent.com/xfetch-cli/xfetch/main/uninstall.sh | bash

Manuelle Deinstallation

rm ~/.local/bin/xfetch
rm -rf ~/.config/xfetch

Entfernen Sie anschlieend alle PATH-Anderungen aus Ihrer Shell-RC-Datei, falls der Installer sie hinzugefugt hat.