/MMM-Tado

A MagicMirror Module for your Tado Smart Thermostat.

Primary LanguageJavaScriptMIT LicenseMIT

MagicMirror Module: MMM-Tado

A MagicMirror Module for your Tado Smart Thermostat.

The module displays the following information:

  • A symbol to show if the heater is currently active.
  • The current temperature
  • The target temperature
  • The humidity
  • The hot water temperature, if not available; the current power state

Screenshot

screenshot

Installation

In your terminal, go to your MagicMirror's Module folder:

cd ~/MagicMirror/modules

Clone this repository:

git clone https://github.com/WouterEekhout/MMM-Tado

Install NPM dependencies from inside the MMM-Tado folder:

cd MMM-Tado/
npm install

Configure the module in your config.js file.

Using the module

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

units: 'metric',

modules: [
    {
        module: 'MMM-Tado',
        position: 'top_right', // This can be any of the regions.
        config: {
            username: 'your_tado_username', 
            password: 'your_tado_password', 
            updateInterval: 300000
        }
    }
]

Configuration options

The following properties can be configured:

Option Description
username Required - Your Tado username.
password Required - Your Tado password.
updateInterval Optional - In milliseconds the update interval. Default: 300000 (5 minutes). This value cannot be lower than 300000. Otherwise users get a Tado block.
units What units to use. This property can be set in the general configuration settings. See the MagicMirror Documentation for more information.

This module is powered by the Tado API.

Credits

This module is highly inspired by the MMM-Toon module: https://github.com/MichMich/MMM-Toon.

Using the NPM package node-tado-client: https://github.com/mattdavis90/node-tado-client