Welcome to Garmin Connect Python Uploader,
This project was born out of a lack of support by Garmin for their fitness GPS devices under Linux OS. Garmin Connect Python Uploader uploads TCX, FIT and GPX files generated by GPS fitness devices, such as Edge and Forerunner products, to the Garmin Connect web site where the data can be viewed.
A new service name Tapiriik has emerged which synchronizes GPS data between various sports GPS web sites (Garmin Connect, Strava, Training Peaks, Endomondo, etc... as well as DROPBOX, which has a Linux client). Since Tapiriik can sync your Dropbox folder with the various sports GPS web sites, it can perform the same function as GcpUploader. Tapiriik is elegant, versatile, and ACTIVELY MAINTAINED. It is HIGHLY recommended that you consider switching to using Tapiriik.
DESCRIPTION:
Garmin Connect Python Uploader, gupload.py, uploads files (.tcx, .gpx, and fit files ) created by Garmin fitness devices to the http://connect.garmin.com web site.
REQUIREMENTS:
Tested on Python 2.6.5 under Linux and 2.7.2 under Windows XP.
Required Python Modules:
argparse, ConfigParser, logging, glob, platform, string, urllib, urllib2, mimetools, mimetypes, os, stat, cStringIO, json or simplejson
INSTALL:
Note - PYPI package is now available at https://pypi.python.org/pypi?:action=display&name=GcpUploader
Linux Install:
unzip gupload.zip to /opt/pygupload
create a symbolic link
sudo ln -s /opt/pygupload/gupload.py /usr/local/bin/gupload.py
Windows Install:
unzip pygupload.zip file to c:\pygupload
add c:\pygupload to your PATH environment variable (use google)
Linux + Windows:
You may create a config file containing your Garmin Connect username and password to eliminate the need to type it in on the command line. WARNING!!! The username and password are stored in clear text, WHICH IS NOT SECURE. If you have concerns about storing your garmin connect username and password in an unsecure file, do not use this option.
Create a text file named .guploadrc (gupload.ini for Windows users) containing the following:
[Credentials]
username=\<username>
password=\<password>
Replace \<username> and <password> with your Garmin Connect login credentials. gupload.py looks for this file either in your home directory (usually something like '/home/\<username>' in Linux, or C:\Documents and Settings\\<username>' in Windows), or in the current working directory (the directory you are in when you execute gupload.py).
EXAMPLE:
Upload file and set activty name:
gupload.py -l myusername mypassword -a 'Run at park - 12/23' myfile.tcx
Upload multiple files:
gupload.py -l myusername mypassword myfile1.tcx myfile2.tcx myfile3.fit
Upload file using config file for credentials, name file, verbose output:
gupload.py -v 1 -a 'Run at park - 12/23' myfile.tcx
MORE INFO:
For information on extracting files from Garmin ANT+ Wireless enabled devices see:
https://forums.garmin.com/showthread.php?p=120203#post120203
https://launchpad.net/ubuntu/+source/garmin-ant-downloader
http://packages.debian.org/sid/garmin-ant-downloader
Last edit: Dave Lotton 2013-05-05