WeiG qB WebUI: Einsteiger-Anleitung für qBittorrents alternative Weboberfläche

1. ZIP entpacken

Lade die neueste stabile Version weig-qb-webui.zip herunter und entpacke sie. Der Ordner ist bereits richtig benannt:

weig-qb-webui/
├── public/
├── private/
├── VERSION
└── GIT_SHA

Der gesamte Ordner weig-qb-webui ist das WebUI-Stammverzeichnis. Nicht nur public oder private kopieren.

2. An einen festen Ort verschieben

Zum Beispiel:

Windows: D:\weig-qb-webui
Linux:   /opt/weig-qb-webui

Diesen Pfad trägst du anschließend in qBittorrent ein.

3. In qBittorrent aktivieren

Öffne qBittorrent:

Werkzeuge → Optionen … → WebUI

Das sind die aktuellen Begriffe der offiziellen deutschen qBittorrent-Oberfläche. Danach:

1. Alternative Weboberfläche verwenden aktivieren.
2. Speicherort der Dateien: suchen.
3. Den Pfad zum Ordner weig-qb-webui eintragen.

Windows-Beispiel:

D:\weig-qb-webui

Linux-Beispiel:

/opt/weig-qb-webui

4. Mit OK speichern.
5. Die qBittorrent-WebUI neu laden. Falls die alte Ansicht im Cache bleibt, Ctrl + F5 verwenden.

Pfad prüfen: Im eingetragenen Ordner müssen public, private, VERSION usw. direkt sichtbar sein.

Docker: qBittorrent läuft im Container. Deshalb muss in qBittorrent normalerweise ein container-sichtbarer Pfad eingetragen werden, nicht der Host-Pfad.

./install.sh

Standardpfad der WebUI:

~/.local/share/weig-qb-webui

Bei Ausführung als root typischerweise:

/root/.local/share/weig-qb-webui

Host und Container

• Host: das Linux-/NAS-System, auf dem Docker läuft.
• Container: die isolierte Umgebung, in der qBittorrent läuft.

Beispiel:

Host:      /root/qbittorrent/config
   ↓ gemountet als
Container: /config

Docker Compose:

volumes:
  - /root/qbittorrent/config:/config

Liegt die WebUI auf dem Host unter:

/root/qbittorrent/config/weig-qb-webui

muss qBittorrent bei Speicherort der Dateien: verwenden:

/config/weig-qb-webui

Ein qBittorrent-Container

curl -fsSL https://weigefenxiang.github.io/WeiG-qB-WebUI/downloads/dev/install.sh -o install.sh && sh install.sh -configure

Der Installer versucht Container und /config-Mount automatisch zu erkennen.

Container anzeigen

sh install.sh --list-containers

Oder:

docker ps

Einen Container ausdrücklich wählen:

sh install.sh --container=qbittorrent -configure

Bei mehreren qBittorrent-Containern wählt der Installer nicht automatisch einen aus.

Fall 3: mehrere qBittorrent-Container

Laufen zum Beispiel qbittorrent und qbittorrent-test, lass dir zuerst die Container anzeigen und wähle einen ausdrücklich aus. Der Installer rät nicht:

sh install.sh --list-containers
sh install.sh --container=qbittorrent -configure
sh install.sh --container=qbittorrent-test -configure

Host-Pfad für /config angeben

sh install.sh --config-root=/root/qbittorrent/config -configure

Synology-Beispiel:

sh install.sh --config-root=/volume1/docker/qbittorrent -configure

Anderes NAS:

sh install.sh --config-root=/share/Container/qbittorrent -configure

WebUI-Zielpfad festlegen

sh install.sh --container=qbittorrent -o /config/weig-qb-webui -configure

Fall 6: mehrere bestehende WebUI-Verzeichnisse zusammen aktualisieren

Bei mehreren qBittorrent-Instanzen kannst du -o mehrfach angeben. Das Paket wird nur einmal geladen und geprüft; erst wenn alle Ziele vorbereitet sind, beginnt der Wechsel. Unter ~/.config/weig-qb-webui/backups/ bleiben die letzten drei Backups pro Ziel separat erhalten.

sh install.sh -dev \
  -o /root/qbittorrent/config/weig-qb-webui \
  -o /root/qbittorrent3/config/weig-qb-webui

Bei mehreren Zielen -configure weglassen. Jede Instanz nutzt weiterhin ihren eingestellten WebUI-Pfad. Alle Optionen zeigt sh install.sh -help.

Pfade nach der Installation prüfen

Nach der Installation zeigt das Skript etwa Folgendes an: Der erste Pfad bezeichnet den Installationsort auf dem Host, der zweite den Container-Pfad für Files location in qBittorrent.

Host install path: /root/qbittorrent/config/weig-qb-webui
qBittorrent Root Folder: /config/weig-qb-webui

C:\Users\<Benutzername>\AppData\Local\weig-qb-webui

PowerShell-Parameternamen unterscheiden nicht zwischen Groß- und Kleinschreibung.

• Ohne -dev wird der geprüfte stabile GitHub-Release von main installiert; mit -dev der aktuelle Entwicklungsstand von dev anhand seines exakten Git-SHA.
• -o steht für output und kann unter Linux mehrfach angegeben werden, um bestehende WebUI-Verzeichnisse mit einem verifizierten Download zu aktualisieren.
• Backups liegen unter ~/.config/weig-qb-webui/backups/; pro Installationsziel werden die letzten drei getrennt vorgehalten.
• -configure aktiviert in qBittorrent Use alternative WebUI und setzt Files location. Es ist nur für ein einzelnes Ziel zulässig.
• -rollback stellt das jüngste Installer-Backup des ausgewählten Ziels wieder her; mehrere explizite Ziele können mit wiederholtem -o zurückgesetzt werden.
• -uninstall -purge entfernt WebUI und Backups samt Rollback-Status nur dieses Ziels. Backups anderer Ziele bleiben erhalten; leere gemeinsame Statusverzeichnisse werden aufgeräumt.
• Wer später -rollback nutzen möchte, lässt bei der Deinstallation -purge weg.
• Mit -version 1.2.0 lässt sich ein bestimmter GitHub-Release installieren. Existiert dieser nicht, gibt es einen Fehler – kein automatischer Wechsel zu latest oder dev.
• -help zeigt die aktuell unterstützten Optionen.
• Bei mehreren Docker-Containern zunächst --list-containers aufrufen und mit --container=NAME den gewünschten auswählen. Alternativ --config-root=/path angeben.

Bestimmte Version und Installationsverzeichnis

Linux-Beispiel:

sh install.sh -version 1.2.0 -o /opt/weig-qb-webui -configure

Windows-Beispiel:

powershell -ExecutionPolicy Bypass -File .\install.ps1 -version 1.2.0 -o D:\weig-qb-webui -configure

Rollback

Rollback:

sh install.sh -rollback

powershell -ExecutionPolicy Bypass -File .\install.ps1 -rollback

Empfohlen ist standardmäßig die vollständige Deinstallation ohne Installer-Backups: WebUI entfernen, die passende Alternative-WebUI-Konfiguration deaktivieren, die installer-eigenen Backups / den Rollback-Status dieses Ziels bereinigen und anschließend das heruntergeladene Installationsskript im aktuellen Verzeichnis löschen.

Linux / NAS

sh install.sh -uninstall -configure -purge && rm -f -- ./install.sh

Bei einem eigenen Installationspfad -o /path/to/weig-qb-webui ergänzen.

Docker

Ein Container / automatische Erkennung:

sh install.sh -uninstall -configure -purge && rm -f -- ./install.sh

Mehrere Container:

sh install.sh -uninstall -configure -purge --container=qbittorrent && rm -f -- ./install.sh

Bei Verwendung von --config-root:

sh install.sh -uninstall -configure -purge --config-root=/path/to/qbittorrent/config && rm -f -- ./install.sh

Windows PowerShell

powershell -ExecutionPolicy Bypass -File .\install.ps1 -uninstall -configure -purge; if ($LASTEXITCODE -eq 0) { Remove-Item .\install.ps1 -Force }

Bei einem eigenen Installationspfad -o D:\weig-qb-webui ergänzen.

-purge entfernt nur Backups des aktuellen Deinstallationsziels und lässt andere Installationen unangetastet. Ist das gemeinsame Statusverzeichnis danach leer, wird unter Linux auch ~/.config/weig-qb-webui (für root: /root/.config/weig-qb-webui) bzw. unter Windows %APPDATA%\weig-qb-webui entfernt.

Sollen Backups für ein späteres -rollback erhalten bleiben, -purge einfach weglassen.