explaingit

magicmirrororg/magicmirror

📈 Trending★ 23,527JavaScriptAudience · vibe coderComplexity · 3/5ActiveLicenseSetup · moderate

TLDR

Open-source software that turns a mirror into a smart display showing weather, calendar, news, and more on a Raspberry Pi or small computer.

Mindmap

mindmap
  root((MagicMirror))
    What it does
      Smart mirror display
      Shows weather and news
      Calendar integration
      Modular plugins
    How it works
      Electron app
      JavaScript interface
      Raspberry Pi compatible
      Two-way mirror setup
    Use cases
      Home hallway display
      Bathroom information
      Smart home hub
      DIY projects
    Tech stack
      JavaScript
      Electron
      Node.js
    Audience
      DIY enthusiasts
      Raspberry Pi hobbyists
      Smart home fans

Things people build with this

USE CASE 1

Build a smart mirror for your hallway or bathroom that displays weather, time, and calendar events.

USE CASE 2

Create a personalized information display by installing and configuring community-made modules for news, traffic, or smart home control.

USE CASE 3

Set up a Raspberry Pi-based home project that shows real-time data without needing a separate web server.

Tech stack

JavaScriptElectronNode.jsHTML/CSS

Getting it running

Difficulty · moderate Time to first run · 30min

Requires Raspberry Pi or small computer with Node.js and display setup; Electron app needs X11/Wayland or framebuffer configured.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice and license text.

In plain English

MagicMirror² is an open-source platform that turns a regular mirror into a smart display. The idea is physical: you mount a monitor or screen behind a two-way mirror (the kind that looks like a regular mirror from one side but lets light through from behind), run this software on a small computer like a Raspberry Pi behind it, and the screen shows useful information, clocks, weather, calendar events, news, overlaid on your reflection. The platform is built around a modular plugin system, meaning you install and configure modules to choose what appears on the mirror. There is a large community of third-party modules available beyond the built-in ones. The software runs as a standalone app using Electron, a tool that packages web-based apps into desktop applications, so you don't need to set up a separate web server or browser, it runs directly on the device. The interface itself is built with JavaScript. You would use this if you enjoy DIY home projects and want a functional, personalized information display in your home, typically in a hallway or bathroom. It is especially popular with Raspberry Pi hobbyists and smart home enthusiasts. Setup requires some technical comfort (connecting hardware, running the software, editing configuration files), but the community provides detailed documentation and a forum for help.

Copy-paste prompts

Prompt 1
How do I install MagicMirror² on a Raspberry Pi and set up my first module to display the weather?
Prompt 2
Show me how to create a custom MagicMirror module that displays my Google Calendar events.
Prompt 3
What are the best community modules for MagicMirror² and how do I install them?
Prompt 4
Help me configure MagicMirror² to show multiple information panels on my smart mirror display.
Prompt 5
How do I troubleshoot MagicMirror² if modules aren't loading or the display isn't updating?
Open on GitHub → Explain another repo

Generated 2026-05-18 · Model: sonnet-4-6 · Verify against the repo before relying on details.