Installation Guide
July 10, 2025 · View on GitHub
Installation
Download and install the MagicMirror installer for your operating system:
Install Dependencies (Windows)
For Windows users, you need to install the Microsoft Visual C++ Redistributable to run MagicMirror. Download it here: https://aka.ms/vs/17/release/vc_redist.x64.exe
Download Models
When you first launch the app, it will automatically download the required model files.
If the download progress is stuck at 0% or stops midway, follow these steps for manual setup:
Download Model Files
Choose the model file that matches your operating system:
Extract the Downloaded File
You'll get a folder—rename it to MagicMirror. Move this folder to your computer's HOME directory, for example:
Restart MagicMirror, and it should now work properly.
Launch APP
After downloading the model files, the first launch may take some time.
The app should launch within 3 minutes. If it takes longer than 10 minutes to start, please refer to the FAQ
Need help?
Most issues are addressed in the FAQ. If you need further assistance, please submit an issue.