WeiG qB WebUI : guide débutant pour l’IU Web alternative de qBittorrent

1. Extraire l’archive

Téléchargez la dernière version stable weig-qb-webui.zip et décompressez l’archive. Le dossier porte déjà le bon nom :

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

Le dossier weig-qb-webui entier est la racine WebUI. Ne copiez pas uniquement public ou private.

2. Déplacer le dossier vers un emplacement permanent

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

C’est ce chemin qu’il faudra renseigner dans qBittorrent.

3. Activer dans qBittorrent

Ouvrez qBittorrent :

Outils → Options… → WebUI

Ce sont les termes de l’interface française officielle actuelle de qBittorrent. Ensuite :

1. Activez Utiliser l’IU Web alternative.
2. Repérez Emplacement des fichiers :.
3. Saisissez le chemin du dossier weig-qb-webui.

Exemple Windows :

D:\weig-qb-webui

Exemple Linux :

/opt/weig-qb-webui

4. Cliquez sur OK pour enregistrer.
5. Rechargez la page WebUI. Si l’ancienne interface reste en cache, essayez Ctrl + F5.

Vérification du chemin : public, private, VERSION et les autres fichiers doivent être directement visibles dans le dossier indiqué.

Docker : qBittorrent fonctionne dans un conteneur. Il faut donc généralement saisir le chemin visible depuis le conteneur, et non le chemin de l’hôte.

./install.sh

Répertoire WebUI par défaut :

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

Avec l’utilisateur root :

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

Hôte et conteneur

• Hôte : le système Linux/NAS qui exécute Docker.
• Conteneur : l’environnement dans lequel qBittorrent s’exécute.

Exemple :

Hôte :      /root/qbittorrent/config
   ↓ monté vers
Conteneur : /config

Docker Compose :

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

Si la WebUI est installée sur l’hôte dans :

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

alors Emplacement des fichiers : dans qBittorrent doit être :

/config/weig-qb-webui

Un seul conteneur qBittorrent

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

Le programme d’installation essaie de détecter automatiquement le conteneur et le montage /config.

Lister les conteneurs

sh install.sh --list-containers

Ou :

docker ps

Choisir explicitement un conteneur :

sh install.sh --container=qbittorrent -configure

S’il y a plusieurs conteneurs qBittorrent, le programme d’installation refuse d’en choisir un au hasard.

Cas 3 : plusieurs conteneurs qBittorrent

Si vous avez qbittorrent et qbittorrent-test, affichez les conteneurs puis sélectionnez celui à configurer : l’installateur ne choisit pas au hasard.

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

Indiquer le chemin hôte correspondant à /config

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

Synology :

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

Autre NAS :

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

Choisir le chemin WebUI

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

Cas 6 : mettre à jour plusieurs dossiers WebUI existants

Avec plusieurs instances qBittorrent, répétez -o pour indiquer chaque dossier. L’archive est téléchargée et vérifiée une seule fois ; le basculement commence après la préparation de toutes les cibles. Les trois dernières sauvegardes sont conservées séparément pour chacune dans ~/.config/weig-qb-webui/backups/.

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

N’utilisez pas -configure avec plusieurs cibles : chaque instance garde son chemin WebUI configuré. Lancez sh install.sh -help pour les options.

Vérifier les chemins après l’installation

Une fois l’installation terminée, le script affiche des chemins similaires à ceux-ci. Le premier correspond au dossier réel sur l’hôte ; le second est le chemin à renseigner dans Files location de qBittorrent, à l’intérieur du conteneur.

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

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

Les noms des paramètres PowerShell ne sont pas sensibles à la casse.

• Sans -dev, l’installateur utilise le GitHub Release stable et vérifié depuis main ; avec -dev, la version actuelle de dev à son SHA Git exact.
• -o signifie output. Sous Linux, répétez-le pour mettre à jour plusieurs dossiers WebUI existants avec une seule archive vérifiée.
• Les sauvegardes se trouvent dans ~/.config/weig-qb-webui/backups/ ; seules les trois plus récentes sont conservées par cible.
• -configure active Use alternative WebUI et définit Files location dans qBittorrent. Une seule cible à la fois.
• -rollback restaure la dernière sauvegarde de la cible choisie. Plusieurs -o permettent de revenir en arrière sur plusieurs cibles explicites.
• -uninstall -purge supprime le WebUI et les sauvegardes / l’état de retour arrière propres à la cible. Les autres installations ne sont pas touchées, et le dossier commun est supprimé s’il devient vide.
• Pour garder les sauvegardes en vue d’un futur -rollback, omettez -purge.
• -version 1.2.0 choisit un GitHub Release précis. S’il n’existe pas, l’installation échoue sans basculer vers latest ou dev.
• -help affiche les options actuellement disponibles.
• Avec plusieurs conteneurs Docker, consultez --list-containers puis ciblez-en un avec --container=NAME, ou utilisez --config-root=/path.

Version précise et répertoire d’installation

Linux :

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

Windows :

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

Retour arrière

Retour arrière :

sh install.sh -rollback

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

Par défaut, nous recommandons la désinstallation complète sans conserver les sauvegardes de l’installateur : suppression du WebUI, désactivation de l’interface alternative correspondant à la cible, purge des sauvegardes / de l’état de rollback appartenant à cette cible, puis suppression du script d’installation téléchargé dans le dossier courant.

Linux / NAS

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

Pour un répertoire personnalisé, ajoutez -o /path/to/weig-qb-webui.

Docker

Un seul conteneur / détection automatique :

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

Plusieurs conteneurs :

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

Avec --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 }

Pour un répertoire personnalisé, ajoutez -o D:\weig-qb-webui.

-purge ne supprime que les sauvegardes appartenant à la cible en cours de désinstallation et ne touche pas aux autres installations. Si le répertoire d’état partagé devient vide, ~/.config/weig-qb-webui sous Linux (root : /root/.config/weig-qb-webui) ou %APPDATA%\weig-qb-webui sous Windows est également supprimé.

Pour conserver les sauvegardes afin d’utiliser -rollback plus tard, retirez simplement -purge.