Transcode Doctor para Emby

Transcode Doctor muestra si tu servidor de Emby puede transcodificar en la tarjeta gráfica, qué lo impide cuando no puede, y por qué se transcodifica cada reproducción.

Qué hace

• Diagnóstico de aceleración por hardware con el ffmpeg propio de Emby: comprueba la tarjeta NVIDIA y los dispositivos /dev/dri (con los permisos del proceso de Emby) y después ejecuta transcodificaciones de prueba cortas con cada método — NVIDIA NVENC, Intel QuickSync y VA-API (Intel / AMD). Cada método se prueba descodificando H.264, HEVC, HEVC 10-bit, MPEG-2 (TV), VP9 y AV1 y codificando H.264 y HEVC, con la velocidad medida. La codificación AV1 no se prueba, porque el ffmpeg de Emby no puede probarla. Los clips de prueba se generan en la carpeta de caché de Emby; tus archivos multimedia no se tocan.
• Problemas con la solución exacta: por ejemplo, el usuario de Emby que falta en el grupo render (con el comando a ejecutar), una tarjeta NVIDIA cuyo controlador no responde, o ffmpeg no encontrado.
• Recomendación: el método que funciona, los códecs de la tarjeta, una estimación de cuántas transcodificaciones 1080p pueden ejecutarse al mismo tiempo y dónde marcarlos en Emby. El plugin no cambia los ajustes de Emby: Emby elige por sí solo los códecs de hardware detectados, en Settings → Transcoding (aceleración por hardware «Advanced», con los códecs de la tarjeta marcados).
• Why it transcodes: las reproducciones transcodificadas recientes, cada una con los motivos de Emby explicados en palabras sencillas y lo que se puede hacer (por ejemplo, subtítulos PGS quemados, HDR en una pantalla SDR, el límite de tasa de bits de la app). Se conservan hasta 500 reproducciones.
• Alerta de recurso a la CPU: una entrada en el registro de actividad de Emby cuando una transcodificación de vídeo se ejecuta en el procesador aunque el último diagnóstico encontró un método hardware que funciona.
• En inglés y rumano.

Requisitos

• Emby Server 4.10.1 o posterior (Linux, Windows o Docker).
• Una tarjeta gráfica NVIDIA, Intel o AMD con su controlador: para NVIDIA, el controlador con nvidia-smi; para Intel y AMD, un dispositivo de renderizado /dev/dri que el usuario de Emby pueda abrir (normalmente mediante el grupo render). En Docker, hay que pasar el dispositivo al contenedor. La transcodificación por hardware en el propio Emby requiere Emby Premiere.

Preguntas frecuentes

¿Por qué Emby transcodifica en la CPU aunque mi servidor tiene una GPU? A menudo el usuario de Emby no tiene acceso a la tarjeta, falta el controlador, o los códecs de la tarjeta no están marcados en los ajustes de transcodificación de Emby. Transcode Doctor prueba la tarjeta con el ffmpeg propio de Emby y te dice cuál es. Consulta la guía.

¿Cambia mis ajustes de Emby? No. A diferencia de la versión para Jellyfin, solo informa: Emby elige por sí solo los códecs de hardware y el panel indica dónde configurarlos.

Qué envía y adónde

• Sin contacto externo aparte del cliente de licencias. No descarga archivos de prueba: los clips de muestra (H.264, HEVC, HEVC 10-bit, MPEG-2, VP9, AV1) se generan localmente con el ffmpeg incluido del servidor, en la carpeta de caché del servidor (transcode-doctor/). Tus archivos multimedia no se tocan.
• Procesos locales: el ffmpeg incluido del servidor, nvidia-smi (solo si existe una tarjeta NVIDIA), una comprobación de acceso en /dev/dri/renderD*.
• El diagnóstico se ejecuta solo cuando haces clic en el botón. La vigilancia de sesiones (cada 15 s, solo con licencia) lee la información de transcodificación de las reproducciones activas; la alerta de «recurso a la CPU» (activada por defecto) solo escribe en el registro de actividad local.
• El plugin no cambia los ajustes de transcodificación de Emby (te dice qué marcar).
• Además, el cliente de licencias, igual en todos los plugins: consulta Licencias y privacidad en nuestros plugins.

Guardado localmente (state/ en la carpeta de datos del plugin): report.json (último diagnóstico: ruta de ffmpeg, GPU, resultados), history.json (últimas 500 reproducciones transcodificadas: hora, usuario, app, dispositivo, título, motivos de transcodificación, hardware/CPU), clips sintéticos en la caché.

Nunca enviado: nada de lo anterior sale del servidor.

Compatibilidad con clientes

• La visualización y las alertas están en el servidor: 🟢 funciona con cualquier cliente que desencadene una transcodificación.
• Interfaz: solo página de administración — Emby Web ✅ (comprobado visualmente; sin prueba automatizada de extremo a extremo).
• Hardware probado: NVIDIA (NVENC) en una Quadro M2000 real ✅. Intel QSV / VA-API: detectados y probados por el plugin, ❔ no probados en hardware real. AMD AMF, Apple VideoToolbox, Rockchip: no compatibles.
• Las comprobaciones están orientadas a Linux (/dev/dri, nvidia-smi, grupo render); Windows/macOS: ❔ no probado.

Leyenda: ✅ verificado (prueba de extremo a extremo o en el dispositivo) · 🟢 en el servidor, funciona con cualquier cliente (por diseño, sin prueba específica para cada cliente) · ➖ no aplicable · ❔ no probado.

Licencia

Una licencia por servidor de Emby. Mensual, anual o de por vida, o incluida en el paquete para Emby. 30 días de prueba gratis. El plugin se distribuye bajo nuestro EULA.

Transcode Doctor es código propio, escrito por MediaLab Works; no contiene código de terceros.