AISub para Emby — guía

Instalación

Necesitas Emby Server 4.10.1 o posterior.

1. Inicia sesión en tu cuenta de MediaLab Works, abre Licenses y descarga el DLL del plugin (disponible con una suscripción activa, con una licencia de por vida dentro de su período de actualizaciones o durante la prueba gratuita de 30 días).
2. Copia el DLL en la carpeta de plugins de Emby y reinicia Emby Server:
   • Linux (paquete): /var/lib/emby/plugins/
   • Docker: la carpeta plugins dentro del volumen de configuración de Emby
   • Windows: %AppData%\Emby-Server\programdata\plugins\
3. Abre AISub en el menú del panel de Emby y haz clic en License. Pega tu clave de licencia y actívala, o escribe tu correo para empezar la prueba gratuita de 30 días o comprar una licencia. El plugin contacta con el servidor de licencias, vincula la clave a este servidor de Emby y muestra la licencia como Active.

La licencia se comprueba una vez al día (y en cada arranque de Emby). Sin internet, el plugin sigue funcionando 7 días después de la última comprobación correcta; después se detiene hasta que pueda comprobarla de nuevo.

Licencia

Sin una licencia válida, el plugin se detiene; solo sigue funcionando la página License (desde ella puedes empezar la prueba, comprar, introducir la clave o actualizar).

Con una licencia válida, esa misma página puede instalar una actualización o volver a la versión anterior si una actualización causa problemas. Reinicia Emby después de cualquiera de las dos.

Configuración

1. Página de proveedores: añade las claves de los proveedores que quieras usar. Se guardan cifradas en tu servidor y se envían solo a su propio proveedor.
   • Traducción: una clave de Anthropic (Claude Haiku por defecto, Claude Sonnet para la máxima calidad), o la dirección de un servidor compatible con OpenAI: LM Studio (activa "Serve on Local Network"), Ollama, o uno en línea como OpenRouter.
   • Transcripción (para títulos sin ningún subtítulo): una clave de Groq (Whisper large-v3-turbo, el predeterminado) o una de OpenAI (Whisper). En la versión 0.1.0 un servidor local no puede transcribir.
2. Idiomas de destino: define los idiomas que quieres, en orden de prioridad.
3. Con Rosub (opcional, recomendado): AISub solo genera los idiomas que Rosub buscó y no encontró, así pagas solo lo que de verdad falta.

Uso diario

• Las películas y los episodios nuevos se procesan al llegar; una tarea nocturna recorre el resto de la biblioteca.
• Antes de ejecutar un trabajo se muestra su coste estimado. Para una película de 2 horas son unos 0,06 $ traducir con Claude Haiku y unos 0,16 $ transcribir y traducir, según las tarifas de los proveedores; con un servidor de IA local no cuesta nada.
• La página de trabajos muestra la cola, el progreso y el coste de cada trabajo.
• Cuando no hay ningún subtítulo que traducir, AISub transcribe el audio una vez y reutiliza esa transcripción para todos tus idiomas de destino.
• Cada traducción pasa una comprobación de alineación línea por línea, así las líneas permanecen sincronizadas con el original.
• Los subtítulos de IA se marcan como provisional. Con Rosub, el primer subtítulo hecho por una persona los sustituye automáticamente.

Qué envía y adónde

• El texto del subtítulo, en lotes de líneas, al proveedor de traducción que elegiste.
• Para la transcripción, la pista de audio de la película (mono, comprimida, en fragmentos) a Groq u OpenAI.
• No va nada a medialab.works salvo la comprobación de la licencia.

Resolución de problemas

• Los títulos sin ningún subtítulo no reciben subtítulo de IA: la transcripción necesita una clave de Groq u OpenAI; en la versión 0.1.0 un servidor local solo traduce.
• No se puede acceder a LM Studio: activa "Serve on Local Network" en LM Studio, para que el servidor de Emby pueda conectarse a él.