Transcode Doctor 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 Transcode Doctor 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: no se ejecuta ninguna prueba ni se escribe ninguna alerta, y solo sigue funcionando la página License (desde ella puedes empezar la prueba, comprar, introducir la clave o actualizar). El último informe y el historial se conservan. El plugin nunca cambia tus ajustes de Emby, así que nada en Emby depende de él.

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

Abre Transcode Doctor en el panel de Emby.

1. Diagnóstico de aceleración por hardware: haz clic en Run the tests. El plugin comprueba la tarjeta NVIDIA y los dispositivos /dev/dri, crea algunos clips de prueba cortos con el ffmpeg de Emby en la carpeta de caché de Emby y después prueba cada método (NVIDIA NVENC, Intel QuickSync, VA-API) descodificando H.264, HEVC, HEVC 10-bit, MPEG-2, VP9 y AV1 y codificando H.264 y HEVC. Cada prueba tarda como máximo un minuto; la tabla muestra qué funciona y a qué velocidad.
2. Problemas: si algo bloquea la aceleración, la página dice qué es y cómo arreglarlo, por ejemplo el comando que añade el usuario de Emby al grupo render (después reinicia Emby y vuelve a ejecutar las pruebas). En Docker, pasa el dispositivo GPU al contenedor.
3. Recomendación: el método que funciona, los códecs de la tarjeta y aproximadamente cuántas transcodificaciones 1080p pueden ejecutarse a la vez. Para usarlas, abre Settings → Transcoding de Emby, pon la aceleración por hardware en Advanced y marca los códecs de la tarjeta; Emby elige por sí solo los códecs de hardware detectados. El plugin no cambia estos ajustes.

Uso diario

• Why it transcodes enumera las reproducciones transcodificadas recientes: cuándo, quién, qué, los motivos en palabras sencillas con lo que se puede hacer, y si trabajaron la GPU o la CPU.
• Cuando una transcodificación de vídeo se ejecuta en la CPU aunque el último diagnóstico encontró un método hardware que funciona, el plugin escribe una entrada en el registro de actividad de Emby. Si las pruebas pasan pero las reproducciones siguen en la CPU, revisa los códecs en Settings → Transcoding.
• Vuelve a ejecutar las pruebas tras un cambio de controlador, de Emby o de hardware.

Solución de problemas

• Todas las pruebas de VA-API / QuickSync fallan: revisa la lista de problemas; normalmente falta el usuario de Emby en el grupo render o el dispositivo no se pasó al contenedor de Docker.
• Todas las pruebas de NVENC fallan: falta el controlador NVIDIA o nvidia-smi no responde.
• Ningún método superó las pruebas: la transcodificación se queda en la CPU.