Skip to content

khassel/mmpm

 
 

Repository files navigation

PayPal License Travis CI Docker Pulls PyPI version MagicMirror Package Manager

Author Contact
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.

Features

  • 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.

About

MagicMirror Package Manager

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 62.4%
  • TypeScript 25.1%
  • HTML 7.9%
  • Shell 2.6%
  • JavaScript 1.1%
  • SCSS 0.7%
  • Makefile 0.2%