AISub pour Emby — Guide

Installation

Vous avez besoin d’Emby Server 4.10.1 ou plus récent.

1. Connectez-vous à votre compte MediaLab Works, ouvrez Licences et téléchargez le DLL du plugin (disponible avec un abonnement actif, une licence à vie dans sa période de mises à jour, ou pendant l’essai gratuit de 30 jours).
2. Copiez le DLL dans le dossier des plugins 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 AISub dans le menu du tableau de bord Emby et cliquez sur License. Collez votre clé de licence et activez-la, ou saisissez votre e-mail pour démarrer l’essai gratuit de 30 jours ou acheter une licence. 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 ; ensuite, il est arrêté jusqu’à ce qu’il puisse à nouveau vérifier.

Licence

Sans licence valide, le plugin est arrêté ; seule la page License continue de fonctionner (vous pouvez y démarrer l’essai, acheter, saisir la clé ou mettre à jour).

Avec une licence valide, la même page peut installer une mise à jour ou revenir à la version précédente si une mise à jour pose problème. Redémarrez Emby dans les deux cas.

Configuration

1. Page Providers : ajoutez les clés des fournisseurs que vous voulez utiliser. Elles sont stockées chiffrées sur votre serveur et ne sont envoyées qu’à leur propre fournisseur.
   • Traduction : une clé Anthropic (Claude Haiku par défaut, Claude Sonnet pour une qualité maximale), ou l’adresse d’un serveur compatible OpenAI : LM Studio (activez « Serve on Local Network »), Ollama, ou un serveur en ligne comme OpenRouter.
   • Transcription (pour les titres sans aucun sous-titre) : une clé Groq (Whisper large-v3-turbo, par défaut) ou une clé OpenAI (Whisper). En 0.1.0, un serveur local ne peut pas transcrire.
2. Langues cibles : définissez les langues voulues, par ordre de priorité.
3. Avec Rosub (optionnel, recommandé) : AISub ne génère que les langues que Rosub a cherchées et n’a pas trouvées, vous ne payez donc que ce qui manque vraiment.

Utilisation quotidienne

• Les nouveaux films et épisodes sont traités à leur arrivée ; une tâche nocturne parcourt le reste de la bibliothèque.
• Avant l’exécution d’un travail, son coût estimé est affiché. Pour un film de 2 heures, il est d’environ $0.06 pour traduire avec Claude Haiku et d’environ $0.16 pour transcrire et traduire, aux tarifs des fournisseurs ; avec un serveur d’IA local, cela ne coûte rien.
• La page Jobs affiche la file d’attente, la progression et le coût de chaque travail.
• Quand il n’existe aucun sous-titre à traduire, AISub transcrit l’audio une fois et réutilise cette transcription pour toutes vos langues cibles.
• Chaque traduction passe par un contrôle d’alignement ligne par ligne, pour que les cues restent synchronisés avec l’original.
• Les sous-titres IA sont marqués comme provisoires. Avec Rosub, le premier sous-titre créé par un humain les remplace automatiquement.

Ce qu’il envoie et où

• Le texte des sous-titres, par lots de cues, vers le fournisseur de traduction choisi.
• Pour la transcription, la piste audio du film (mono, compressée, par morceaux) vers Groq ou OpenAI.
• Rien ne va vers medialab.works, si ce n’est la vérification de la licence.

Dépannage

• Les titres sans aucun sous-titre n’obtiennent pas de sous-titre IA : la transcription nécessite une clé Groq ou OpenAI ; en 0.1.0, un serveur local traduit seulement.
• LM Studio est inaccessible : activez « Serve on Local Network » dans LM Studio, pour que le serveur Emby puisse s’y connecter.