First, download the appropriate installer or portable binary for your platform from the Downloads page.

Windows

Launch the .exe installer (x64 or ARM64). It installs the CLI and updates your PATH. Verify installation:

magic-mirror --version

Prefer a portable ZIP? Extract it and add the directory to your PATH:

# PowerShell
Expand-Archive magic-mirror_windows_amd64.zip -DestinationPath C:\Tools\MagicMirror
setx PATH "$env:PATH;C:\Tools\MagicMirror"
C:\Tools\MagicMirror\magic-mirror.exe --version

macOS

Open the downloaded .dmg (universal or arch‑specific) and drag Magic Mirror CLI.app to /Applications. A launcher script is added to /usr/local/bin so you can run it from the terminal:

magic-mirror --version

Prefer a portable build? Extract the tarball and move the binary into your PATH:

tar -xzf magic-mirror_darwin_universal.tar.gz
sudo mv magic-mirror /usr/local/bin/
chmod +x /usr/local/bin/magic-mirror
magic-mirror --version

Linux

Make the .AppImage (x86_64 or arm64) executable and run it, or move it to /usr/local/bin:

chmod +x magic-mirror-x86_64.AppImage
./magic-mirror-x86_64.AppImage --version

You can also use the static binary tarball:

tar -xzf magic-mirror_linux_amd64.tar.gz
sudo mv magic-mirror /usr/local/bin/
magic-mirror --version