Sous-titres roumains automatiques dans Emby : subs.ro et OpenSubtitles, calés sur votre release

Pourquoi les sous-titres dérivent

Si vous avez déjà cherché « emby subtitles out of sync », vous connaissez le symptôme : la première ligne tombe à peu près juste, puis l'écart grandit lentement jusqu'à ce que le dialogue soit décalé de quelques secondes. La cause habituelle n'est pas un fichier de sous-titres cassé, mais un sous-titre créé pour une autre release du même titre. Un WEB-DL, un BluRay et un rip HDTV d'un même film sont rarement identiques : sources différentes, montages différents, parfois fréquences d'images différentes. Un sous-titre calé pour l'un ne tombera pas correctement sur l'autre.

Rosub est un plugin Emby qui récupère des sous-titres roumains sur subs.ro et OpenSubtitles et choisit le sous-titre créé pour le même nom de release que votre fichier. Il lance ensuite une vérification de la synchro avec ffprobe qui compare le timing des sous-titres à la vidéo et corrige un décalage constant. Vous fournissez vos propres clés API (les deux fournisseurs proposent des offres gratuites), et le plugin ne livre jamais de clés partagées.

Ce tutoriel s'adresse aux auto-hébergeurs qui font tourner Emby chez eux, y compris les spectateurs roumains en Allemagne, en France, en Espagne et en Italie qui gardent une bibliothèque de sous-titres roumains à côté de leurs médias. Les étapes suivent la page produit Rosub et le guide d'utilisation.

Prérequis

• Emby Server 4.10.1 ou plus récent.
• ffprobe accessible à Emby. Il est fourni avec Emby sur la plupart des installations ; la vérification de la synchro en dépend.
• Un compte subs.ro et/ou un compte OpenSubtitles, pour créer vos propres clés API.
• Un peu de patience avec l'historique : les éléments nouveaux sont traités en premier, puis le reste de la bibliothèque.

Étape 1 — Obtenir vos propres clés API gratuites

Les deux fournisseurs proposent des offres gratuites, et Rosub n'utilise que vos clés :

1. Créez un compte subs.ro et générez une clé API. L'offre gratuite est de 300 requêtes/jour.
2. Créez éventuellement un compte opensubtitles.com et générez une clé API. L'offre gratuite est de 5 téléchargements/24 h.

Conservez les deux clés en lieu sûr. Vous les collerez dans le plugin à l'étape suivante. Comme les clés sont les vôtres, les quotas sont suivis par clé et vous n'êtes pas en concurrence avec l'usage de quelqu'un d'autre.

Étape 2 — Installer Rosub dans Emby

1. Connectez-vous à votre compte MediaLab Works, ouvrez Licenses et téléchargez la DLL du plugin. Elle est disponible avec un abonnement actif, une licence à vie dans sa fenêtre de mises à jour, ou pendant l'essai gratuit de 30 jours.
2. Copiez la DLL dans le dossier des plugins d'Emby et redémarrez Emby Server :
   • Linux (paquet) : /var/lib/emby/plugins/
   • Docker : le dossier plugins dans votre volume de configuration Emby
   • Windows : %AppData%\Emby-Server\programdata\plugins\
3. Ouvrez Emby Dashboard → Plugins, cliquez sur le plugin, collez votre clé de licence et enregistrez. Le plugin contacte le serveur de licences, lie la clé à ce serveur Emby et affiche la licence comme Active.

La licence est vérifiée une fois par jour et à chaque démarrage d'Emby. Sans internet, le plugin continue de fonctionner pendant 7 jours après la dernière vérification réussie. Si la licence n'est pas valide, les tâches automatiques s'arrêtent, mais les sous-titres déjà téléchargés restent à côté de vos fichiers et tout reprend dès que la licence est de nouveau valide.

Étape 3 — Configurer les clés, les bibliothèques et la file de priorités

Ouvrez Dashboard → Plugins → Rosub et renseignez les paramètres :

Cette file de priorités explique qu'un épisode fraîchement ajouté reçoive son sous-titre en quelques minutes, tandis que l'historique plus ancien est traité en arrière-plan. Laissez Écraser l'existant désactivé, sauf si vous voulez délibérément remplacer des fichiers que vous avez déjà.

La page du plugin affiche la file, les téléchargements récents et les erreurs (par exemple une limite journalière atteinte chez un fournisseur) : c'est le premier endroit à consulter quand quelque chose semble bloqué.

Étape 4 — Comment la correspondance par release choisit le bon sous-titre

Quand Rosub cherche un sous-titre, il utilise le nom de release de votre fichier pour trouver le sous-titre créé pour le même groupe de release et la même source. Un sous-titre étiqueté pour un WEB-DL ne sera pas choisi pour un fichier BluRay si un sous-titre correspondant existe, car le timing ne conviendrait pas. C'est la correction la plus efficace contre la dérive : le bon sous-titre pour la bonne release.

Conséquence pratique : gardez des noms de fichiers informatifs. Si votre fichier porte le nom de la release d'origine, la correspondance a de quoi travailler. S'il a été renommé en quelque chose de générique, le plugin risque de ne pas trouver de bonne correspondance — le conseil de dépannage du guide est justement de renommer selon le nom de release d'origine pour aider la correspondance.

Étape 5 — La vérification de la synchro : ce qu'elle corrige et ce qu'elle ne peut pas

Avec la Vérification de la synchro activée, Rosub utilise ffprobe pour comparer le timing des sous-titres à la vidéo et corrige un décalage constant. C'est exactement le schéma de dérive où tout le sous-titre est uniformément en avance ou en retard : une correction et tout s'aligne.

Ce qu'elle ne peut pas corriger, c'est un sous-titre découpé pour un autre montage du film, où le décalage change en cours de route. Dans ce cas, la réponse honnête est un autre fichier de sous-titres : cherchez manuellement celui qui correspond à votre release.

Étape 6 — Recherche manuelle et diacritiques roumains

Il arrive que vous vouliez un autre sous-titre, ou que la passe automatique n'ait rien trouvé à votre goût. Ouvrez l'élément dans Emby, allez dans Edit subtitles → Search et choisissez un résultat Rosub. La recherche manuelle s'exécute depuis le serveur : elle utilise donc les mêmes clés et les mêmes quotas que les tâches automatiques.

Les sous-titres sont stockés comme de simples fichiers externes nommés <video>.ro.srt à côté de la vidéo, ce qui explique qu'ils apparaissent dans n'importe quel client affichant les sous-titres externes — en production, Emby les liste comme « Romanian (SRT) ». Comme ce sont de simples fichiers .srt en UTF-8, les diacritiques roumains ș/ț s'affichent correctement tant que votre lecteur utilise l'UTF-8, ce qui est le cas des clients modernes. Si vous voyez un jour des caractères illisibles, vérifiez l'encodage du fichier plutôt que le plugin.

Conseils et dépannage

• Aucun sous-titre trouvé. Vérifiez le nom de release de votre fichier ; renommer selon le nom de release d'origine aide la correspondance. Vérifiez aussi que les bonnes bibliothèques sont sélectionnées.
• Toujours désynchronisé. Activez la vérification de la synchro, ou cherchez manuellement un sous-titre correspondant à votre release. Rappelez-vous qu'un décalage constant est corrigeable ; un autre montage ne l'est pas.
• Limite du fournisseur atteinte. Les deux fournisseurs ont des limites journalières par clé (subs.ro 250 et OpenSubtitles 5 requêtes par défaut dans les budgets journaliers du plugin), et la file reprend le lendemain. Consultez la page du plugin pour l'erreur.
• Sous-titres invisibles sur la TV. Les fichiers sont de simples .srt à côté de la vidéo. Si un client ne les affiche pas, vérifiez que le fichier existe bien avec le suffixe .ro.srt et que le client affiche les sous-titres externes. Les applications natives individuelles ne sont pas testées, conformément aux notes de compatibilité.
• Vérification de la confidentialité. subs.ro ne reçoit que l'identifiant IMDb ou TMDb et la langue — ni titres, ni noms de fichiers, ni noms de release, ni hashes. OpenSubtitles reçoit les langues, l'identifiant (ou l'identifiant de série plus saison/épisode) et le hash OpenSubtitles calculé localement à partir de la taille du fichier et des premiers/derniers 64 Ko ; le contenu n'est jamais envoyé. La vérification de la synchro et la correspondance par release s'exécutent localement avec ffprobe.
• Clés au repos. Votre clé subs.ro, votre clé OpenSubtitles et votre mot de passe OpenSubtitles sont stockés chiffrés dans secrets.enc.json dans le dossier de données du plugin (AES-256-GCM, clé liée à l'identifiant du serveur, fichiers en mode 600) et ne sont jamais envoyés au navigateur.
• Les séries aussi. Rosub gère les films et les séries ; les éléments nouveaux sont traités en premier, puis le reste de la bibliothèque.
• Pas sur Jellyfin ni Plex. Rosub est un plugin Emby. Pour Jellyfin, il existe un plugin distinct, Rosub for Jellyfin ; il n'y a pas de version Plex.

Conclusion

La dérive est presque toujours une incompatibilité de release, pas un mauvais sous-titre. Avec Rosub, vous obtenez une correspondance par nom de release pour choisir le bon fichier, une vérification de la synchro avec ffprobe pour corriger un décalage constant, et vos propres clés API gratuites pour garder les quotas sous votre contrôle. Installez-le, définissez les bibliothèques et la file de priorités, et laissez l'historique se résorber tout seul.

Commencez par la page produit Rosub, suivez le guide d'utilisation pour les réglages exacts, et consultez le changelog pour les mises à jour. D'autres contenus d'auto-hébergement sont dans notre base de connaissances, et vous pouvez nous joindre via contact ou la FAQ.