1. hozn
  2. garmin-sync

Overview

How to use
==========

In order to use this program you need to have (at least) PyUSB and
ElementTree installed. You also need to make sure that the garmin_gps
*is not loaded*, so do this after you've connected your GPS to make
sure it's not loaded:

    sudo modprobe -r garmin_gps

After this you should be able to download data from your Forerunner or
Edge that are connected via USB, by executing garmin-sync without any
arguments:

    ./garmin-sync

This should print out a message saying that it's downloading data from
the GPS, and also export all runs into a TCX format in the 'exports'
directory. There will be one file per run.

If you haven't done any special setup, you probably got permission errors
running the command above. Usually, only root will be able to able to access
the USB bus. If you just want to try it out, you can run it with sudo:

    sudo ./garmin-sync

To allow all users on your system to access Garmin GPS devices, you can try
adding a file called /etc/udev/rules.d/51-garmin.rules with the following
contents:

    SYSFS{idVendor}=="091e", SYSFS{idProduct}=="0003", MODE="666"


This software is experimental at the moment, so don't expect it to work
all the time. If you get an error, try running it again. If you still
get an error, try unplug and reconnect your GPS and try running it
again.

If you have an questions/suggestion, send an e-mail to
bjorn.tillenius@gmail.com. You can also file bugs at
https://bugs.launchpad.net/garmin-sync.