joanaz / MMM-MirrorMirrorOnTheWall

MagicMirror² module: Displays text, images, or a Youtube video, and open or close Magic Mirror Modules according to commands heard by Alexa.
MIT License
93 stars 20 forks source link
alexa aws-iot google-images magic-mirror-modules magicmirror youtube

MMM-MirrorMirrorOnTheWall

This is a module for the MagicMirror. It uses AWS IoT Device Gateway to receive commands from Alexa, then displays text/images/video on the Magic Mirror, and turn on/off Magic Mirror Modules according to the commands.

You have to setup Alexa, and install the MirrorMirrorOnTheWall Alexa Skill before using this module. Please follow the Instructions.

Dependencies

Configuration

The entry in config.js can look like the following. (NOTE: You only have to add the variables to config if want to change its standard value.)

{
    module: 'MMM-MirrorMirrorOnTheWall',
    position: "middle_center",
    config: {}
}

Usage

If you have setup the complementary Alexa skill as instructed, you should be able to invoke it by saying "Alexa, start On The Wall", or "Mirror Mirror On The Wall" if you changed your wake word to "Mirror Mirror". Next you can say any of the following commands to trigger different actions on the Magic Mirror.

Display text

The text in {} will be displayed on Magic Mirror in bold.

Display images

The text in {} will be searched by Google Image Search API, and the returned images will be displayed on Magic Mirror, with the text.

Display video

The text in {} will be searched by Youtube Data API, and the returned video will be displayed on Magic Mirror, with the text. The Youtube video autoplays on loop.

Turn on/off Magic Mirror Modules

To turn on/off a Magic Mirror Module, it has to be installed and configured in the main project already. You also have to map its official module name to a transcribable spoken name in ModuleNames.json. For example, "MMM-Globe" maps to "globe", "currentweather" maps to "current weather".

To turn on a Magic Mirror Module, say:

To turn off a Magic Mirror Module, say:

Note: To clear the text/images/video displayed by this module, you can simply turn this module off.

To turn on all Magic Mirror Module, say:

To turn off all Magic Mirror Module, say: