https://github.com/heedy/heedy-fitbit-plugin

Sync your fitbit data to heedy
https://github.com/heedy/heedy-fitbit-plugin

Last synced: 3 months ago
JSON representation

Sync your fitbit data to heedy

• Host: GitHub
• URL: https://github.com/heedy/heedy-fitbit-plugin
• Owner: heedy
• License: other
• Created: 2020-02-21T03:47:57.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2023-03-04T06:14:56.000Z (over 1 year ago)
• Last Synced: 2024-02-14T21:26:49.407Z (9 months ago)
• Language: Python
• Size: 3.45 MB
• Stars: 4
• Watchers: 3
• Forks: 1
• Open Issues: 8
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Heedy Fitbit Integration

This plugin automatically syncs all of your Fitbit data with Heedy.

It guides you through setting up a fitbit app key, and handles all authentication for you.

![Screenshot of sleep data](./screenshot1.png)

![Screenshot of heart-rate data](./screenshot2.png)

![Screenshot of weight data](./screenshot3.png)

### Supported fitbit data

**Available in this plugin**

- Steps

- Raw heart rate

- Sleep stages

- Body data (weight, body fat, BMI)

**Missing but possible** (contributions welcome!)

- Activities

- Food

- Resting heart rate (derivable from raw heart rate)

- Heart rate variability (derivable from raw heart rate)

**Currently not available in the Fitbit API** (status 05/2022)

- SpO2

- Skin temperature

- EDA

- Breathing rate

## Building

```

git clone https://github.com/heedy/heedy-fitbit-plugin

cd heedy-fitbit-plugin

make

```

The plugin zip file will be created at `dist/heedy-fitbit-plugin-{VERSION}.zip`. It can be installed by uploading to heedy from the UI.

### Developing

To develop the plugin, create a heedy database, run the build in debug mode (which watches files for changes and auto-updates them), and link the build to heedy's plugin directory:

```

heedy create testdb

mkdir testdb/plugins

make debug

# In a different terminal (since make debug watches files):

ln -s ${pwd}/dist/fitbit ./testdb/plugins/fitbit

```

At this point, you should edit `testdb/heedy.conf` to add the fitbit plugin. Any changes you make to the Python files require a heedy restart.