Quick Links

If you built a smart mirror, you already have handy access to calendars, weather, and news. But you can do more than that! The Magic Mirror software lets you add modules for extra features, like Alexa for voice control.

Other developers create these modules. The options vary from the useful, like Alexa or presence detection (through a camera or Passive Infrared sensor), to the entertaining, like snowflakes and Spotify playback info.

We recommend mmm-awesome-alexa as it appears to be well maintained by an active developer, although there are other Alexa modules for the Magic Mirror software.

If you would prefer to install Google Assistant, Google offers a complete tutorial for installing Assistant on a Raspberry Pi, including steps, images, and download links. While a few Magic Mirror modules for Google Assistant exist, our investigation revealed the modules to be problematic, often crashing or covering the mirror information. If you want the most straightforward setup, we recommend adding the Google AIY kit and using its specific tutorial.

To install most modules, you'll go through some basic steps:

  1. Download the module code from GitHub
  2. Configure module-specific options
  3. Add the module to the mirror configuration

Depending on the module, steps two and three may be more or less involved. Setting up Alexa requires more configuration than adding snowflakes, for instance. Additionally, this particular Alexa module requires installing some additional software (dependencies) before downloading the module.

Related: How to Build Your Own Futuristic Smart Mirror

The Materials You'll Need

A Google AIY voice kit
Google

This guide assumes you've already created a Smart Mirror. If you haven't yet, start there but keep in mind the extra materials listed here in your costs and space considerations.

  • Completed Smart Mirror
  • Microphone
  • Speaker

For the microphone and speaker, we recommend the original Google AIY Voice Kit. At $16, you'll be hard-pressed to find a cheaper microphone and speaker combination. You don't necessarily need to use the included cardboard box; it may be more effective to leave the components out and run the microphone and speaker outside the mirror.

A second version of the Google AIY Voice Kit is available, but it's more expensive and includes a Raspberry Pi Zero, which isn't powerful enough to run wake words or the Magic Mirror software, so you should skip it.

Connect your speaker and microphone, and you're ready to install the Alexa module. If you're using the Google AIY kit, just follow its assembly guide for connecting the microphone and speaker components.

Installing Module Dependencies

Before you can download and configure mmm-awesome-alexa, you need to install a few dependencies the module relies on. It's always a good idea to update your Raspberry Pi before trying to install anything else. On your Raspberry Pi, start by running this command:

sudo apt update && sudo apt upgrade

Once your Raspberry Pi is up to date, run the following commands one by one:

sudo apt-get install sox libsox-fmt-all

sudo apt-get install swig3.0 python-pyaudio python3-pyaudio sox

pip install pyaudio

sudo apt-get install libasound-dev portaudio19-dev libportaudio2 libportaudiocpp0 ffmpeg libav-tools

sudo apt-get install libatlas-base-dev

Each command installs a dependency, and they're all necessary to run. Just run a command, wait for the download and install to finish, then run the next command.

Downloading the Module Code

The first step to adding any module for the Magic Mirror is to download the module's code Github. To do this, you'll need to log into the Raspberry Pi, open terminal, and change directory to where modules are stored. Then you'll use a download command to pull the code from Github If you have shell access, you can do all of this remotely.

Once you have a terminal open, type the following:

cd ~/MagicMirror/modules

This command moves you to the working directory of the modules folder for the Magic Mirror software. Anytime you download a new module, you'll want to be here to keep everything organized. The next step is to download the software from Github with this command:

git clone https://github.com/dolanmiu/MMM-awesome-alexa.git

When it finishes, change directories into the module with the following command:

cd MMM-awesome-alexa

The Alexa module requires a few additional dependencies to work correctly. Run this command to install them:

npm install --only=prod

Now, change directories into the newly created node_modules folder:

cd node_modules

Delete the snowboy folder the previous commands added. We need a newer version of snowboy:

rm -rf snowboy

Next, we'll download the latest version of snowboy with the following command:

git clone https://github.com/Kitt-AI/snowboy.git

Before we continue, change directory to the new snowboy folder.

cd snowboy

Now we need to remove the node_modules folder and install some additional dependencies. It's important that you stay inside the snowboy folder for these steps; don't change directories. Run the following commands one by one:

rm -rf node_modules

npm install nan --save 

npm install node-pre-gyp@0.12.0 --save 

npm install 

npm run prepublish 

npm install --save-dev electron-rebuild 

npm install nan 

./node_modules/.bin/electron-rebuild

Now the module is fully downloaded and installed.

Configuring the Alexa Module

Config-helper dialog for MMM-awesome-alexa

Now that the mmm-awesome-alexa module is installed, we need to configure it. The first step is to change directories to the root of the module. In terminal type the following command and then hit Enter:

cd ~/MagicMirror/modules/MMM-awesome-alexa

This Alexa module has a configuration helper; we want to run that. In terminal type:

npm run config-helper

You'll see a prompt asking for a Client ID. Since you're essentially setting up a custom-built Echo, you'll need to open a browser and head to the Alexa developer site. Then sign in with your Amazon account.

Once signed in, click on the "Get Started" button. You're creating a device, so click "Products" and click "Create Product."

Alexa developer dialog with box around Products option.

On the next screen, give your product a name and product ID---we suggest "Magic_Mirror_Alexa" for the name and "YourFirstName_MM_Alexa" for the product ID. Select Smart Home for the category, and enable both the hands-free and far-field options. You'll see a series of yes or no questions, select "No" for all of them and then click "Next."

On the security profile screen, click "Create new profile." Use the same name for your security profile as you did for the product ID. Then type any description you would like, then click Next.

Check the agreement and click Finish.

Click on your newly created product, then security profile, and you should see a Client ID and client secret.

In the allowed return URL entry type:

https://magic-mirror-avs.github.io/Alexa-Web-Helper/authresponse

Then click the add button. Scroll down and click the update box to finish adding the URL.

In the terminal, you'll see a prompt for the client ID. Copy the client ID from the browser, paste it into the Terminal, and then hit Enter. Now the terminal will prompt for a client secret. Switch back to the browser, copy the client secret, then paste it into Terminal and hit Enter.

When prompted for the Device ID, Enter the name you created above as a product ID (Magic_Mirror_Alexa in our example).

When you're asked to provide a return URL, type the following command and press Enter:

https://magic-mirror-avs.github.io/Alexa-Web-Helper/authresponse

The terminal will display a custom built link. Copy that and paste it into your browser. Then log in with your Amazon account, if prompted. Click Allow on the next screen.

Alexa voices services permissions prompt with box around allow button.

You'll see an error on the browser, but don't worry! This is expected. Scroll through the URL of the error page and find the "Code=xxxxxx" section.

URL showing Alexa device code.

Copy the letters and numbers that appear between "code=" and "&scope" and paste them into the terminal. Hit Enter when you're done.

When asked if you want to generate the MagicMirror config, type Y, and hit Enter.

You'll be asked which wake word to use. Alexa is the default selection so hit Enter.

Answer no for using lite mode and visualization.

The configuration helper will generate your module information. It will look something like this:

{

module: "MMM-awesome-alexa",

position: "bottom_bar",

config: {

wakeWord: "Alexa",

clientId: "YOUR_CLIENT_ID",

clientSecret: "YOUR_CLIENT_SECRET",

deviceId: "YOUR_DEVICE_ID",

refreshToken: "YOUR_REFRESH_TOKEN",

lite: false,

isSpeechVisualizationEnabled: false

}

}

Auto-generated module code.

Copy those lines. We need to add them to the Magic Mirror configuration.

Add the Alexa Module to the Magic Mirror Configuration

Then change directory to the Magic Mirror config folder with the following command:

cd ~/MagicMirror/config

And open the config.js using the nano command:

nano config.js

Just after the first instance of }, (which is the end of the module) hit Enter to create a blank line before the next { entry (which is the start of a new module).

modules code, with a newline inserted after }, and before {

On the new blank line you created, paste in the module code from the config helper steps. The auto-generated code does have a mistake; you'll also need to type a comma after the final bracket so that your module ends with },

inserted module code with a comma added after the final bracket

Use Ctrl+x to close the file. When prompted, type "y" to confirm the save and hit Enter to keep the file name the same.

The module is completed. To restart your Magic Mirror software with the module in place, type pm2 restart mm and the Magic Mirror software will reboot. Alexa should now work on your Magic Mirror.

This is one of the more complicated modules you can set up for the Magic Mirror. But for other modules, the basic steps are the same, download the code, configure module-specific options, add the module to configuration. You can add snowflakes to your mirror, or motion detection, or even display your Google Photos.