Installer Bazarr sur Synology : sous-titres automatiques pour tout
Guide complet pour installer Bazarr en Docker sur NAS Synology. Connexion à Sonarr/Radarr, providers de sous-titres (OpenSubtitles, Addic7ed), profils par langue, sub-corrigés.
Ce guide a un but éducatif. Bazarr est un logiciel open source et légal qui sert à gérer automatiquement les sous-titres de votre bibliothèque multimédia. monratio.fr n'encourage en aucun cas le piratage ou le téléchargement illégal de contenus protégés par le droit d'auteur.
💬 Pourquoi Bazarr
Bazarr est le chaînon manquant de votre stack *arr. Sonarr télécharge vos séries, Radarr télécharge vos films, mais ni l'un ni l'autre ne s'occupe des sous-titres. Bazarr comble ce vide : il scanne en continu votre bibliothèque et complète automatiquement tous les sous-titres manquants.
Le problème sans Bazarr :
Avantage clé : multi-langues simultanées. Vous regardez en VO, votre conjoint(e) préfère la VOSTFR, votre mère ne comprend qu'en français doublé ? Bazarr peut récupérer plusieurs pistes de sous-titres par vidéo (par ex. français + anglais) pour que Plex/Jellyfin laisse le choix au lecteur.
Avant / Après Bazarr :
Comparaison rapide avec les alternatives :
Les solutions possibles :
Bazarr : subtitle manager pour Sonarr/Radarr, sync auto via API, support de 20+ providers (OpenSubtitles, Addic7ed, Subscene, Podnapisi…), profils multi-langues avec cutoff, hi/forced flags, post-processing (sync timing, encoding), WebSocket pour events temps réel. Remplace avantageusement Subliminal CLI et les scripts maison. Complément naturel du stack *arr.
Pourquoi Sonarr/Radarr ne gèrent pas les sous-titres ? Historiquement, les *arr se concentrent sur l'acquisition des fichiers vidéo. Les sous-titres sont un domaine à part : providers différents, logique de matching spécifique (une VF pour une VO, une VOSTFR avec un hash exact…). Bazarr est né de ce constat, développé par la même communauté.
Bazarr fait aussi du "sub-sync" : il peut recaler les sous-titres décalés de quelques secondes par rapport à la vidéo (algorithme basé sur la voice detection). Très utile quand un .srt trouvé en ligne est désynchronisé.
📋 Vérifier les prérequis
Bazarr ne fonctionne pas tout seul. Il dépend de Sonarr et/ou Radarr. On s'assure que tout est en place avant d'installer.
Prérequis #1 : Docker installé
- Ouvrez Centre de paquets sur votre Synology
- Vérifiez que "Container Manager" (DSM 7) ou "Docker" (DSM 6) est installé
- Sinon, cliquez Installer
Prérequis #2 : Sonarr et/ou Radarr déjà en place
Sans Sonarr ou Radarr, Bazarr ne sert à rien. Il a besoin de connaître votre bibliothèque pour chercher des sous-titres. Si vous n'avez pas encore installé ces outils :
Ordre d'installation recommandé :
Prérequis #3 : Dossier de stockage Bazarr
- Ouvrez File Station
- Allez dans docker/ (le même dossier que vos autres *arr)
- Créez un sous-dossier bazarr/
- Chemin final :
/volume1/docker/bazarr/
Prérequis #4 : Comptes sur les sites de sous-titres
Bazarr télécharge depuis des sites publics. Certains demandent un compte (gratuit ou payant) pour accéder à leur API.
Providers principaux à prévoir :
Prérequis : Container Manager (DSM 7), /volume1/docker/bazarr/ créé, Sonarr (port 8989) et/ou Radarr (port 7878) en route avec API Keys accessibles. Compte OpenSubtitles.com (REST API v1 depuis 2023, l'ancienne API XML-RPC est déprecée). Comptes optionnels : Addic7ed, Subscene, Podnapisi, utilisables sans creds pour la plupart.
OpenSubtitles.com vs OpenSubtitles.org : attention, ce sont deux sites différents ! Depuis 2023, le .com est l'officiel avec la nouvelle API REST. Le .org existe encore mais son API XML-RPC est dépréciée. Dans Bazarr, utilisez le provider "OpenSubtitles.com".
Limite gratuite : 10 téléchargements/jour suffisent pour une bibliothèque modeste (50 séries). Au-delà, le compte VIP à 5$/mois ou 50$/an est rentable. Sinon, combinez plusieurs providers gratuits pour ne jamais tomber à court.
🐳 Créer le container Docker Bazarr
On va créer le container avec l'image officielle linuxserver/bazarr, bien maintenue et identique en structure aux autres *arr.
Méthode 1 : Via Container Manager (interface graphique)
- Ouvrez Container Manager
- Allez dans Registre
- Cherchez "linuxserver/bazarr"
- Cliquez Télécharger, choisissez le tag "latest"
- Une fois téléchargée, allez dans Image, sélectionnez l'image, cliquez Lancer
- Configurez le container :
- Nom :
bazarr - Activer le redémarrage automatique : oui
- Nom :
- Cliquez Suivant, puis configurez les paramètres avancés ci-dessous
Configuration avancée à appliquer :
Volumes (dossiers partagés) :
.srt à côté des vidéos. Utilisez exactement la même nomenclature /data/series et /data/films que dans les autres containers.
Port (réseau) :
Variables d'environnement :
Méthode 2 : Docker Compose (recommandé pour les habitués)
Si vous préférez un fichier docker-compose.yml propre :
services:
bazarr:
image: lscr.io/linuxserver/bazarr:latest
container_name: bazarr
environment:
- PUID=1026
- PGID=100
- TZ=Europe/Paris
volumes:
- /volume1/docker/bazarr:/config
- /volume1/data/series:/data/series
- /volume1/data/films:/data/films
ports:
- 6767:6767
restart: unless-stopped Sauvegardez ce fichier dans /volume1/docker/bazarr/docker-compose.yml, puis dans Container Manager > Projet > Créer.
Image : lscr.io/linuxserver/bazarr:latest (officielle linuxserver.io). Volumes : /config → /volume1/docker/bazarr, /data/series et /data/films identiques aux mounts Sonarr/Radarr (crucial pour la cohérence des paths via l'API). Port 6767. ENV : PUID=1026, PGID=100, TZ=Europe/Paris. Restart unless-stopped. Pas besoin de VPN (Bazarr ne télécharge que des .srt depuis des sources légales).
Pourquoi les paths doivent être identiques ? Quand Sonarr dit à Bazarr "l'épisode est à /data/series/Show Name/S01E01.mkv", Bazarr DOIT pouvoir ouvrir ce fichier exact. Si dans Bazarr le mount est /media/series/, Bazarr cherchera au mauvais endroit et échouera silencieusement. Règle d'or : mêmes mounts = même paths dans tous les containers du stack.
Pas besoin de VPN : contrairement à qBittorrent ou Prowlarr, Bazarr ne fait que des requêtes HTTP vers des API publiques de sous-titres. Aucun risque juridique. Vous pouvez le laisser hors VPN sans problème.
🚀 Premier lancement et configuration générale
Le container tourne ? On y accède via le navigateur.
- Ouvrez votre navigateur
- Tapez l'URL :
http://[IP-de-votre-NAS]:6767(par exemplehttp://192.168.1.20:6767) - Vous arrivez sur l'écran d'accueil de Bazarr
Activer l'authentification (très important)
Par défaut Bazarr est accessible sans mot de passe. Première chose à faire : activer un login.
- Allez dans Settings > General
- Section "Security"
- Authentication : choisissez "Forms"
- Username : votre choix (par exemple "admin")
- Password : un mot de passe fort (12+ caractères)
- Cliquez Save en haut à droite
- Reconnectez-vous avec vos nouveaux identifiants
Settings > General > Security
Choisir les langues que vous voulez gérer
Bazarr a besoin de savoir quelles langues de sous-titres vous intéressent. Inutile de tout cocher, sinon il va chercher du kurde pour vos épisodes de Friends.
- Allez dans Settings > Languages
- Dans "Subtitle Languages", ajoutez les langues que vous voulez. Typiquement :
- French (pour la VOSTFR)
- English (sous-titres anglais pour la VO)
- Éventuellement Spanish, German... selon vos besoins
- Dans "Display Language", choisissez la langue par défaut d'affichage dans l'UI (English par défaut, pas de français)
- Cliquez Save
Settings > Languages
URL : http://NAS-IP:6767. Settings > General > Security : Authentication = Forms, créer admin/password. Settings > Languages : ajouter les codes ISO 639 souhaités (fra, eng). Display Language reste en EN (pas de traduction française de l'UI dispo en 2026). API key : Settings > General pour les intégrations.
Codes langue à connaître : Bazarr utilise les codes ISO 639. "French" couvre aussi "Français (Canada)", "English" couvre US/UK/AU. Pas besoin d'ajouter chaque variante régionale sauf besoin spécifique (par ex. "Portuguese (Brazil)" est distinct de "Portuguese").
UI non-traduite : l'interface de Bazarr n'est disponible qu'en anglais. C'est le seul point faible. Le vocabulaire reste simple (Movies, Series, Languages, Providers), vous vous y ferez en dix minutes.
🔗 Connecter Bazarr à Sonarr et Radarr
C'est l'étape cruciale : Bazarr doit connaître votre bibliothèque pour chercher des sous-titres. On le connecte à Sonarr (séries) et Radarr (films).
Étape 1 : Récupérer les API Keys
- Ouvrez Sonarr (
http://NAS-IP:8989) - Allez dans Settings > General
- Section "Security" : copiez la API Key (gardez-la à portée de main)
- Faites pareil avec Radarr (
http://NAS-IP:7878)
Étape 2 : Configurer Sonarr dans Bazarr
- Dans Bazarr, allez dans Settings > Sonarr
- Activez le toggle "Use Sonarr"
- Remplissez :
- Address :
NAS-IP(par ex.192.168.1.20, sanshttp://ni port ici) - Port :
8989 - Base URL : laisser vide (ou
/sonarrsi reverse proxy) - SSL : désactivé en local
- API Key : collez la clé copiée depuis Sonarr
- Address :
- Cliquez sur Test pour vérifier la connexion
- Si "Test successful", cliquez Save
Settings > Sonarr
Étape 3 : Configurer Radarr
Exactement la même logique : Settings > Radarr > activer > remplir port 7878 + API Key Radarr.
Après connexion : Bazarr scanne votre bibliothèque
Allez dans Series ou Movies dans le menu principal : vous voyez maintenant toute votre bibliothèque listée. Bazarr est prêt à travailler.
Settings > Sonarr : toggle Use Sonarr, Address (IP NAS, sans scheme), Port 8989, API Key depuis Sonarr > Settings > General. Settings > Radarr : idem port 7878. Test puis Save. Premier sync pèse 2-10 min selon la taille de la bibliothèque. Path mapping disponible si les mounts diffèrent (à éviter : harmonisez plutôt les volumes Docker).
Si Test échoue : (1) vérifiez que l'IP est celle du NAS vue depuis le container Bazarr : en général ça marche avec l'IP LAN classique, (2) pas d'http:// dans le champ Address (Bazarr l'ajoute tout seul), (3) API Key sans espace au début/fin (erreur classique du copier-coller).
Containers sur le même réseau Docker ? Vous pouvez utiliser sonarr comme Address au lieu de l'IP (résolution DNS Docker). Plus propre si vous réorganisez vos IPs LAN plus tard.
🌐 Configurer les providers de sous-titres
Bazarr sait où chercher, mais il ne sait pas encore sur quels sites télécharger les sous-titres. On va configurer les providers.
- Dans Bazarr, allez dans Settings > Providers
- Cliquez sur "+ Add Provider" (ou l'icône +)
- Une liste apparaît avec 20+ providers possibles
- Ajoutez-en plusieurs (on recommande 3-4 en parallèle pour la redondance)
Providers recommandés en 2026
Notre sélection :
Configurer OpenSubtitles.com (le plus important)
- Ajoutez le provider "OpenSubtitles.com"
- Remplissez :
- Username : votre login OpenSubtitles.com
- Password : votre mot de passe
- Use Hash : cochez (meilleur matching)
- VIP : cochez seulement si vous avez payé l'abonnement
- Save
Provider Settings : OpenSubtitles.com
Conseil : cochez 3-4 providers en parallèle. Bazarr les interroge dans l'ordre, et passe au suivant si le premier n'a rien. Avoir Addic7ed + OpenSubtitles + Subscene garantit de trouver un sous-titre pour 99% des contenus.
Settings > Providers > Add. OpenSubtitles.com : REST API v1 (depuis 2023), requires login + password, optionnel API user-agent. Addic7ed : scraping, rate-limité (15 downloads/24h anonyme, plus avec compte). Subscene : scraping, couverture large. Podnapisi : fallback. Ordre de priorité dans Bazarr : draggable, placer OpenSubtitles en premier. Anti-captcha : pas nécessaire en 2026 (providers gardent le scraping simple).
Erreur 401 sur OpenSubtitles : c'est que les credentials ne sont pas renseignés dans Provider Settings. L'API OpenSubtitles exige une authentification, même pour le tier gratuit. Sans login valide, aucun sub ne sera trouvé.
Éviter les providers inutiles : n'ajoutez pas 10 providers "au cas où". Chaque recherche de sub interroge tous les providers activés, et ça ralentit tout. 3-4 bien choisis suffisent largement.
✅ Créer un profil de langue et lancer le scan
Dernière étape : dire à Bazarr quelles langues récupérer pour chaque série/film. C'est le concept de Language Profile.
Étape 1 : Créer un profil "Standard FR+EN"
- Allez dans Settings > Languages > Languages Profiles
- Cliquez sur "+ Add New Profile"
- Remplissez :
- Name :
Standard FR+EN - Languages : ajoutez French puis English
- Cutoff : laissez "None" (ou "Any" selon votre version)
- Hearing Impaired : laissez décoché (hi:false, pas de sous-titres sourds par défaut)
- Forced : laissez décoché
- Name :
- Cliquez Save
Profil "Standard FR+EN" créé
Étape 2 : Appliquer le profil à toute la bibliothèque
Le profil est créé, il faut maintenant l'assigner à toutes vos séries et films existants.
- Allez dans Series dans le menu principal
- Cliquez sur "Mass Edit" (en haut)
- Cliquez sur Select All (case en haut pour tout sélectionner)
- Dans le menu déroulant "Language Profile", choisissez Standard FR+EN
- Cliquez Save
- Répétez la même chose dans Movies
Series > Mass Edit
Étape 3 : Observer le travail de Bazarr
Dès que vous sauvegardez, Bazarr lance immédiatement la recherche pour toutes les vidéos de votre bibliothèque.
- Allez dans Wanted dans le menu : liste des sous-titres en cours de recherche
- Allez dans System > Tasks : voir les jobs en cours
- Allez dans System > Logs : voir les détails des téléchargements
- Revenez dans Series / Movies quelques minutes plus tard : les badges "missing" passent à "completed"
Activity > en cours de téléchargement
Vérification finale : ouvrir un épisode dans Plex
- Ouvrez Plex (ou Jellyfin, Emby…)
- Lancez n'importe quel épisode
- Dans les réglages de lecture, cliquez sur l'icône sous-titres
- Vous voyez maintenant French et English disponibles
- Choisissez-en un, le sous-titre apparaît en bas de l'écran
Bazarr est opérationnel
Vos sous-titres sont récupérés automatiquement à chaque nouveau téléchargement Sonarr/Radarr. Plus jamais de galère de .srt manquant.
Settings > Languages > Profiles > Add. Cutoff : à utiliser si vous voulez "stopper" la recherche dès qu'une langue est obtenue (par ex. cutoff FR = arrête de chercher l'EN). Hi/forced : flags optionnels par langue. Mass Edit via Series/Movies, Select All, bulk assign Profile. Sync automatique depuis Sonarr/Radarr pour les nouveaux items ajoutés. Vérifiez System > Tasks et Logs pour le monitoring. Post-processing scripts possibles (sync timing avec ffsubsync intégré).
Où sont stockés les .srt ? À côté de la vidéo, avec le même nom. Pour Show Name S01E01.mkv, vous aurez Show Name S01E01.fr.srt et Show Name S01E01.en.srt. Plex/Jellyfin les détecte automatiquement.
Sub-sync automatique : si un sub téléchargé est désynchronisé, Bazarr peut le recaler via Settings > Subtitles > "Use Subsync" (utilise ffsubsync). Le processus prend 30-60 secondes par fichier, mais améliore nettement la qualité.
Upgrade des sous-titres : Bazarr re-vérifie périodiquement si un meilleur sous-titre est disponible (option "Upgrade Previously Downloaded Subtitles"). Utile les premiers jours après sortie d'un épisode, quand de meilleures versions apparaissent.