Module for Magic Mirror that supports ecobee Thermostat
Find a file
2025-04-01 17:21:46 -05:00
.github/workflows Update to supported nodejs versions 2025-04-01 17:21:46 -05:00
.vscode Correct/unify formatting, add eslintrc 2020-10-28 09:33:30 -05:00
images Replace pngs with svgs 2020-10-30 21:19:50 -05:00
.eslintrc Correct/unify formatting, add eslintrc 2020-10-28 09:33:30 -05:00
.gitignore Start refactor 2020-10-27 22:08:49 -05:00
LICENSE Initial commit 2018-04-03 13:27:22 -04:00
MMM-Ecobee.css Fix icons having a black fill 2020-11-01 09:11:54 -06:00
MMM-Ecobee.js Add config settings for showing humidity and set temperature 2020-12-12 21:31:09 -06:00
node_helper.js Handle specific errors to skip resetting auth 2023-11-07 07:21:46 -06:00
package-lock.json Update dependencies 2023-08-15 12:05:27 -05:00
package.json Fix lint script 2023-08-15 12:15:35 -05:00
README.md Add note about fixing auth errors 2023-11-07 13:47:38 -06:00
sample.png Add a sample image of the module to the readme 2020-11-01 10:11:48 -06:00

MMM-Ecobee

Module for MagicMirror² that supports ecobee thermostats.

Dependencies

Installation

  1. Clone this repo into MagicMirror/modules directory.
  2. Configure your MagicMirror/config/config.js:
{
  module: 'MMM-Ecobee',
  position: "top_left",
  config: {
  }
}

Ensure that the user running MagicMirror has write access to the module's directory so that the module can save the authentication token. If you are unable to do this for any reason, you can instead create a tokens.json file in the module's directory yourself and chown it to the user who is running MagicMirror.

Authorizing the module on your ecobee account

To authorize this application to access your Ecobee:

  1. Go to https://auth.ecobee.com/u/login
  2. Log in to your thermostat console
  3. Select My Apps from the menu on the top right.
  4. Click Add Application
  5. Enter the code provided.

Codes refresh every ~10mins. The module will check for the completed authorization every 30sec.

If a code is not used for a long time (Magic Mirror is off, module is turned off, etc.) a new authorization may be required.

See the Installation section above for notes about how authorization is stored and how to fix it if it doesn't seem to remember the authorization token.

Config Options

Option Default Description
updateInterval 5 * 60 * 1000 How often to update the thermostat's data, in milliseconds. Defaults to 5 minutes. This cannot be less than 3 minutes, per ecobee.
showSensors true If true, will show thermostat(s) as well as remote sensor(s). If false, will only show thermostat(s).
showHumidity true If true, will show current humidity for a thermostat, if available.
showSetTemperature true If true, will show the temperature a thermostat is set to cool/heat to.

Screenshot

Screenshot