Skip to content

This is a Magic Mirror² module that displays sports data from your Garmin Connect™ account.

License

Notifications You must be signed in to change notification settings

tderflinger/MMM-GConnect

Repository files navigation

Magic Mirror² GConnect

This is a Magic Mirror² module that displays data from the most recent activity loggged in your Garmin Connect™ account.

Specifically, it displays the following data:

  • days since your last sports activity
  • total distance of last sports activity
  • total time of last sports activity
  • average heart rate of last sports activity

In order to use this module, you need to have a Garmin Connect™ account. You can configure your username and password in the config.js file as specified below.

Note: This project is not affiliated with the Garmin company.

Preview Screenshot

This is an example of how Magic Mirror² GConnect looks in my configuration:

Magic Mirror² GConnect exmaple screen

Installation

Clone this repository into your MagicMirror modules folder.

Example:

cd /home/pi/MagicMirror/modules
git clone https://github.com/tderflinger/MMM-GConnect.git

Install the JavaScript dependencies:

cd /home/pi/MagicMirror/modules/MMM-GConnect
npm i

Finally, edit your configuration file under config/config.js with the following configuration.

{	
  module: "MMM-GConnect",
  position: "top_left",
  config: {
    interval: 60000000,
    loginName: "your login name",
    password: "your login password",
  },
},

You also have to add your login credentials to the garmin.config.js file.

Config Options

Option Description
interval Interval between new fetch of data from Garmin Connect™ in ms
loginName Your login name to Garmin Connect™
password Your password to Garmin Connect™

Testing

I have tested the Magic Mirror² GConnect module on an Raspberry Pi 3B with Raspberry OS and Node 16.15.0 and Magic Mirror² version 2.19.0.

Icons

The module uses the following icons from iconduck.com:

References

Magic Mirror²: https://magicmirror.builders

JavaScript library garmin-connect: https://github.com/Pythe1337N/garmin-connect

Preact: https://preactjs.com

HTM: https://github.com/developit/htm

Garmin Connect™: https://connect.garmin.com/

Thanks to the great work of Pythe1337N in creating the garmin-connect JavaScript library. Without his work, this module would not have been possible.

License

MIT License

About

This is a Magic Mirror² module that displays sports data from your Garmin Connect™ account.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published