Skip to main content

Polar RCX5 training session exporter

Project description

polar-rcx5-datalink

Command-line program to export Polar RCX5 training sessions in raw or tcx format. You also can upload them to Strava with a single command.

Table of contents

Requirements

  • Python >=3.7
  • libusb >=1.0, <=1.0.21 (PyUSB has issues with libusb-1.0.22 backend.)

If you are using Linux, chances are your distribution already includes libusb.

How to install libusb on Windows: https://github.com/pyusb/pyusb/issues/120#issuecomment-322058585

Installation

pip install polar-rcx5-datalink

Usage

  1. Plug in Polar DataLink
  2. Select "Connect > Start" from your watch
  3. Run a command

Examples

Export training sessions in current directory

rcx5 export

Export training sessions to /where/to/export/files/

rcx5 export --out /where/to/export/files/ --format tcx

Filter by date

rcx5 export --from-date 2018-11-20 --to-date 2018-11-25

Sync training sessions with Strava

rcx5 stravasync --client-id YOUR_CLIENT_ID --client-secret YOUR_CLIENT_SECRET

Description

Usage: rcx5 [OPTIONS] COMMAND [ARGS]...

Options:
  --version  Show the version and exit.
  --help     Show this message and exit.

Commands:
  export      Exports training sessions.
  stravasync  Helps to synchronize training sessions with Strava.

rcx5 export

Usage: rcx5 export [OPTIONS]

  Exports training sessions.

Options:
  -o, --out PATH                  Where to save the output. Current working 
                                  directory by default.
  -f, --format [raw|bin|tcx]      Export file format. [default: tcx]
  -s, --sessions-dir PATH         Directory of raw training sessions.
  --from-date [%Y-%m-%d|%Y-%m-%dT%H:%M:%S|%Y-%m-%d %H:%M:%S]
                                  Filter sessions that have started at this
                                  date or after.
  --to-date [%Y-%m-%d|%Y-%m-%dT%H:%M:%S|%Y-%m-%d %H:%M:%S]
                                  Filter sessions that have started at this
                                  date or before.
  --help                          Show this message and exit.

rcx5 stravasync

Usage: rcx5 stravasync [OPTIONS]

  Helps to synchronize training sessions with Strava.

  Before getting started you need to register an application
  https://strava.com/settings/api (Authorization Callback Domain MUST be
  0.0.0.0).

  A registered application will be assigned a Client id and Client secret.
  Provide those in options --client-id and --client-secret respectively.

  Examples:
    rcx5 stravasync --client-id YOUR_CLIENT_ID --client-secret YOUR_CLIENT_SECRET

    # You can use environment variables to pass --client-id and --client-secret.

    export RCX5_STRAVASYNC_CLIENT_ID=YOUR_CLIENT_ID
    export RCX5_STRAVASYNC_CLIENT_SECRET=YOUR_CLIENT_SECRET
    rcx5 stravasync

Options:
  -h, --host TEXT
  -p, --port INTEGER
  --client-id INTEGER             Application’s ID, obtained during
                                  registration  [required]
  --client-secret TEXT            Application’s secret, obtained during
                                  registration.  [required]
  -s, --sessions-dir PATH         Directory of raw training sessions.
  --from-date [%Y-%m-%d|%Y-%m-%dT%H:%M:%S|%Y-%m-%d %H:%M:%S]
                                  Filter sessions that have started at this
                                  date or after.
  --to-date [%Y-%m-%d|%Y-%m-%dT%H:%M:%S|%Y-%m-%d %H:%M:%S]
                                  Filter sessions that have started at this
                                  date or before.
  --help                          Show this message and exit.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

polar_rcx5_datalink-0.1.4.tar.gz (21.5 kB view hashes)

Uploaded Source

Built Distribution

polar_rcx5_datalink-0.1.4-py3-none-any.whl (24.2 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page