Skip to content
Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

PayPal License Travis CI Docker Pulls PyPI version MagicMirror Package Manager

Author Contact
Brandon Marlowe

MMPM, the MagicMirror Package Manager is a self updating command line and graphical interface designed to simplify the installation, removal, and maintenance of MagicMirror packages.

The MagicMirror Package Manager is featured as an alternative installation method on the MagicMirror Documentation.


  • Installation, removal, updating, and upgrading of packages
  • Search for and show package details
  • Adding external packages (think of it like PPAs for Ubuntu)
  • Tab-Autocompletion for the CLI
  • Quick MagicMirror config editing access
  • Installing MagicMirror
  • Hide/Show MagicMirror modules
  • Start/Stop/Restart MagicMirror (works with npm, pm2, and docker-compose)
  • RaspberryPi 3 screen rotation

Quick Installation Guide

sudo apt install libffi-dev nginx-full -y
python3 -m pip install --upgrade --no-cache-dir mmpm
mmpm --guided-setup
echo 'export PATH="$PATH:$HOME/.local/bin"' >> ~/.bashrc

Look to the Wiki

Make sure you've followed all the instructions for installation, configuring environment variables, and the hide/show modules feature setup.

Note: the Environment Variables setup is extremely important.

Creating Issues

Consult the Wiki before posting any issues, and use one of the provided templates (if possible) when filing an issue.

For any bugs encountered, examine the log files by running mmpm log. If creating a GitHub issue is needed, use one of the issue templates, and please attach the log files, your config.js, and provide what steps can be take to reproduce the bug. You can create a ZIP archive of the MMPM log files files through the Control Center of the GUI, or by running mmpm log --zip through the CLI. If for some reason you cannot access mmpm log --zip, you can find the files in ~/.config/mmpm/log and /var/log/nginx. All log files for MMPM in /var/log/nginx will be prefixed with either mmpm-access or mmpm-error.

GUI Preview

Control Center:

GUI Control Center

Config Editor:

GUI Config Editor

Active Processes:

GUI Active Processes

MMPM/MagicMirror Marketplace:

GUI MarketPlace

MMPM/MagicMirror Locally Installed Packages:

GUI LocalPackages

GUI Terminal:

GUI Terminal

Potential Problems

This project is entirely dependent on the structure of the MagicMirror 3rd Party Modules page. The HTML is parsed, and the appropriate text of each module is extracted. If for some reason any of the information is not displayed correctly, it is most likely due to someone changing the structure of the page. Ideally, in the future, a database will be constructed, and things will be handeled in a more formal, predictable way.