Skip to content

Getting started

ManuelKlettner edited this page May 23, 2021 · 3 revisions

After starting the MM-Remote app, tab on the ➕ on the bottom-right to add you MagicMirror.

  • Give your mirror a name
  • Add it's IP-address to the next field (e.g. something like 192.168.0.0). You can get the IP-address by typing hostname -I in the console of the raspberry pi
  • The last field requires the apiKey you have specified for the MMM-Remote-Control module in the config.js of your mirror (make sure it is correct, otherwise the app will not be able to communicate with the mirror)

How to get your apiKey:
Open the config.js file and search for MMM-Remote-Control. It should look something like this:

{
    module: 'MMM-Remote-Control'
    config: {
        apiKey: 'bc2e979db92f4741afad01d5d18eb8e2'
    }
},

If you can't find the attribute 'apiKey', add it to your config. You can choose the value of this attribute by yourself. Don't make it to simple, think about it as a password for your mirror. This is the value you need to add in the apiKey field when creating a device in the MM-Remote app. You can find more information about the apiKey here.

Now you should be able to remote control your mirror. If you want to reorder or hide some default commands displayed in the HOME tab, go to settings and check ✅ the default command boxes in the order in which these commands should be displayed. Keep in mind, if you don't use all the modules mentioned under dependencies, some buttons might not work (e.g. changing the displayed UI-pages of your mirror via the left and right arrows on the bottom only works if you are using the MMM-Pages module).
You can always create you own commands in the CUSTOM-COMMANDS tab to extend the functionalities of the app. For more detailed instructions look at wiki/custom-commands. If there are any MagicMirror modules for which it is impractical to create your own CUSTOM-COMMANDS (e.g. because you need text input fields, a slider or many buttons) let me know, I might consider creating 🔧 a default command for it in future releases.

Clone this wiki locally