• Stars
    star
    115
  • Rank 305,916 (Top 7 %)
  • Language
    C++
  • License
    GNU General Publi...
  • Created over 10 years ago
  • Updated 11 months ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Free your data from Polar FlowSync

Bipolar Logo Bipolar

Build Status Static Analysis

Bipolar a simple GUI application for exporting training sessions from Polar sync software, such as Polar FlowSync. Currently, the following applications and devices are supported:

Installing Bipolar

Mac OS X

  1. Install Polar FlowSync, if you haven't already.
  2. Close FlowSync, if it's already running.
  3. Download the latest Bipolar release - you'll want the Bipolar-<version>.dmg file for OS X.
  4. Open the downloaded Bipolar-<version>.dmg file.
  5. Read the included README.txt file.
  6. Enter the Hook folder.
  7. Run the install.command script.

See the How it Works for more information about the Hook that gets installed in that last step.

Windows

  1. Install Polar FlowSync, if you haven't already.
  2. Close FlowSync, if it's already running.
  3. Download the latest Bipolar release - you'll want the Bipolar-<version>.exe file for Windows.
  4. Run the downloaded Bipolar-<version>.exe installer.
  5. Follow the usual install wizard prompts.

See the How it Works for more information about the Hook that gets installed in that last step.

Using Bipolar

Once installed (see above), the usage pattern is pretty simple:

  1. Record some activities on a supported Polar device.
  2. Use FlowSync to upload your activities to [flow.polar.com] as usual.
  3. Run the Bipolar application, and follow the GUI prompts. Depending on the options selected, this will generate GPX, HRM, and/or TCX versions of all activities seen.
  4. Open/upload the generated GPX, HRM, and/or TCX files to your favorite website or application.

How it Works

Windows

When Bipolar is installed, it places a custom DLL into the Polar FlowSync application directory. This custom DLL then writes all training session data it sees to binary files (in %LOCALAPPDATA%\Polar\PolarFlowSync\export).

The installer also installs a separate Bipolar application, which, when exectued looks through all training session data exported above, and, for any that don't already have corresponding *.gpx and/or *.tcx files, converts those sessions to GPX and/or TCX accordingly.

OSX

For OSX, Bipolar is provided as a standard disk image (*.dmg) file. This file contains both the Bipolar application (which can run completely standalone), and the hook library. However, the hook library is not automatically installed for OSX. Instead, the disk image includes a simple hook install script to run to install the hook (which you will want to do, unless using the direct USB option mentioned below).

Direct USB Interface

The separate v800_downloader project provides a way of extracting training session data from the V800 directly, without the need for the hook mentioned above. That project extracts data in a format that is compatible with this project's Bipolar application, so can be used as a hook alternative if desired.

Of course, that is particularly exciting for Linux users, who otherwise could not make any significant use of this project, nor the Polar V800 in general.

Contact

The issue tracker is the preferred place for reporting issues, while the GitHub Discussions area is best for questions, comments etc.

There's also an old Gitter chat room, and even older Bipolar Google Group with some historical content. And finally there's a Bipolar open-source project topic on the Polar forums (and Internet Archive), which contains quite a lot of historical information.