Self-host magic-frame
v1.5.10Drag-and-drop home dashboard for tablets and picture frames
- Stars
- 511
- Ports
- 80 (HTTP (Caddy reverse proxy)), 443 (HTTPS (Caddy reverse proxy with automatic Let's Encrypt)), 3000 (Internal app port (exposed only within Docker network))
- Requires
- PostgreSQL
ghcr.io/jeremiaa/magic-frame-app
What is magic-frame?
Magic Frame is a self-hosted dashboard for turning any browser-capable screen into a versatile home display. It works as a family board with shopping lists, calendars, and weather; a smart-home hub with live Home Assistant entity updates, camera feeds, and scene buttons; a picture frame rotating wallpapers from Immich or WebDAV; and a status display showing device activity. A drag-and-drop editor on a 24-column grid lets you build layouts with live preview, and changes sync to all connected displays in under 100 ms via WebSocket. It runs via Docker Compose with pre-built multi-arch images (works on Raspberry Pi 4/5), as a Home Assistant add-on, or on Kubernetes via a community Helm chart. The license is Polyform Noncommercial 1.0.0 — free for non-commercial use by individuals, households, clubs, NGOs, and schools; commercial use requires a separate license.
Should you self-host magic-frame?
magic-frame scores 52/100 on selfhost.directory (how scoring works) and ranks #58 of 104 in Home Automation. It has 511 GitHub stars.
It shipped 21 stable releases in the past year. The latest, v1.5.10, came out on 27 October 2026. New versions land roughly every 3 days.
Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is Other-licensed and written mostly in Typescript.
Its closest alternative on selfhost.directory is home-screens (50/100, 89 stars). magic-frame scores higher overall. See magic-frame vs home-screens side by side.
Features
- 2FA TOTP authentication
- Automatic HTTPS with Let's Encrypt
- Calendar widgets
- Custom widgets via JS modules
- Drag-and-drop dashboard editor
- Family widgets
- Home Assistant Integration
- Immich wallpaper integration
- Live sync across displays
- MCP server for AI agents
- Media player widget
- Notification tiles
- Picture frame mode
- Status cards
- Weather widgets
magic-frame README
More in Digital Signage
open-signageSelf-hosted digital signage platform built with Laravel that manages PDF-based presentations across monitors, groups, and schedules with LDAP authentication.
screenliteSelf-hosted open-source digital signage CMS with web UI. Built with Fastify, React, PostgreSQL, Redis. Has TOTP 2FA, sandboxed FFmpeg. Early alpha.
ScreenTinkerSelf-hosted digital signage CMS for TVs and kiosks across many platforms with playlists, scheduling, and integrations for Microsoft 365, Google Workspace, and Power BI.
spacepadSelf-hosted, open-source meeting room display turning tablets into availability panels with real-time calendar sync for Google, Microsoft 365, and CalDAV.
XiboXibo is a self-hosted, open-source digital signage platform for managing content across displays via a web CMS and multi-platform players, deployed with Docker.
Xibo CMSSelf-hosted open-source digital signage software with a web-based CMS for managing screen content, schedules, and player devices. Deployed via Docker Compose.
anthiasFree open-source digital signage platform for Raspberry Pi and x86 PCs. Schedule images, videos, web pages with no subscriptions or per-screen fees.
garlic-hubSelf-hosted open-source digital signage CMS using SMIL for playlists, managing devices and content with multi-zone layouts, REST API, and player-agnostic compatibility.
home-screensSelf-hosted, open-source smart display turning a Raspberry Pi into a customizable family dashboard with 45 modules, visual editor, and zero cloud dependency.
0 comments