Skip to content


Repository files navigation


This is a module for the MagicMirror². It pulls data (name + job, bin and battery status) from a Roomba running on the local network using Dorita980 and displays them on the mirror.

Alt text


  1. Navigate into your MagicMirror's modules folder and execute git clone A new folder will appear navigate into it.
  2. Execute npm install to install the node dependencies.

Using the module

To use this module, add the following configuration block to the modules array in the config/config.js file:

var config = {
    modules: [
            module: 'MMM-Roomba',
            position: 'top_right',
            header: 'Roomba', // Optional
            config: {
                // See below for configurable options
                robots: [
                        username: 'xxxxxxxxxxxxx',
                        password: ':1:1486937829:gktkDoYpWaDxCfGh',
                        ipAddress: ''

Configuration options

Option Description
robots Required Array of robot objects. See below
robots[].username Required Username of Roomba. See Dorita980 for more information.
robots[].password Required Password of Roomba. See Dorita980 for more information.
robots[].ipAddress Required Local IP address of Roomba. See Dorita980 for more information.
updateInterval Optional How often the content will be fetched.

Type: int(milliseconds)
Default 60000 (1 minute)
animationSpeed Optional Speed of the update animation.

Type: int(milliseconds)
Default 2000 milliseconds (2 seconds)

Known Issues

  • Error: SSL routines:OPENSSL_internal:NO_CIPHER_MATCH - Node v12

    Solution: ROBOT_CIPHERS=AES128-SHA before staring MagicMirror