Get weight from Nokia Health and update to Garmin Connect or Smashrun.
-
Download / clone the repository.
-
Satisfy the following requirements:
- Python 3.X
- Python libraries: arrow, requests, requests-oauthlib
-
Register an application with Nokia Health and obtain a consumer key and secret.
- logo: the requirements are quite strict, feel free to use this one
- callback: you can pick anything, but if you want to do the automated authorization (you will be prompted for this), you need to pick the hostname/ip and port carefully. For example http://localhost:8087.
- localhost: if you run nokia-weight-sync and do the authorization in the browser on the same device. This needs to be replaced by local or public ip/hostname if you run it on a server.
- 8087: a port that is likely not used by other services. For a remote setup make sure the port is not firewalled.
- http: https is available, but requires additional setup of certificates. For localhost http is fine.
-
On first run you need to set-up your Nokia Health consumer key and secret:
./nokia-weight-sync.py -k CONSUMER_KEY -s CONSUMER_SECRET setup nokia
-
Follow the instructions on the screen and verify the application.
-
Register one or more destination services:
-
Garmin Connect: register your Garmin Connect credentials and sync your last measurement (provide GC password when asked):
./nokia-weight-sync.py -k [email protected] setup garmin
-
Smashrun (implicit flow, recommended): for user level authentication simply copy the access token (no registration, no refresh after expiry):
./nokia-weight-sync.py setup smashrun
-
Smashrun (code flow): register Smashrun API application keys and follow the authorization process to obtain your users refresh_token (registration required, refresh after expiry):
./nokia-weight-sync.py -k CLIENT_ID -s CLIENT_SECRET setup smashrun_code
-
-
Verify that the relevant sections for the services are added to
config.ini
. -
Synchronize (new) measurements:
./nokia-weight-sync.py sync garmin ./nokia-weight-sync.py sync smashrun
Important Nokia Health API, Smashrun API, and Garmin Connect credentials are stored in config.ini
. If this file is compromised your Garmin Connect account, personal health data from Nokia Health, and activity data from Smashrun are at risk.
The Dockfile contains instructions to build a Docker container with this code which you can run on any host without worrying about the Python an Pip dependencies.
Run the docker build command, assuming you're in the root of your working copy of this repo.
docker build -t <desiredcontainername> .
Start the container with an interactive shell
docker run --rm -ti --user `id -u`:`id -g` -p9090:9090 -v $PWD:/opt --entrypoint /bin/bash desiredcontainername
Follow the setup instructions from above. This will generate the config.ini in the /build directory of the container. Copy the config.ini to the mounted /opt directory:
I have no name!@81cb3fe1890e:/build$cp /build/config.ini /opt/
once the setup is done and a config.ini exists the Container can be called to sync the data between Withings and the target service. The default is to sync with Garmin.
docker run -ti --user `id -u`:`id -g` -v $PWD/config.ini:/build/config.ini desiredcontainername
Last measurement was already synced
Config file saved to config.ini
Please not that the config.ini is written to during the sync. So it must be writeable to the user inside the container.
See ./nokia-weight-sync.py --help
for more information.
nokia-weight-sync includes components the following open-source projects:
fit.py
from ikasamah/withings-garmin, MIT License (c) 2013 Masayuki Hamasaki, adapted for Python 3.garmin.py
from jaroslawhartman/withings-garmin-v2, MIT License (c) 2013 Masayuki Hamasaki, adapted for Python 3.nokia.py
from python-nokia, MIT License (c) 2012 Maxime Bouroumeau-Fuseau, 2017 ORCAS, unmodified.sessioncache.py
from cpfair/tapiriik, Apache License 2.0, unmodified.smashrun.py
from campbellr/smashrun-client, Apache License 2.0, several fixes.
Please open an issue for support.
Please contribute using Github Flow. Create a branch, add commits, and open a pull request.