Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/CFenner/MMM-Netatmo
A module for the MagicMirror to display information about your rooms climate from your Netatmo system.
https://github.com/CFenner/MMM-Netatmo
magic-mirror-modules magicmirror netatmo netatmo-weather-station
Last synced: 23 days ago
JSON representation
A module for the MagicMirror to display information about your rooms climate from your Netatmo system.
- Host: GitHub
- URL: https://github.com/CFenner/MMM-Netatmo
- Owner: CFenner
- License: mit
- Created: 2016-01-28T07:33:07.000Z (almost 9 years ago)
- Default Branch: main
- Last Pushed: 2024-04-30T18:04:23.000Z (8 months ago)
- Last Synced: 2024-05-01T22:43:02.598Z (8 months ago)
- Topics: magic-mirror-modules, magicmirror, netatmo, netatmo-weather-station
- Language: JavaScript
- Homepage:
- Size: 858 KB
- Stars: 33
- Watchers: 7
- Forks: 32
- Open Issues: 14
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
- awesome-mmm - **MMM-Netatmo**
README
[![Validation](https://github.com/CFenner/MMM-Netatmo/actions/workflows/validation.yml/badge.svg)](https://github.com/CFenner/MMM-Netatmo/actions/workflows/validation.yml)
[![Known Vulnerabilities](https://snyk.io/test/github/cfenner/magicmirror-netatmo-module/badge.svg)](https://snyk.io/test/github/cfenner/magicmirror-netatmo-module)
[![code climate](https://codeclimate.com/github/CFenner/MMM-Netatmo/badges/gpa.svg)](https://codeclimate.com/github/CFenner/MMM-Netatmo)
[![JavaScript Style Guide](https://img.shields.io/badge/code_style-neostandard-brightgreen.svg)](https://github.com/neostandard/neostandard)
[![api](https://img.shields.io/badge/api-Netatmo-orange.svg)](https://dev.netatmo.com/doc)
[![All Contributors](https://img.shields.io/github/all-contributors/CFenner/MMM-Netatmo/main)](#contributors-)
[![License](https://img.shields.io/github/license/mashape/apistatus.svg)](https://choosealicense.com/licenses/mit/)# MMM-Netatmo
A module for [MagicMirrorΒ²][mirror] to integrate information from a [Netatmo weather station][weather-station].
![Netatmo visualisation](https://github.com/CFenner/MagicMirror-Netatmo-Module/blob/main/.github/preview.classic.png)
![Netatmo visualisation](https://github.com/CFenner/MagicMirror-Netatmo-Module/blob/main/.github/preview.bubbles.png)## Usage
Prerequisites:
To use this module you need to have access to a [Netatmo weather station][weather-station].
### Installation
Navigate into your MagicMirror's modules folder and clone the repository:
```shell
cd ~/MagicMirror/modules && git clone https://github.com/CFenner/MMM-Netatmo netatmo
```:warning: Note that the checkout folder is named `netatmo` and not `MMM-Netatmo` as the repository.
Since v2.1.0: **No special dependencies and no others commands are now needed!**
### Connection to Netatmo Service API
To be able to access your data, you need to have an Netatmo Application. Create your personal app in the [Netatmo developer portal][dev-portal] and you will get an `APP_ID` and an `APP_SECRET` which you will need to enter in your [mirror configuration](#configuration). On the same page, scroll to *Token Generator* and create a token with the `read_station` scope. During that process you will grant your previously created Netatmo app access to your Netatmo weather station. You will actually not need the `access_token`, but the `refresh_token`. This will also go into your mirror configuration.
#### Sample Data
If you don't have a Netatmo station yet, you can request a set of mock data by configuring `mockData: true` in the module configuration. In that case you don't need any user of app credentials.
### Configuration
To run the module properly, you need to add the following data to your config.js file.
```js
{
module: 'netatmo',
position: 'bottom_left', // the location where the module should be displayed
header: 'Netatmo', // a header if you like one
config: {
clientId: '', // your app id
clientSecret: '', // your app secret
refresh_token: '', // your generated refresh token
}
}
```#### Config Options
The following properties can be configured:
|Option|Description|Default|Required|
|---|---|---|---|
|`clientId`|The ID of your Netatmo [application][dev-portal].||yes|
|`clientSecret`|The app secret of your Netatmo [application][dev-portal].||yes|
|`refresh_token`|Generated refresh token for your Netatmo app and Netatmo instance.||yes|
|`refreshInterval`|How often does the content needs to be updated (minutes)? Data is updated by netatmo every 10 minutes|`3`|no|
|`moduleOrder`|The rendering order of your weather modules, ommit a module to hide the output. **Example:** `["Kitchen","Kid's Bedroom","Garage","Garden"]` Be aware that you need to use the module names that you set in the netatmo configuration.||no|
|`dataOrder`|The rendering order of the data types of a module, ommit a data type to hide the output. **Example:** `["Noise","Pressure","CO2","Humidity","Temperature","Rain"]`||no|
|`design`|The design for the module appearance, could be `classic` or `bubbles`.|`classic`|no|
|`horizontal`|Control the direction of the modules.|`true`|no|
|`showBattery`|Control the appearance of the battery status.|`true`|no|
|`showRadio`|Control the appearance of the radio perception.|`true`|no|
|`showWiFi`|Control the appearance of the Wifi perception.|`true`|no|
|`showTrend`|Control the appearance of the temperature and pressure trend.|`true`|no|
|`showMeasurementIcon`|Control the appearance of the data entry icons (`bubbles` design only).|`true`|no|
|`showStationName`|Control the appearance of the station name next to the module name.|`true`|no|
|`showModuleNameOnTop`|Control the position of the module name.|`false`|no|
|`fontClassModuleName`|Control font size class of the module name.|`xsmall`|no|
|`fontClassPrimary`|Control font size class of the primary value (`bubbles` design only).|`large`|no|
|`fontClassSecondary`|Control font size class of the secondary value (`bubbles` design only).|`xsmall`|no|
|`fontClassMeasurement`|Control font size class of the data entries.|`xsmall`|no|
|`thresholdCO2Average`|Control the threshold for the CO2 status when it should turn `average` (`bubbles` design only).|`800`|no|
|`thresholdCO2Bad`|Control the threshold for the CO2 status when it should turn `bad` (`bubbles` design only).|`1800`|no|
|`mockData`|Use a set of mock data instead of a real data from the Netatmo API.|`false`|no|## Contributors β¨
Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):
kuutio-hub
π
zdeneksofr
π
Tom-Inge Larsen
π
jegerikke
π
gilmrt
π
cyber152
π
Laz2516
π
Otto Lote
π»
cgillinger
π
Bugsounet - CΓ©dric
π» π π
Duhlin12
π»
This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!
[weather-station]: https://www.netatmo.com/weather
[dev-portal]: https://dev.netatmo.com/apps/
[mirror]: https://github.com/SAP/jenkins-library/issues