Skip to content
See what's playing in your Google Cast device right in your MagicMirror
JavaScript HTML Python CSS
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
icons MMM-GoogleCast released! May 21, 2019
lib MMM-GoogleCast released! May 21, 2019
screenshots MMM-GoogleCast released! May 21, 2019
translations MMM-GoogleCast released! May 21, 2019
.gitignore Hotfixes for the description and the mockup May 21, 2019 MMM-GoogleCast released! May 21, 2019
MMM-GoogleCast.css MMM-GoogleCast released! May 21, 2019
MMM-GoogleCast.js MMM-GoogleCast released! May 21, 2019
node_helper.js MMM-GoogleCast released! May 21, 2019
package.json MMM-GoogleCast released! May 21, 2019


See what's playing in your Google Cast device (Chromecast, Chromecast Audio, Android TV, JBL Speakers...) inside your mirror. Compatible with, virtually, any app.


This module for MagicMirror displays the status of a Google Cast device (volume, which app is connected, whether the media is buffering, playing or in pause...) and information about the media that is being casted to the device (album cover, title, album name, artists, album artist...). Although this module was mainly aimed at music media, it can also work with video content (from platforms like Netflix), but the information displayed might not be as complete.

Some technical stuff

As said above, the information displayed for video content might not be as complete as with music, as all the information displayed depends on how many information about the media is given by the app, so it's more an app's developer problem than mine =D. The module just receive the media events from the Google Cast device without having specific apps in consideration (that's why this module is universal and works with "virtually" any app). You can make and propose Pull Requests to improve video content compatibility. Any contribution is always welcome!

This module works by using a Python script and the module pyChromecast as a backend, as well as python-shell to communicate between the mirror and the Python script.


You can see a mockup of the module in this page.


Step 1: One-line installation through terminal:

sudo apt install python3 python3-pip -y && sudo apt clean && sudo pip3 install pychromecast && cd ~/MagicMirror/modules && git clone && cd MMM-GoogleCast && npm install && echo "Installation succesfull"

Step 2: If you see the message "Installation successfull", the first step is done! Now run:


This will scan all your Google Cast devices in your network, so make sure the device you want to link to your mirror is up and running. A list similar to this one will be displayed:

Name: Living Room speaker
Type: audio
ID: xxxxxx-xxxxxxx-xxxxxxxx-xxxxxx
Name: Bedroom TV
Type: video
ID: yyyyyy-yyyy-yyyyyyyy-yyyyyy
Name: All Speakers
Type: group
ID: zzzzzz-zzzzz-zzzzzzz-zzzzzz

As you can see, you can also link audio groups apart from individual video and speakers devices. Note the ID of the device you want to link to your mirror. If no devices are detected, go to "Issues" section below

Step 3: Copy and paste this in your config.js file, replacing the device property with the ID of the device you want to link to your mirror:

			module: 'MMM-GoogleCast',
			position: "top_left",
			classes: "default everyone",
			header: "Google Cast",
			config: {

And everything is done! You should now see the media that's being played in your mirror


  • Volume Bar doesn't works well/it's ugly

Refer to this issue.

  • The device is not detected in my network although the ID is correct

1.: Please, really make sure that you have put the appropiated ID in the config.js, without spaces at the end and anything else strange, just as it's displayed in Step 2. The best you can do is to copy/paste it, as it's easy to confuse a letter or an O between a 0 inside a bunch of random characters.

2.: The module is prepared for handling random disconnections from the device. Try rebooting it, it should connect after a while itself. If that doesn't help, reboot the mirror and your Chromecast device.

3.: Refer to this Google Help article for more basic troubleshooting steps.

4.: If none of the above worked, I'm happy to help. But, please, open an issue making sure you include the following:

  • Your config.js section of MMM-GoogleCast.
  • The output of the script you ran in Step 2 during installation (`
  • Run MagicMirror through npm if you are using pm2 to start MagicMirror at boot time. pm2 stop MagicMirror && cd ~/MagicMirror. After that, run npm start. Paste all the messages starting with ```MMM-GoogleCast`` in your issue, please.


This module wouldn't be possible without the amazing work of MichMich in MagicMirror and balloob, the developer of the pyChromecast library for Python. Also, huge kudos to python-shell developers, which allowed me to exchange data between the Python script and node. Mention to paviro as well, as I used his module as a "template" to know the basics of python-shell. It would have been so much difficult to use MagicMirror alongside Python script without his help.

You can’t perform that action at this time.