Home

An open source modular smart mirror platform. With a growing list of installable modules, the MagicMirror² allows you to convert your hallway or bathroom mirror into your personal assistant. https://magicmirror.builders/

Check the documentation website to find out how to get started.

Default modules

The following modules are installed by default.

• Alert
• Calendar
• Clock
• Compliments
• Hello World
• News Feed
• Weather

Optional Modules

List of 3rd Party Modules

Installing a module

To install 3rd party or your own custom modules just follow these steps:

• Navigate to the modules folder via the following command: cd ~/MagicMirror/modules.
• Clone the module from GitHub: git clone https://github.com/author/module-name (remembering to replace the URL with that of the module on github).
• Follow any additional instructions in the module readme.
• Add your brand new module to your config! This is the file config/config.js that you duplicated earlier. Edit this in your favourite editor and add:

    {
        module: 'module name',
        position: 'position',
        header: 'optional header',
        config: {
            extra option: 'value'
        }
    },

to the list of modules. You can look at the default modules for examples and further details can be found on the main readme.