About PolarViewer
-----------------

PolarViewer is an application for viewing exercise files recorded with 
Polar and CicloSport heartrate monitors. It displays all the recorded
exercise data (except power) and creates diagrams.

If you want to organize your exercises and create statistics you should 
use the SportsTracker application together with PolarViewer. You can find
it here: http://www.saring.de/sportstracker.

This is a compatibility list for heartrate monitors:

  - Polar S610(i)   (tested)
  - Polar S710(i)   (tested)
  - Polar S720i     (tested)
  - Polar S725      (tested)
  - Polar S625x     (tested, HRM files only)
  - Polar S410      (tested, HRM files only)
  - Polar RS200SD   (tested, initial support)
  - CicloSport HAC4 (tested, initial support)

Other heartrate monitors might work too, but I can't test them. User 
feedback is welcome.
It's also possible to view HRM exercise files (recorded with the Polar
Software for Windows) with PolarViewer.

The application itself is not able to receive the exercise files from the 
Polar device and store it on the computer. There's an excellent tool 
called 's710' (written by Dave Bailey) which does this job.

Users of Polar S725 monitors needs to keep the default settings (80 - 160)
of the 'Exercise Heartrate Range Summary'. This is right now the only known
method to detect the S725 exercise file type, because it needs different
parsing compared to other S7XX models (this is not necessary for parsing
HRM files of S725).
   

Requirements
------------

PolarViewer is a .NET application written in C# using the Gtk# toolkit. 
It was developed and tested with the Mono implementation of .NET. Other
.NET runtimes might work too, but I have not tested them.

You need the following tools/libraries for running PolarViewer:

  - Mono >= 1.1.8 (from http://www.mono-project.com)
  - Gtk# >= 1.9.5 (from http://gtk-sharp.sourceforge.net)
  - s710 >= 0.19  (from http://daveb.net/s710)

The application was tested on GNU/Linux (Ubuntu 5.10), although it should
work on all Unix-like systems. It also runs on Windows 2000/XP, other
Win32 systems might work too.


Installation on Linux or other Unix-based systems
-------------------------------------------------

You need to perform the following steps:

  - make sure that your system fulfills all requirements
  - extract the application archive
  - change to application directory
  - call 'make' to compile
  - call 'make install' to install (you need to be root)

If your Mono and Gtk# was installed to /usr/local you will get the compile
error message "No package 'gtk-sharp' found". Then you need to enter:
'export PKG_CONFIG_PATH=/usr/local/lib/pkgconfig/' and run 'make' again.

To start the application you need to use this command:

  mono /usr/local/bin/PolarViewer.exe
  
Optionally you can append an exercise filename which will be displayed
after startup. If your system can run .NET 'exe' files directly (using 
BINFMT_MISC in your kernel) then you only need to start 'PolorViewer.exe'.

The most convenient way of using the application is to associate the
exercise files ('srd' and 'hrm' extension) with PolarViewer in your
desktop environment.

If you want to uninstall PolarViewer you only need to call 'make uninstall'
(you need to be root) in the application directory.


Installation on Win32 systems
-----------------------------

See the documentation Install-Win32.txt in subdirectory misc/win32.


Contact
-------

The website of PolarViewer can be found at:
http://www.saring.de/polarviewer

You are welcome to use the forum and the bug system on the Sourceforge
project page of the SportsTracker application when you have comments, 
suggestions or problems with bugs. You'll find special categories for
PolarViewer there. 
The URL is: http://sourceforge.net/projects/sportstracker

The most recent version of this tool can also be found there. If you're 
interested in the current development version you can get it from CVS.

If you want to provide a translation for your language take a look at
I18N.txt and send me your translation for the CVS-version by mail.

For direct email contact you can use the address: projects@saring.de 


License
-------

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.


Stefan Saring
2006/03/11
