Sous-titres

CineRename intègre un module dédié à la recherche, la prévisualisation, le téléchargement et l'ajustement des sous-titres externes via OpenSubtitles.

À quoi ça sert

Visualiseur intégré

Avant de télécharger, le bouton Afficher ouvre un lecteur texte intégré. Vous pouvez lire les répliques, inspecter les timestamps et utiliser la barre de recherche avant d'enregistrer un candidat à côté de la vidéo.

Options de nommage

1. Hash vidéo — CineRename calcule l'empreinte OpenSubtitles standard (OSDb hash) sur les premiers et derniers Mo du fichier.
2. Fallback metadata — si aucun candidat utile n'est trouvé via le hash, CineRename recherche par titre, titre original, titre localisé, saison/épisode et IDs connus quand disponibles.
3. Prévisualisation et téléchargement — vous pouvez inspecter un candidat avant de le télécharger.
4. Nommage Plex-friendly — Mon Film (2023).fr.srt à côté du .mkv, ce qui permet à Plex / Jellyfin de les rattacher automatiquement.

Configuration

Dans Préférences → Sources et sous-titres :

• Langue préférée — fr, en, es, ja… (codes ISO 639-1)
• Langues de secours — si la principale n'est pas trouvée
• Hearing impaired — inclure ou non les sous-titres SDH
• Limite par fichier — ne télécharger qu'un seul .srt ou plusieurs versions

Clé API OpenSubtitles

CineRename embarque une clé API par défaut, suffisante pour un usage courant. Pour des volumes plus importants ou pour obtenir un quota dédié :

1. Créez un compte sur OpenSubtitles.
2. Récupérez votre clé API personnelle.
3. Saisissez-la dans Préférences → Sources et sous-titres → OpenSubtitles, ou via la variable d'environnement CINERENAME_OPENSUBTITLES_API_KEY.

Voir Clés API providers pour la résolution complète.

Workflow recommandé

1. Renommer d'abord les vidéos avec le Studio (titres officiels = meilleurs hits OpenSubtitles).
2. Lancer le module Sous-titres sur le même dossier.
3. Lancer Plex / Jellyfin → tous les sous-titres sont déjà bien nommés et reconnus.

Visualiseur de sous-titres intégré

Chaque sous-titre local listé dans le Studio Sous-titres expose un bouton Visualiser. Il ouvre une fenêtre qui :

• Parse le fichier .srt ou .vtt côté Rust (UTF-8 + BOM, fallback Latin-1)
• Strippe le markup (<i>, <b>, {\an8}) pour un affichage propre
• Affiche les répliques avec leurs timestamps (HH:MM:SS.mmm → HH:MM:SS.mmm)
• Permet de filtrer en direct par texte (utile pour vérifier qu'une réplique précise est bien là)
• Annonce la durée totale et le nombre de répliques parsées

Pratique pour vérifier qu'un sous-titre n'est pas désynchronisé ou tronqué avant de le déployer dans toute la bibliothèque.

Upload d'un sous-titre local vers OpenSubtitles

Si vous avez un sous-titre que vous avez retraduit ou resynchronisé, vous pouvez le partager directement à la communauté :

1. Dans le Studio Sous-titres, cliquez sur le bouton Envoyer à côté d'un sous-titre local
2. Renseignez le code langue (ISO 639-1 : fr, en, es…), le flag malentendant, le nom de release et un éventuel commentaire pour la modération
3. Validez — l'app se connecte à OpenSubtitles (login Bearer token), encode le fichier en base64 et le POST sur /api/v1/upload

Compte OpenSubtitles requis

L'upload nécessite clé API + compte utilisateur (login + password) dans Préférences → Sources et sous-titres → OpenSubtitles. La clé API embarquée par défaut ne suffit pas — il faut un compte qui a accepté les conditions de contributeur OpenSubtitles.

Quand l'upload réussit, CineRename remonte l'URL publique de la page du sous-titre (cliquable pour ouvrir dans le navigateur).

Limitations connues

• Les sous-titres forcés ne sont pas distingués automatiquement. Il faudra parfois renommer en .forced.srt pour Plex.
• La synchronisation parfaite n'est pas garantie. Le hash est le meilleur signal, mais certaines releases demandent un autre candidat, un offset ou une correction de drift.
• Les animes peu connus ont parfois peu ou pas de matchs OpenSubtitles. CineRename peut utiliser les métadonnées anime pour améliorer les requêtes, mais il ne peut pas créer de sous-titres inexistants.
• Les sous-titres embarqués dans le .mkv ne sont pas extraits ; CineRename ne fait que rajouter des .srt externes.