Polar progress

Introduction

Polar progress is a little tool which queries the Polar Flow internal API (not the Polar accesslink API which is not suitable for this purpose). It is partly inspired on flow-client but as the latter was also not really finished it does not depend on it directly.

The main goal is that you give it your Polar flow credentials and the number of kilometer you plan to run this year. It will then query the progress you made to date and then report whether or not you're on track.

Installation

Clone this repository, make sure the requests library is availabe and you're good to go.

Usage:

To make use of this polar progress you need a configuration file:

{
    "login": "POLAR_USER",
    "password": "POLAR_PASS",
    "goal": 1000
}

And then you can invoke the tool as follows :

$./polar_progress.py -h
usage: polar_progress.py [-h] [--config CONFIG]

Polar Flow progress reporter

optional arguments:
  -h, --help       show this help message and exit
  --config CONFIG  the configuration file (default: ./progress_settings.json)
$ ./polar_progress.py
Target: 1050 km
Daily target: 2.88 km/day
Effective daily average: 3.37 km/day
Expected distance to date: 230.1 km
Achieved distance: 269.3 km or 25.7% of target
You are 39.2 km or 13.6 days ahead of schedule
This year:  269.3 km in  45 sessions
Last year:   99.5 km in  14 sessions
Extrapolated result: 1228.8 km at the end of the year