README.md
May 3, 2026 ยท View on GitHub
| Author | Contact | Support |
|---|---|---|
| Brandon Marlowe | bpmarlowe-software@protonmail.com | ![]() |
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.
Quick Installation Guide
MMPM can be installed as a Docker image, or through pip.
Docker
docker pull karsten13/mmpm
pip
python3 -m pip install --upgrade mmpm
Ensure Your PATH is Correct
echo 'export PATH="$PATH:$HOME/.local/bin"' >> ~/.bashrc && source ~/.bashrc
Features
- Manage packages: install, remove, update, and upgrade.
- Search and view package details.
- Add custom packages (similar to Ubuntu PPAs).
- CLI tab-autocompletion.
- Easy access to MMPM and MagicMirror configuration.
- Manage MagicMirror: install, upgrade, remove.
- Control MagicMirror modules: hide/show (details)
- Control MagicMirror state: start, stop, restart (supports npm with automatic X11/Wayland/Windows detection, pm2, docker-compose).
- Mirror Preview: drag-and-drop interface for arranging modules across MagicMirror regions, with direct read/write of
config.js.
Look to the Wiki
Key Pages:
- Installation & Removal
- UI Installation & Removal
- Environment Variables (Extremely important)
- Hide/Show MagicMirror Modules
