24.1K ·GitHub
What is this?
MagicMirror2 is an open source modular smart mirror platform that turns a hallway or bathroom mirror into a personal assistant display, showing modules like weather, calendar, and news behind a two-way mirror glass.
MagicMirror2 is an open source modular smart mirror platform that turns a hallway or bathroom mirror into a personal assistant display, showing modules like weather, calendar, and news behind a two-way mirror glass.Is this a standalone app or a framework I build on?It's a modular application built with Electron as the display wrapper, so it runs as a desktop app with no separate web server or browser install needed, and you extend it by installing or writing modules.
It's a modular application built with Electron as the display wrapper, so it runs as a desktop app with no separate web server or browser install needed, and you extend it by installing or writing modules.How do I get it running?Follow the installation instructions on the dedicated documentation website, then run it via npm scripts (e.g. 'install-mm' to install production dependencies and 'start' to launch).
Follow the installation instructions on the dedicated documentation website, then run it via npm scripts (e.g. 'install-mm' to install production dependencies and 'start' to launch).What do I need before installing it?You need Node.js (version >=22.21.1 =24) and npm; for development/testing it also installs Playwright with Chromium.
You need Node.js (version >=22.21.1 =24) and npm; for development/testing it also installs Playwright with Chromium.Does it only run on a Raspberry Pi behind a mirror, or can I use it elsewhere?It's commonly built into Raspberry Pi based mirror setups, but since it runs on Node.js and Electron it works cross-platform on any machine that can run those, not just a Pi.
It's commonly built into Raspberry Pi based mirror setups, but since it runs on Node.js and Electron it works cross-platform on any machine that can run those, not just a Pi.Can I add custom features myself?Yes, MagicMirror2 is built around a modular plugin system, so you can write your own modules or install community-made ones to add new widgets to the mirror display.
Yes, MagicMirror2 is built around a modular plugin system, so you can write your own modules or install community-made ones to add new widgets to the mirror display.Do I need a physical two-way mirror to try this?No, the software itself just runs as an Electron app showing modules on screen; the two-way mirror glass and frame are a separate hardware build you add afterward.
No, the software itself just runs as an Electron app showing modules on screen; the two-way mirror glass and frame are a separate hardware build you add afterward.Why Electron instead of a web server and browser?The project switched to Electron as the application wrapper so users don't need to run a separate web server or install a browser to view the mirror interface.
The project switched to Electron as the application wrapper so users don't need to run a separate web server or install a browser to view the mirror interface.What are similar projects?homebridge, CasaOS, core, neonplan3d, kindle-wall-display, RuView, ha_xiaomi_home, deepseek-harness-desktop
homebridge, CasaOS, core, neonplan3d, kindle-wall-display, RuView, ha_xiaomi_home, deepseek-harness-desktopWhich topics is it in?home-automation, iot, raspberry-pi, electron, dashboard, plugin, gui, npm, desktop-app, nodejs, javascript, cross-platform
home-automation, iot, raspberry-pi, electron, dashboard, plugin, gui, npm, desktop-app, nodejs, javascript, cross-platform