Skip to content
Magic Mirror module for Kalliope
Branch: master
Clone or download
Sispheor Update MMM-kalliope.js
comment out blocking line on last version of Chrome
Latest commit 996597c Jul 24, 2018
Type Name Latest commit message Commit time
Failed to load latest commit information.
MMM-kalliope.js Update MMM-kalliope.js Jul 24, 2018 add doc on how to implement notification Mar 10, 2018
node_helper.js handle JSON and plain text payload Feb 18, 2018


Module to bind Kalliope with your Magic Mirror.

This module allow you to:

  • show what Kalliope say on the screen
  • control your Magic Mirror by sending notification to other active modules

Note: On Kalliope, a neuron is available to talk with this module directly.


Video demo with sound here


Clone this repo into ~/MagicMirror/modules directory.

Configure your ~/MagicMirror/config/config.js:

    module: "MMM-kalliope",
    position: "upper_third",
    config: {
        title: "Kalliope"

Configuration option

Option Default Description
max 5 How many messages should be keept on the screen.
keep_seconds 5 Number of seconds received messages will stay displayed. If set to "0", then message will never be removed
title Kalliope The name placed above received messages

API documentation

POST /kalliope/

Query parameters

Parameter Description
notification The notification identifier. If set to "KALLIOPE", the payload will be printed by the module. In other case the notification is sent to all other modules
payload A notification payload to pass to the module. Can use plain text or JSON.

Curl examples

This command will send a message that will be printed by the MMM-kalliope module

curl -H "Content-Type: application/json" -X POST -d '{"notification":"KALLIOPE", "payload": "my message"}' http://localhost:8080/kalliope

Here the notification is sent to the alert module.

curl -H "Content-Type: application/json" -X POST -d '{"notification":"SHOW_ALERT", "payload": {"title": "mytitle", "message": "this is a test", "timer": 5000}}' http://localhost:8080/kalliope

How to control my MM module from this module

All notifications that are not concerned by this module (when the notification name is not "KALLIOPE") will be send to other installed module on your Magic Mirror.

To add a notification receptor to your module, you just need to implement the notificationReceived method like bellow.

notificationReceived: function(notification, payload){

		if (notification === "NOTIFICAION_NAME" && payload=="bla"){
			// Do some magic here with your module

		if (notification === "NOTIFICAION_NAME" && payload=="blablabla"){
			// Do some magic here with your module

You can’t perform that action at this time.