Emby Playlist Studio v1.7.2 – Playlists y colecciones inteligentes con TMDB para Docker / Synology DSM

[ddark82 3]

Hola a todos.

Quería compartir con la comunidad un proyecto personal que he ido desarrollando para facilitar la creación, mantenimiento y automatización de playlists y colecciones de Emby.

Se llama Emby Playlist Studio y la versión que comparto actualmente es la v1.7.2.

Es una aplicación web que se ejecuta en Docker y trabaja sobre el contenido que YA existe en la biblioteca de Emby. No descarga películas ni series. Utiliza la API de Emby y TMDB para analizar metadatos, aplicar filtros y generar resultados dinámicos.

Actualmente está probado en Synology DSM 7.x con Container Manager / Docker. No lo he probado personalmente en otros NAS o sistemas como QNAP, Unraid, TrueNAS o Docker Desktop, por lo que agradecería cualquier prueba de compatibilidad en otros entornos.

¿QUÉ PUEDE HACER?

- Crear playlists inteligentes.
- Crear colecciones / BoxSets.
- Crear ambas cosas desde una misma regla.
- Trabajar con películas, series o contenido mixto.
- Filtrar por año, década, género, actor, director/creador, productora, país, idioma, valoración, keywords, duración y otros criterios.
- Utilizar fuentes dinámicas de TMDB: tendencias, populares, top valoradas, estrenos, series en emisión, etc.
- Incluir presets preparados para décadas, mejores títulos, animación, ciencia ficción, Marvel, DC, Star Wars, cine español y más.
- Ejecutar reglas manualmente, diariamente o semanalmente.
- Trabajar en modo "Solo añadir" o "Sincronización exacta".
- Administrar playlists y colecciones ya existentes.
- Seleccionar y eliminar varios contenedores a la vez sin borrar las películas o series de la biblioteca.
- Mostrar progreso en procesos largos.
- Utilizarse desde PC o móvil mediante una interfaz responsive.
- Incluye además una utilidad opcional para relacionar usuarios de Emby con dispositivos renombrados siguiendo un patrón como -- USUARIO-1, -- USUARIO-2, etc., con análisis previo, backup y verificación.

PELÍCULAS Y SERIES

Las reglas pueden ser:

- Películas.
- Series.
- Películas + Series.

En las colecciones, una serie puede mantenerse como elemento Series. En las playlists, las series se representan mediante episodios reproducibles, pudiendo elegir entre todos los episodios o solamente el primero.

TMDB

TMDB se utiliza como fuente de metadatos y rankings, pero Studio siempre cruza los resultados con la biblioteca de Emby. Si un título no existe en vuestro servidor, Studio no lo añade.

REQUISITOS PRINCIPALES

- Synology DSM + Container Manager / Docker en el entorno probado.
- Emby Server.
- Una API Key de Emby creada específicamente para esta integración.
- Una cuenta de TMDB y su API Read Access Token.
- Un usuario administrador/propietario de Emby para las funciones que requieren una sesión real de usuario.
- Acceso SSH al NAS para la instalación inicial.

INSTALACIÓN

Adjunto una guía HTML completa, responsive y autocontenida. Basta con abrir index.html en el navegador. Incluye:

- Creación de la API Key de Emby.
- Obtención del API Read Access Token de TMDB.
- Elección de la carpeta/volumen de DSM.
- Configuración del archivo .env.
- Comandos de instalación y actualización.
- Backups.
- Primera prueba recomendada.
- Problemas frecuentes.
- Seguridad.

La edición comunidad usa rutas relativas para config y backups, por lo que puede instalarse en /volume1, /volume2, /volume3, etc. sin estar vinculada a mi estructura personal.

CAMBIO IMPORTANTE EN v1.7.2

Desde esta versión, la sincronización del contenido y la colaboración de playlists están completamente separadas.

Una sincronización normal ya NO ejecuta MakePublic, MakePrivate ni permisos ACL al terminar. Esto evita que una playlist correctamente actualizada muestre después un 403 de MakePublic y parezca que toda la sincronización ha fallado.

La colaboración se modifica únicamente cuando el usuario lo solicita desde el gestor de playlists. La visibilidad inicial configurada en una regla solo se intenta al crear una playlist nueva.

COLABORACIÓN / PERMISOS

La gestión de Privado / Colaborativo / View / Editar depende de la versión y las políticas de usuario de Emby, por lo que considero esta parte opcional/experimental.

Lo importante es que, desde v1.7.2, cualquier problema de colaboración queda separado de la sincronización normal de contenido.

SEGURIDAD DEL ZIP PUBLICADO

El ZIP de comunidad está preparado específicamente para compartirlo y no contiene:

- Mi archivo .env.
- API Key de Emby.
- Token de TMDB.
- AccessTokens de Emby.
- Contraseñas.
- APP_SECRET real.
- Bases de datos.
- Caché.
- Historial.
- Backups.
- Datos personales de mi servidor.

Solo contiene .env.example con valores de ejemplo.

También incorpora .dockerignore para evitar que .env, config, tokens, backups o bases de datos puedan copiarse accidentalmente dentro de una imagen Docker durante una reconstrucción.

IMPORTANTE

Este proyecto no es oficial de Emby y no está afiliado al equipo de Emby ni a TMDB. Es un proyecto personal/comunitario que comparto por si puede ser útil a otros usuarios.

Si alguien lo prueba en otro NAS o sistema, agradecería que indicase:

- Sistema/NAS.
- Versión de Docker.
- Versión de Emby.
- Si funcionó directamente o necesitó cambios.
- Errores encontrados.

Y si publicáis logs, recordad eliminar previamente cualquier API key, token, contraseña, dominio privado o IP pública.

Cualquier sugerencia, nuevo preset, mejora, error o prueba en otros entornos será bienvenida.

EMBY_PLAYLIST_STUDIO_COMUNIDAD_v1.7.1.zip