Installer Bazarr sur Synology : sous-titres automatiques pour tout
0 / 7
← Tous les guides

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.

Choisissez votre guide

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.

1

💬 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 :

❌ Série downloadée en VO → pas de sous-titres
❌ Galère à trouver les VOSTFR sur 10 sites
❌ Télécharger le bon fichier .srt manuellement
❌ Renommer pour qu'il match la vidéo
Avec Bazarr : tout est couvert automatiquement, en deux minutes de setup.

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 :

Avant : 20 séries sans sous-titres Manuel, pénible
Après : tout couvert en 2 min Automatique

Comparaison rapide avec les alternatives :

Les solutions possibles :

Bazarr (recommandé) Auto, gratuit, UI web
Subliminal (CLI) Technique, ligne de commande
Filebot Payant (~50€)
À la main Long, fastidieux

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é.

2

📋 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é

  1. Ouvrez Centre de paquets sur votre Synology
  2. Vérifiez que "Container Manager" (DSM 7) ou "Docker" (DSM 6) est installé
  3. 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é :

1. Sonarr (séries) Voir le guide →
2. Radarr (films) Voir le guide →
3. Bazarr (sous-titres) ← vous êtes ici

Prérequis #3 : Dossier de stockage Bazarr

  1. Ouvrez File Station
  2. Allez dans docker/ (le même dossier que vos autres *arr)
  3. Créez un sous-dossier bazarr/
  4. 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 :

OpenSubtitles.com Compte gratuit requis · 10 subs/jour
Indispensable
Addic7ed Gratuit, sans compte
Recommandé
Subscene Gratuit, sans compte
Bon d'appoint
Créez dès maintenant un compte OpenSubtitles.com (gratuit). Le compte VIP à 5$/mois lève la limite des 10 subs/jour, utile si vous avez une grosse bibliothèque.

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.

3

🐳 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)

  1. Ouvrez Container Manager
  2. Allez dans Registre
  3. Cherchez "linuxserver/bazarr"
  4. Cliquez Télécharger, choisissez le tag "latest"
  5. Une fois téléchargée, allez dans Image, sélectionnez l'image, cliquez Lancer
  6. Configurez le container :
    • Nom : bazarr
    • Activer le redémarrage automatique : oui
  7. Cliquez Suivant, puis configurez les paramètres avancés ci-dessous

Configuration avancée à appliquer :

Volumes (dossiers partagés) :

/volume1/docker/bazarr → /config
/volume1/data/series → /data/series
/volume1/data/films → /data/films
⚠️ IMPORTANT : Bazarr doit voir les MÊMES paths que Sonarr/Radarr. Sinon il ne pourra pas écrire les fichiers .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) :

6767 (TCP) → 6767 (container)

Variables d'environnement :

PUID 1026
PGID 100
TZ Europe/Paris
Reprenez exactement les mêmes PUID/PGID que vos autres containers *arr (sinon Bazarr aura des erreurs de permission pour écrire les .srt).

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.

4

🚀 Premier lancement et configuration générale

Le container tourne ? On y accède via le navigateur.

  1. Ouvrez votre navigateur
  2. Tapez l'URL : http://[IP-de-votre-NAS]:6767 (par exemple http://192.168.1.20:6767)
  3. 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.

  1. Allez dans Settings > General
  2. Section "Security"
  3. Authentication : choisissez "Forms"
  4. Username : votre choix (par exemple "admin")
  5. Password : un mot de passe fort (12+ caractères)
  6. Cliquez Save en haut à droite
  7. Reconnectez-vous avec vos nouveaux identifiants

Settings > General > Security

Authentication Forms ▼
Username admin
Password ●●●●●●●●●●●●

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.

  1. Allez dans Settings > Languages
  2. 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
  3. Dans "Display Language", choisissez la langue par défaut d'affichage dans l'UI (English par défaut, pas de français)
  4. Cliquez Save

Settings > Languages

Subtitle Languages
French English
Display Language English

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.

5

🔗 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

  1. Ouvrez Sonarr (http://NAS-IP:8989)
  2. Allez dans Settings > General
  3. Section "Security" : copiez la API Key (gardez-la à portée de main)
  4. Faites pareil avec Radarr (http://NAS-IP:7878)

Étape 2 : Configurer Sonarr dans Bazarr

  1. Dans Bazarr, allez dans Settings > Sonarr
  2. Activez le toggle "Use Sonarr"
  3. Remplissez :
    • Address : NAS-IP (par ex. 192.168.1.20, sans http:// ni port ici)
    • Port : 8989
    • Base URL : laisser vide (ou /sonarr si reverse proxy)
    • SSL : désactivé en local
    • API Key : collez la clé copiée depuis Sonarr
  4. Cliquez sur Test pour vérifier la connexion
  5. Si "Test successful", cliquez Save

Settings > Sonarr

Use Sonarr ✓ Enabled
Address 192.168.1.20
Port 8989
API Key a1b2c3d4...e5f6
✓ Test successful · 234 séries détectées

É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

Series scannées 234
Movies scannés 156
Épisodes indexés 3 847
✓ Bibliothèque entièrement connue de Bazarr

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.

6

🌐 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.

  1. Dans Bazarr, allez dans Settings > Providers
  2. Cliquez sur "+ Add Provider" (ou l'icône +)
  3. Une liste apparaît avec 20+ providers possibles
  4. Ajoutez-en plusieurs (on recommande 3-4 en parallèle pour la redondance)

Providers recommandés en 2026

Notre sélection :

OpenSubtitles.com Le plus utilisé · couverture massive
Compte requis
Addic7ed Excellent pour les séries US
Gratuit
Subscene Bonne couverture internationale
Gratuit
Podnapisi Fallback utile si les autres échouent
Gratuit

Configurer OpenSubtitles.com (le plus important)

  1. Ajoutez le provider "OpenSubtitles.com"
  2. 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
  3. Save

Provider Settings : OpenSubtitles.com

Username votre-email
Password ●●●●●●●●●●●●
Use Hash ✓ Enabled
VIP ✗ Disabled
⚠️ Sans credentials : erreur 401 sur chaque recherche. Pas d'oubli, sinon OpenSubtitles ne marche pas du tout.

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.

7

✅ 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"

  1. Allez dans Settings > Languages > Languages Profiles
  2. Cliquez sur "+ Add New Profile"
  3. 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é
  4. Cliquez Save

Profil "Standard FR+EN" créé

Name Standard FR+EN
Languages
French English
Hearing Impaired ✗ Disabled
Forced ✗ Disabled

É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.

  1. Allez dans Series dans le menu principal
  2. Cliquez sur "Mass Edit" (en haut)
  3. Cliquez sur Select All (case en haut pour tout sélectionner)
  4. Dans le menu déroulant "Language Profile", choisissez Standard FR+EN
  5. Cliquez Save
  6. Répétez la même chose dans Movies

Series > Mass Edit

Sélection 234 séries sélectionnées
Profile à appliquer Standard FR+EN ▼
Cancel Save

É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.

  1. Allez dans Wanted dans le menu : liste des sous-titres en cours de recherche
  2. Allez dans System > Tasks : voir les jobs en cours
  3. Allez dans System > Logs : voir les détails des téléchargements
  4. Revenez dans Series / Movies quelques minutes plus tard : les badges "missing" passent à "completed"

Activity > en cours de téléchargement

Show Name S03E07 - FR Provider : Addic7ed · match 92%
✓ Downloaded
Inception (2010) - EN Provider : OpenSubtitles.com · match 100%
✓ Downloaded
The Office S02E15 - FR Provider : Subscene · match 87%
✓ Downloaded
✓ 2 847 sous-titres téléchargés · 127 en cours

Vérification finale : ouvrir un épisode dans Plex

  1. Ouvrez Plex (ou Jellyfin, Emby…)
  2. Lancez n'importe quel épisode
  3. Dans les réglages de lecture, cliquez sur l'icône sous-titres
  4. Vous voyez maintenant French et English disponibles
  5. 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.

🤝
Besoin d'un coup de main ?

Je peux vous aider à configurer tout ça à distance. Petit forfait ou au chapeau, on s'arrange.

Me contacter