MMM-Template

July 7, 2025 · View on GitHub

Use this template for creating new MagicMirror² modules.

See the wiki page for an in depth overview of how to get started.

MMM-Template

MMM-Template is a module for MagicMirror² that displays ... [Module description]

Screenshot

Example of MMM-Template

Installation

Install

In your terminal, go to the modules directory and clone the repository:

cd ~/MagicMirror/modules
git clone [GitHub url]

Update

Go to the module directory and pull the latest changes:

cd ~/MagicMirror/modules/MMM-Template
git pull

Configuration

To use this module, you have to add a configuration object to the modules array in the config/config.js file.

Example configuration

Minimal configuration to use the module:

    {
        module: 'MMM-Template',
        position: 'lower_third'
    },

Configuration with all options:

    {
        module: 'MMM-Template',
        position: 'lower_third',
        config: {
            exampleContent: 'Welcome world'
        }
    },

Configuration options

OptionPossible valuesDefaultDescription
exampleContentstringnot availableThe content to show on the page

Sending notifications to the module

NotificationDescription
TEMPLATE_RANDOM_TEXTPayload must contain the text that needs to be shown on this module

Developer commands

  • npm install - Install devDependencies like ESLint.
  • node --run lint - Run linting and formatter checks.
  • node --run lint:fix - Fix linting and formatter issues.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Changelog

All notable changes to this project will be documented in the CHANGELOG.md file.