summaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorChris Schlaeger <chris@linux.com>2014-08-21 22:27:25 +0200
committerChris Schlaeger <chris@linux.com>2014-08-21 22:27:25 +0200
commitc879fd4a6e1da1996c7f05daf3979080e3d51f29 (patch)
treea17236f406ada4b5b7164156f8fd98c94a904db5 /README.md
parentda47178b94d6ff247c8c13c1cc6880f2f1d73bbc (diff)
downloadpostrunner-c879fd4a6e1da1996c7f05daf3979080e3d51f29.zip
Ensure that imported files have HTML reports
Diffstat (limited to 'README.md')
-rw-r--r--README.md50
1 files changed, 41 insertions, 9 deletions
diff --git a/README.md b/README.md
index 3099b11..ab6269c 100644
--- a/README.md
+++ b/README.md
@@ -12,6 +12,8 @@ $ gem install postrunner
## Usage
+### Importing FIT files
+
To get started you need to connect your device to your computer and mount it as a drive. Only devices that expose their data as FAT file system are supported. Older devices use proprietary drivers and are not supported by postrunner. Once the device is mounted find out the full path to the directory that contains your FIT files. You can then import all files on the device.
```
@@ -20,6 +22,8 @@ $ postrunner import /var/run/media/user/GARMIN/GARMIN/ACTIVITY/
The above command assumes that your device is mounted as /var/run/media/user. Please replace this with the path to your device. Files that have been imported previously will not be imported again.
+### Viewing FIT file data on the console
+
Now you can list all the FIT files in your data base.
```
@@ -35,14 +39,6 @@ by the index number.
$ postrunner summary :1
```
-Or you can view the full details of your activity in your browser.
-This view includes a map (internet connection for map data required)
-and charts.
-
-```
-$ postrunner show :1
-```
-
To get a summary of the oldest activity you can use
```
@@ -69,12 +65,48 @@ $ postrunner dump :1
This will provide you with a lot more information contained in the FIT files that is not available through Garmin Connect or most other tools.
+### Viewing FIT file data in your web browser
+
+You can also view the full details of your activity in your browser.
+This view includes a map (internet connection for map data required)
+and charts for speed, pace, heart rate, cadence and the like.
+
+```
+$ postrunner show
+```
+
+This will open an overview of the most recent activities in your web
+browser. It will use Firefox by default. You can overwrite this by
+setting the BROWSER environment variable.
+
+To view a specific run directly, you can use similar specifications
+like those explained above.
+
+```
+$ postrunner show :1
+```
+
## Contributing
-PostRunner is currently work in progress. It does some things I want with files from my Garmin FR620. It's certainly possible to do more things and support more devices. Patches are welcome!
+PostRunner is currently work in progress. It does some things I want
+with files from my Garmin FR620. It's certainly possible to do more
+things and support more devices. Patches are welcome!
1. Fork it ( https://github.com/scrapper/postrunner/fork )
2. Create your feature branch (`git checkout -b my-new-feature`)
3. Commit your changes (`git commit -am 'Add some feature'`)
4. Push to the branch (`git push origin my-new-feature`)
5. Create a new Pull Request
+
+## License
+
+PostRunner is licensed under the GNU GPL version 2.
+
+The distribution includes third party components that are licensed
+under different OSI compatible terms.
+
+* flot: MIT License
+* jquery: MIT License
+* openlayers: 2 clause BSD license
+
+