Withings2Intervals

A Python script to sync wellness data from Withings to Intervals.icu.

This script is a fork of this Gist and has been enhanced with features such as:

• Configurable start dates for syncing.
• Prevention of duplicate syncing using a log file.
• Added debugging support via a -v flag.
• Refactored for better maintainability and extensibility.

Features

• Fetches data from Withings using their API.
• Uploads wellness data (weight, body fat %, muscle mass %, blood pressure, etc.) to Intervals.icu.
• Tracks synced days to avoid duplicate uploads.
• Supports a --force-resync option to re-upload data.
• Debugging support with -v.

Installation from pip

You can simply install the package from PyPi

pip install withings2intervals

Installation from repository

1. Clone the Repository:

   git clone https://github.com/your-username/withings_syncer.git
   cd withings_syncer
   

2. Install Dependencies with Poetry: Make sure you have Poetry installed.

   poetry install
   

3. Build

   poetry build
   

4. Install

   pip install dist/withings2intervals-<version>.whl
   

Setup

1. Create a Withings Developer App

1. Go to the Withings Developer Portal.
2. Sign in and create a new app:
   • App Name: Choose a name (e.g., "Withings Syncer").
   • Callback URL: Use http://localhost:80.
   • Save the app and copy the Client ID and Client Secret to the config.ini

2. Get your intervals.icu keys

1. Go to the Intervals.icu settings page
2. Scroll until you see Developer Settings
3. Click on "API Key (view)"
4. Click on "Generate"
5. Copy the generated API key to the config.ini
6. Copy also the "Athlete ID" to config.ini

3. Run initial authentication

1. Run python withings2intervals.py
2. Follow on screen instructions

Once the initial authentication is successfully completed your OAuth2 token will be saved locally and you will be able to run subsequent synchronizations.

Usage

Run the script with the following options:

• Sync Today's Data:

  withings2intervals
  

• Sync Data from a Specific Date:

  withings2intervals --start 2024-12-01
  

• Force Resync:

  withings2intervals --start 2024-12-01 --force-resync
  

• Verbose Debugging:

  withings2intervals -v
  

Acknowledgments

• Fruitloop's Original Gist