magic-frame
Magic Frame es un panel autoalojado para pantallas domésticas que combina marco digital, tablero familiar y dashboard de Home Assistant. Funciona localmente con sincronización en tiempo real, editor drag-and-drop e integraciones como Immich, sin depender de la nube.
Ficha actualizada 18 sept 2026, 21:17 · upstream 8 sept 2026, 10:48 · release v1.5.4
Qué es magic-frame
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Magic Frame transforma cualquier pantalla compatible con navegador —tablets, monitores o marcos— en un centro de control doméstico autoalojado. Utiliza una arquitectura basada en Next.js y React sobre Node.js, ejecutándose dentro de contenedores Docker para garantizar portabilidad y aislamiento. El sistema se conecta a una base de datos PostgreSQL para persistencia de datos y configuración.
- Tablero familiar: gestión de listas de la compra, tareas pendientes, calendario y clima en tiempo real.
- Hub de Smart Home: visualización de entidades de Home Assistant, botones de escenas, notificaciones y cámaras.
- Marco digital: rotación automática de fondos de pantalla sincronizados con Immich o WebDAV.
- Visualización de estado: monitoreo de consumo eléctrico, temporizadores y avisos rotativos en la pared.
- Pantalla de medios: reproductor multimedia mostrando portadas, progreso y controles de transporte.
- Información pública: códigos QR dinámicos o RSS feeds para mostrar noticias locales sin nube.
- Ejecución 100% local sin necesidad de cuenta en la nube ni dominio público.
- Editor visual drag-and-drop con actualizaciones en tiempo real entre dispositivos.
- Integración nativa profunda con Home Assistant y soporte para add-ons oficiales.
- Rotación de fondos de pantalla desde Immich o almacenamiento WebDAV local.
- Licencia Polyform Noncommercial 1.0.0 que permite uso libre y modificación personal.
- Soporte multiplataforma: Raspberry Pi, NAS, VPS, Mac mini o Home Assistant OS.
- Uso restringido a entornos no comerciales según la licencia Polyform NC.
- Requiere instalación manual de Docker y Compose en sistemas operativos nativos.
- Dependencia de servicios externos como PostgreSQL para persistencia de datos.
- Complejidad técnica elevada (HIGH) que exige conocimientos básicos de contenedores.
- No incluye soporte one-click para Windows o macOS sin Docker Desktop.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Despliegue recomendado mediante Docker Compose en un entorno Linux con al menos 4 núcleos CPU y 4 GB de RAM. Para Home Assistant, instálalo como add-on desde el repositorio oficial. Utiliza los puertos 80/443 para HTTPS y 5432 para PostgreSQL. Las actualizaciones se realizan vía script sin tocar datos ni configuraciones existentes.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.