MagicMirror
MagicMirror² is an open source modular smart mirror platform.
Platform availability
Available on 3 of 10 platforms
Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.
74/100 Good
- Maintained
- 73last commit 51 days ago
- Popular
- 8824,162 GitHub stars
- Easy to install
- 553 install platforms, install notes, Docker image
- Light to run
- 602 GB minimum RAM, runs on ARM
- Security check
- 88no serious findings, 2 minor, CI, tests
Availability: platform listings confirmed today, links checked 14 days ago
- GitHub stars
- 24,162
- Open issues
- 6
- Last commit
- 2026-10-01
- Latest release
- v2.38.0
- License
- MIT
- Activity
- stale
Checked 22 days ago - source: GitHub (MagicMirrorOrg/MagicMirror)
Resources & Compatibility
Minimum requirements: 2 GB RAM. ARM (e.g. Raspberry Pi) is supported.
Checked 54 days ago - source: Docker Hub image tags and published docs
First-install notes
- Install the app's missing pieces Run node --run install-mm inside your MagicMirror folder before the first launch; this downloads required software and can take a long time, and without it the mirror may fail to start. source
- Start the mirror In the MagicMirror folder, run node --run start, or node --run start:windows on Windows. If your Linux display system is X11 rather than Wayland, use node --run start:x11 so the window appears on the right screen. source
- Keep your settings safe MagicMirror reads its setup from a JavaScript config file (a small code file that lists your modules). Keep a copy of it, or use the MM_CONFIG_FILE setting to point at another file, so you do not lose your modules or start the mirror with the wrong layout. source
- First start No setup is required. On first start the image writes a working config.js that listens on all interfaces and already permits the usual private network ranges, including 10.x, 172.16-31.x and 192.168.x. The template runs the container as user 99:100. source
Fetched 37 days ago - each note links to its source
Variants
Alternatives
No alternatives collected yet.
Common questions
How can I run MagicMirror so I can view it in a browser on another device?
Use the server scenario; it starts the server and lets you open the application in your browser of choice.
How can I avoid losing my module setup if the config file is overwritten?
Keep a copy of the JavaScript config file, or use the MM_CONFIG_FILE setting to point at another file.
What should I run before the first launch if MagicMirror fails to start because required software is missing?
Run node --run install-mm inside your MagicMirror folder before the first launch; this downloads the required software and can take a long time.
Which start command should I use on a Linux system that uses X11 instead of Wayland?
Use node --run start:x11 so the window appears on the right screen.
How can I display MagicMirror on a Raspberry Pi screen when another instance is already running?
Use the client scenario, which starts MagicMirror on the Raspberry Pi screen using another running MagicMirror instance.
Answers sourced from docs.magicmirror.builders, docs.magicmirror.builders, khassel.gitlab.io
Community
- Recent Topics | MagicMirror Forum (forum)
- General Discussion | MagicMirror Forum (forum)
- A community of DIY'ers and hackers building Magic Mirrors (reddit)
- Magic mirror, or something else? : r/selfhosted - Reddit (reddit)
- All things Magic Mirror - Reddit (reddit)
- Home | MagicMirror Forum (forum)
Collected 53 days ago - public community threads