The Debian Package qtrainer
----------------------------
Comments regarding the Package

   When the program starts up it will look for program settings in file
   ~/.config/qtrainer/qtrainer.conf. If the file doesn't exist, it will
   be created using the following defaults:

   [garmin]
   directory=/home/user

   [database]
   filename=/home/user/.qtrainer/forerunner.db

   The first entry defines the directory where the application will try
   and store track data, which it retrieves from your Forerunner device
   by using the garmin_save-runs tool after having set the current
   directory to this path.

   The second entry (filename under [database]) is the name of a sqlite3
   database file, if that file doesn't exist the application will create
   it. If you wanted to, you could create (an empty version of) it
   manually by:
   
   $ mkdir ~/.qtrainer
   $ cd ~/.qtrainer
   $ sqlite3 forerunner.db
   SQLite version 3.7.2
   Enter ".help" for instructions
   Enter SQL statements terminated with a ";"
   sqlite> CREATE TABLE tracks (
             id INTEGER PRIMARY KEY, 
             date timestamp, 
             title varchar(64));
   sqlite> CREATE TABLE gmn (
             rid INTEGER, 
             time timestamp, 
             latitude float, 
             longitude float, 
             altitude float, 
             distance float,
             hrate float);
   sqlite> .quit
   
   You can run qtrainer by simply selecting it in your Applications menu
   or (in a terminal) by executing

   $ qtrainer

   The File->Import data menu will allow you to run 'garmin_save_runs'
   (from the garmin-forerunner-tools package) asynchronously in the
   background. Track data will be stored under the directory given in 
   the config-file under, see above

   Alternatively, you could do this manually again by:

   $ cd <dir-defined-in-config>
   $ garmin_save_runs

   Once this directory contains any saved tracks (.gmn files), typically
   ordered by year and month, the File->Add track menu will allow you to
   add any of these to the sqlite database file. It will run
   'garmin_dump' in order to do that. So without the
   garmin-forerunner-tools you will not be able to add any new data, but
   you would be able to view existing data in a database file. After
   adding the track it will be displayed in the history tab as
   <untitled>. You may alter the title of any track by clicking on its
   current title in the history tab, which will bring up a dialog for
   editing.

   The table widget will display your currently available tracks.
   Clicking on any of the numbers in the vertical header of that table
   (i.e. the left-most, grey shaded column) will retrieve the data for
   that run from the database. Switching to the performance tab will
   show plots of speed, pulse and height profile. Clicking on any of
   these profiles will mark the corresponding position in the map.

   You may also alter the descriptive title of any track by clicking on
   its current title in the history tab. This will bring up a dialog for
   editing.

 -- Michael Olberg <michael.olberg@chalmers.se>  Mon, 27 Aug 2012 08:11:47 +0200
