diff options
author | Chris Schlaeger <chris@linux.com> | 2020-07-26 19:18:08 +0200 |
---|---|---|
committer | Chris Schlaeger <chris@linux.com> | 2020-07-26 19:18:08 +0200 |
commit | ddf93c9a5d4b061bb16fb6f706e4c235d688b704 (patch) | |
tree | aba9622e6f37fe50f69c607a4a16af91250190e1 /README.md | |
parent | 24f945d85672e9a6b0ff7be3450fda6939b1655d (diff) | |
download | postrunner-ddf93c9a5d4b061bb16fb6f706e4c235d688b704.zip |
New: Improved installation description in README file.
Diffstat (limited to 'README.md')
-rw-r--r-- | README.md | 42 |
1 files changed, 33 insertions, 9 deletions
@@ -2,26 +2,50 @@ PostRunner is an application to manage FIT files such as those produced by Garmin products like the Forerunner 620 (FR620), -Forerunner 25 (FR25), Fenix 3, Fenix 3HR and Fenix 5. It allows you to -import the files from the device and analyze the data. In addition to -the common features like plotting pace, heart rates, elevation and -other captured values it also provides a heart rate variability (HRV) -analysis. It can also update satellite orbit prediction (EPO) data on -the device to speed-up GPS fix times. It is an offline alternative to -Garmin Connect. The software has been developed and tested on Linux -but should work on other operating systems as well. +Forerunner 25 (FR25), Fenix 3, Fenix 3HR, Fenix 5, Fenix 5+ or Fenix6. +It allows you to import the files from the device and analyze the +data. In addition to the common features like plotting pace, heart +rates, elevation and other captured values it also provides a heart +rate variability (HRV) analysis. It can also update satellite orbit +prediction (EPO) data on the device to speed-up GPS fix times. +Unfortunately, the download mechanism for CPE files used by the +devices with GPS chipsets from Sony is still unknown and hence +unsupported. Postrunner is an offline alternative to Garmin Connect. +The software has been developed and tested on Linux but should work on +other operating systems as well. ## Installation PostRunner is a [http://www.ruby-lang.org](Ruby) application. You need to have a Ruby 2.0 or later runtime environment installed. This application was developed and tested on Linux but may work on other -operating systems as well. +operating systems as well. You can either install it as root for all +users on the computer or as a particular user for just this user. + +### System-wide installation as root user ``` $ gem install postrunner ``` +On some Linux distributions using sudo might resolve in permission +problems as the installed packages are not reable for normal users. +This typically results in 'cannot load such file' type error messages. + +### Installation as non-priviledged user + +``` +gem install --user-install postrunner +``` + +This will install postrunner and all dependency packages in your .gem +directory. You then need to add the binary path to your PATH variable +in your .profile or .bashrc or .whatever file. The path is typically +.gem/ruby/<version>/bin. Watch out, on some Linux distributions the +version number of ruby gets added to the binary name, e. g. +postrunner.ruby2.7. You can use a symbolic link or alias to safe some +typing. + ## Usage ### Importing FIT files |