Aceleración por hardware en Emby: ¿transcodifica la GPU o la CPU?

El problema que resuelve

Si tu servidor Emby tiene tarjeta gráfica pero las reproducciones siguen saturando la CPU, normalmente te enfrentas a una de tres cosas: el usuario de Emby no puede abrir la tarjeta, el driver no responde o los códecs de la tarjeta no están marcados en Emby. Ir a ciegas cuesta tardes enteras. Transcode Doctor responde a la pregunta con pruebas: prueba NVIDIA NVENC, Intel QuickSync y VA-API (Intel y AMD) con el propio ffmpeg de Emby, indica la velocidad medida y te dice la solución exacta cuando algo bloquea la aceleración. Además explica, en palabras sencillas, por qué se transcodificó cada reproducción reciente.

El plugin solo informa. Nunca cambia tus ajustes de Emby, así que nada en Emby depende de él.

Requisitos previos

• Emby Server 4.10.1 o posterior (Linux, Windows o Docker).
• Una tarjeta gráfica NVIDIA, Intel o AMD con su driver, accesible por Emby. Para NVIDIA, el driver que proporciona nvidia-smi; para Intel y AMD, un dispositivo render /dev/dri que el usuario de Emby pueda abrir, normalmente a través del grupo render. En Docker, el dispositivo debe pasarse al contenedor.
• La transcodificación por hardware en Emby requiere Emby Premiere.
• Una licencia de Transcode Doctor: una prueba gratuita de 30 días basta para un primer diagnóstico. Consulta la página del producto.

Paso 1 — Instala el plugin

1. Inicia sesión en tu cuenta de MediaLab Works, abre Licenses y descarga la DLL del plugin.
2. Copia la DLL en la carpeta de plugins de Emby y reinicia Emby Server:
   • Linux (paquete): /var/lib/emby/plugins/
   • Docker: la carpeta plugins dentro de tu 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 introduce tu correo electrónico para iniciar la prueba gratuita de 30 días. El plugin vincula la clave a este servidor 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 durante 7 días después de la última comprobación correcta.

Paso 2 — Ejecuta el diagnóstico de aceleración por hardware

En la página de Transcode Doctor, haz clic en Run the tests. El plugin:

• comprueba la tarjeta NVIDIA y los dispositivos /dev/dri, con los permisos del proceso de Emby;
• genera unos clips de prueba cortos con el ffmpeg de Emby en la carpeta de caché de Emby (tus medios no se tocan);
• prueba cada método al decodificar H.264, HEVC, HEVC 10 bits, MPEG-2 (TV), VP9 y AV1 y al codificar H.264 y HEVC.

Cada prueba tarda como máximo un minuto, y la tabla muestra qué funciona y a qué velocidad. La codificación AV1 no se prueba, porque el ffmpeg de Emby no puede probarla.

Paso 3 — Lee la lista de problemas y aplica la solución

Si algo bloquea la aceleración, la página lo indica y da la solución. Los casos habituales:

• Falta el usuario de Emby en el grupo render. La página muestra el comando que hay que ejecutar. Después de añadir el usuario, reinicia Emby y vuelve a ejecutar las pruebas. Es la razón habitual de que fallen todas las pruebas de VA-API y QuickSync.
• Una tarjeta NVIDIA cuyo driver no responde. Si nvidia-smi no responde, fallan todas las pruebas de NVENC; soluciona primero el driver.
• No se encuentra ffmpeg. El plugin prueba con el ffmpeg incluido en Emby, así que esto apunta a la propia instalación de Emby.
• Docker. El dispositivo GPU debe pasarse al contenedor; el plugin solo puede ver lo que ve el proceso de Emby, ni más ni menos.

Si ningún método por hardware supera las pruebas, la transcodificación se queda en la CPU: ese es el resultado honesto, y el informe te lo dice.

Paso 4 — Marca el método recomendado en Emby

La sección Recommendation te da el método que funciona, los códecs de la tarjeta, una estimación de cuántas transcodificaciones 1080p pueden ejecutarse a la vez y dónde marcarlos. El plugin no cambia estos ajustes: abre Settings → Transcoding de Emby, pon la aceleración por hardware en Advanced y marca los códecs de la tarjeta. Emby elige él mismo los códecs de hardware detectados.

Si las pruebas pasan pero las reproducciones siguen ejecutándose en la CPU, esta página de ajustes es lo primero que debes revisar.

Paso 5 — Averigua por qué se transcodifica cada reproducción

La vista Why it transcodes muestra las reproducciones transcodificadas recientes (se conservan hasta 500): cuándo, quién, con qué aplicación y dispositivo, el título, los motivos en palabras sencillas con lo que se puede hacer y si el trabajo lo hizo la GPU o la CPU. Motivos típicos que recoge la documentación:

• Subtítulos PGS incrustados: el formato de subtítulos obliga a transcodificar el vídeo aunque el vídeo en sí se reproduciría directamente.
• HDR en una pantalla SDR: el tone mapping tiene que hacerse en algún sitio.
• Códecs de audio: el cliente no puede decodificar la pista, así que el audio se convierte.
• El límite de bitrate de la aplicación: un cliente remoto con un límite bajo pide un bitrate menor.

Algunos de estos merece la pena corregirlos (otra pista de subtítulos, un ajuste del cliente); otros son simplemente lo que pidió el cliente. En cualquier caso, ahora sabes cuál es en lugar de adivinarlo.

Paso 6 — Vigila el registro de actividad para detectar caídas a la CPU

Cuando una transcodificación de vídeo se ejecuta en el procesador aunque el último diagnóstico encontró un método por hardware que funciona, el plugin escribe una entrada en el registro de actividad de Emby. La alerta está activada por defecto y solo escribe localmente. Si salta mientras tus pruebas pasan, vuelve a Settings → Transcoding y revisa los códecs marcados.

Consejos y solución de problemas

• Vuelve a ejecutar las pruebas después de cambiar un driver, Emby o el hardware. Un informe anterior a una actualización no dice nada sobre el estado actual.
• Fallan todas las pruebas de VA-API / QuickSync: revisa la lista de problemas; normalmente es el grupo render o el mapeo del dispositivo en Docker.
• Fallan todas las pruebas de NVENC: falta el driver de NVIDIA o nvidia-smi no responde.
• No ha pasado ningún método por hardware: la transcodificación se queda en la CPU. La recomendación y los motivos por reproducción te siguen ayudando a reducir la frecuencia con que ocurre.
• Dónde se guarda todo: el último informe y el historial están en la carpeta state/ del plugin; los clips sintéticos están en la carpeta de caché. Nada sale del servidor salvo la comprobación de licencia; consulta Licencias y privacidad en nuestros plugins.
• Cobertura de hardware: NVIDIA (NVENC) se verificó en una Quadro M2000 real. Intel QSV y VA-API se detectan y se prueban con el plugin, pero no se probaron en hardware real. AMD AMF, Apple VideoToolbox y Rockchip no son compatibles. Las comprobaciones están orientadas a Linux; Windows no se probó.
• Compatibilidad con clientes: la visualización y las alertas son del lado del servidor y funcionan con cualquier cliente que provoque una transcodificación. La interfaz de administración es Emby Web.
• Actualizaciones: desde la página License puedes instalar una actualización o volver a la versión anterior; reinicia Emby después de cualquiera de las dos. Consulta el changelog.

Tienes más contexto en nuestra base de conocimiento y en las preguntas frecuentes; para cualquier otra cosa, contacta con nosotros.

Conclusión

Una GPU que Emby no puede usar es peor que no tener GPU: la pagas y sigues transcodificando en la CPU. Transcode Doctor convierte eso en una comprobación breve y repetible: ejecuta las pruebas con el propio ffmpeg de Emby, aplica la única solución que indica la lista de problemas, marca los códecs en Emby y luego lee los motivos por reproducción para ver qué merece la pena cambiar de verdad. Empieza por la guía de usuario y la página del producto.