MMM-Oura2

Module for the MagicMirror² smart mirror.

Displays a user's Oura data in a chart. Inspired by https://github.com/erchenger/MMM-Oura, but I was looking for a little more data. Still a work in progress but feature requests and feedback are welcome.

This module uses a python backend, primarily through Pandas, to download the data from Oura. On a request for update (on load, or on the pre-programmed interval), the javascript module sends a request to the python for updated data.
The python downloads that data from Oura, processes through Pandas for data formatting and management, and then pushes back to the javascript in an easily parsable format. On receipt, the javascript pushes that into a chart.js canvas, which is then rendered by the getDom function when called.

• Which features would you like to see?
  
• Which charts would you like to see?
  

Example

Dependencies

1. Chart.js
2. Python3, including the following modules/packages:
   Pandas
   Numpy
   *Requests
   

Assumes python3 is located at /usr/bin/python3

Installation

To install the module, use your terminal to:

1. Navigate to your MagicMirror's modules folder. If you are using the default installation directory, use the command:
   cd ~/MagicMirror/modules
2. Clone the module:
   git clone https://github.com/themox/MMM-Oura2.git
3. Install Chart.js framework:
   npm install chart.js
4. Ensure you have the correct Python version (3+) and libraries installed.

Using the module

MagicMirror² Configuration

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

var config = {
    modules: [
        ...
        {
            module: 'MMM-Oura2',
            header: "Oura Data",
            position: "top_left",
            config: {
        token: "",              // REQUIRED. your personal access token for Oura
                charts: ["heartrate"],  // Which charts to display; currently one or both of ["sleep", "heartrate", "scores"]; eventually to be several
                unit:  "weeks",         // One of [months, days, weeks]
                interval: 1,            // Integer interval to combine with unit for length of time to get & display data
                ...
                // See below for detailed Configuration Options
            }
        },
        ...
    ]
}

Configuration Options