HouseCinema — Automatización de un servidor multimedia

HouseCinema es un sistema de automatización de extremo a extremo construido sobre un NAS casero (Ugreen DXP4800 Pro). El objetivo era eliminar toda la parte manual y repetitiva de gestionar una biblioteca multimedia: pedir contenido, organizarlo, convertirlo a un formato compatible y mantenerlo sano con el tiempo, sin tener que estar pendiente.

Todo el flujo se dispara desde un simple mensaje de Telegram (/peli, /serie). Un bot recibe la solicitud, confirma con el usuario y la traslada a un workflow de automatización (n8n) que coordina varios servicios especializados en la búsqueda y descarga de contenido. En cuanto el archivo está disponible, un script propio en Python lo organiza automáticamente según una jerarquía de reglas (franquicia, saga, género), y un segundo sistema (vigilante de carpetas + conversión) lo transforma al formato final, lo renombra correctamente y deja que el catálogo final actualice sus metadatos solo.

El acceso está controlado por lista de usuarios autorizados, con roles de administrador y usuario, y comandos de gestión (añadir/quitar admins, listar usuarios, reiniciar el sistema remotamente).

Una parte importante del proyecto fue hacerlo resistente a fallos por sí solo: un script de rescate detecta y repara automáticamente importaciones que se quedan atascadas (archivos con nombres imposibles de interpretar, rutas que cambiaron, archivos basura mezclados en la cola), un proceso de vigilancia de carpetas se reinicia solo cada día para evitar que se quede colgado silenciosamente, y el propio workflow de automatización incorpora bloqueos y control de duplicados para no disparar la misma acción dos veces ni saturarse en momentos de mucha actividad.

Para la supervisión, un segundo bot de Telegram independiente monitoriza todo el sistema: envía alertas críticas automáticas si algo falla, genera un reporte semanal en PDF, y permite consultar el estado, los logs y la cola de trabajo pendiente sin tener que entrar al NAS.

Lo que más me interesaba de este proyecto era la orquestación y la fiabilidad: conseguir que varios servicios independientes se comportaran como un único sistema coherente, con manejo real de errores, autorreparación y visibilidad sobre lo que está pasando en cada momento — no solo que "funcione", sino que siga funcionando solo con el tiempo. Lleva en producción de forma estable desde hace meses, con varias rondas de estabilización ya cerradas.