Frequently Asked Questions

If you have a question not covered here, please send a message to rubiTrack support.

General Questions

Which devices are supported?

rubiTrack supports many kinds of devices via direct sync which imports activities directly from the device connected to your Mac. In addition rubiTrack supports activity file import for other devices that do not support direct sync.

Device Model Direct Sync File Import
Apple Watch via rubiTrack 6 for iPhone  
Garmin Forerunner 945, 935, 920XT, 910XT, 735XT, 645, 630, 620, 610, 245, 235, 230, 225, 220, 210, 310XT, 410, 405, 405CX, 35, 30, 25, 15, 10, 110, 70, 60, 50  
Garmin Edge 1030, 1000, 820, 810, 800, 530, 520, 510, 130, Explore, 500, 200, 705, 605, 25, 20, Touring  
Garmin fēnix 6, fēnix 5, 3, fēnix 2, fēnix, SWIM, GPSMap 62, Dakota, Oregon, Colorado, eTrex  
Garmin device Forerunner 645 M, fēnix 5 Plus, all Music Models - via Android File Transfer  
Polar Vantage V, Vantage M, M430, M200, Ignite via Polar Flow  
Polar M460, V650 via Polar Flow  
Suunto 9, 5, 3 via Suunto App  
Suunto Ambit 3, Ambit 3 Peak, Ambit 3 Run, Ambit 2, Ambit 2s, Ambit with Moveslink2  
Suunto T6, T6c, T6d, X9i, X9Mi, X10  
Polar V800, M400, V650, M450 via file import  
Polar RC3 GPS via HRM/GPX  
Polar RCX5, CS500, FT40, FT60, FT80, RS300X via HRM/GPX, polarpersonaltrainer.com XML, RS800, RS800CX, S610, S610i, S625X, S710, S710i, S720i, S725, S725X, S810, S810i, CS600, E600, AXN500, AXN700, Sport Tester, Vantage XL, Vantage NV, Accurex Plus, XTrainer Plus, Coach  
TomTom Runner Cardio, Runner, Multi-Sport  
O_synce Navi2Coach  
Motorola MotoACTV  
Amod 3080 GPS Tracker  
WinTec WBT201  
Timex GPS Global Trainer  
Sigma Sigma Rox FIT & CSV  
Daum Daum Ergometer CSV  
Withings WiFi Body Scale  
Fitbit Aria  

Which file formats are supported?

rubiTrack supports the following file formats. If you have a file format you would like to see supported by rubiTrack email us.

File Format Import Export (Mac)
FIT (Activity, Weight)  
TCX (Garmin Training Center)
GPX
Sporttracks FITLOG (Activities)  
Sporttracks LOGBOOK (Athlete Log)  
NMEA GPS Log  
Polar HRM  
Polar polarpersonaltrainer.com XML  
Suunto SDF  
Suunto Movescount XML  
Trainingpeaks/Peaksware PWX  
MotoACTV CSV  
Sigma Rox FIT & CSV  
Daum Ergometer CSV  
Nike+iPod XML  
General purpose CSV import for trackless activity history and athlete log data

Which cloud services are supported?

rubiTrack supports the following cloud services.

Cloud Service Data Import
Garmin Connect Activities
Polar Flow Activities
Suunto App Activities
Strava Activities
Withings Body weight and health data
Fitbit Body weight and health data

My Garmin does not direct-sync, what can I do?

If you have a Garmin device connected to your Mac via USB and direct device syncing does not work, go through the following checklist:

  1. Does the device mount as a volume when connected to your Mac?
    • Devices that don't mount as volume can't be accessed by rubiTrack 6 directly.
    • Garmin devices with a music function usually don't mount as a volume.
    • You can use the Android File Transfer tool to download data from the device.
  2. Is the volume name "GARMIN"?
    • By default Garmin devices use the volume name "GARMIN" (all caps). rubiTrack 6 cannot access the device if it has been renamed because of restrictions by Apple for apps from the App Store.
  3. Does rubiTrack 6 have permission to access the volume?
    • Check the System Preferences' "Privacy" section and verify that rubiTrack 6 is granted permission to access Removable Volumes.

If the answers to all of the above questions is "YES", you should have no problem direct-syncing your Garmin device. If you still have problems contact us.

How does syncing with Garmin Connect work?

Beginning with version 6.0, rubiTrack supports the official Garmin Connect API.

After authorizing with Garmin Connect, any new activities uploaded to Garmin Connect will become available for syncing with rubiTrack for a limited time. In order to fill gaps in your activities or import activities from the past, you may use the Backfill feature in rubiTrack's Sync Manager.

The following rules apply to Garmin Connect access:

  • There is a download window of 60 calendar days for new and backfilled activities.
  • Once an activity is downloaded from Garmin Connect, you cannot download it a second time.
  • You cannot authorize your Garmin Connect account on multiple computers at the same time.
  • You may backfill up to 90 days in one request. You can request dates up to 5 years in the past. You may make one backfill request every 15 minutes.
  • Any backfill day may only be requested once per user. This is a global limit that applies to your user account. You cannot request to backfill a day twice even if you de-authorize and re-authorize rubiTrack from scratch.

In order to protect your privacy these policies are in place:

  • If you never download any activities after authorizing rubiTrack to receive activities from Garmin, we will deauthorize rubiTrack after 30 days.
  • Activities will be removed from temporary storage 60 days after receiving them from Garmin.
  • If you do not download activities via rubiTrack for more than 90 days, we will deauthorize rubiTrack.
  • Any deauthorization removes all activities from temporary storage.

Can I import activities I have stored in SportTracks?

Yes! You can export existing activities from SportTracks to the FITLOG format which you can then import into rubiTrack.

I have data in a spreadsheet, how can I import it?

You can use tabular CSV data to import both activity summary data (activities without track or GPS data) and athlete log records.

Activity Summary CSV

  • The field separators are either semicolon ";" or tab, comma cannot be used as a separator.
  • The order of columns is arbitrary.
  • All fields except date are optional.
  • Some values like distance and temperature are interpreted according to the current unit setup in rubiTrack's Unit preferences.
  • If country code, division and city are given and they are contained in the rubiTrack database, weather information will be looked up automatically.
  • All numbers with decimal digits use the dot "." as decimal separator.

Activity Summary CSV Example File

Column Example Description
date 2015-11-12 14:40:43-0800 The activity start timestamp (mandatory)
timezonename America/Los_Angeles Unix time zone name
countrycode US ISO2 or ISO3 country code
division California State/Division
city Carlsbad City
location Alga Hills Location
route El Fuente Route
activitytype Trail Running Activity type, must match one of the activity types (English)
mood good Mood text
constitution strong Constitution text
intensity hard Intensity text
equipment Asics 43X, Garmin FR 620 Comma-separated list of equipment names
notes Too late for my taste Notes
tags hot,lots of traffic,late Comma-separated list of tags
temperature 26.7 Temperature in degrees Celcius or Fahrenheit (depending on unit setup)
weather partly cloudy Weather condition, must match one of the weather conditions rubiTrack supports (English, lower case)
totalduration 1:20:23 Total duration in D:H:M:S
duration 1:19:51 Active duration in D:H:M:S
totaldistance 14.78 Total distance in kilometers or miles (depending on unit setup)
distance 14.78 Active distance in kilometers or miles (depending on unit setup)
avgspeed 10.4 Average speed in kilometers per hour or miles per hour (depending on unit setup)
minspeed 4.2 Minimum speed in kilometers per hour or miles per hour (depending on unit setup)
maxspeed 14.6 Maximum speed in kilometers per hour or miles per hour (depending on unit setup)
ascent 234 Ascent in meters or feet (depending on unit setup)
descent 231 Descent in meters or feet (depending on unit setup)
avgheartrate 165 Average heart rate in BPM
minheartrate 120 Minimum heart rate in BPM
maxheartrate 178 Maximum heart rate in BPM
calories 789 Calorie expenditure in kCal
avgcadence 90 Average cadence (cycling rpm) or steps per minute (one foot)
mincadence 30 Minimum cadence (cycling rpm) or steps per minute (one foot)
maxcadence 100 Maximum cadence (cycling rpm) or steps per minute (one foot)
avgpower 81 Average power in watts
minpower 0 Minimum power in watts
maxpower 413 Maximum power in watts
totalenergy 4310 Total energy in kJ
trainingintensity 1.12 Training intensity in percent (1.0 = 100%)
trainingstresslevel 252 Training stress level
trimp 318 Trimp
rating 4 Rating (0-5)

Athlete Log CSV

  • The field separators are either comma ",", semicolon ";" or tab.
  • The order of columns is arbitrary.
  • All fields except date are optional.
  • Fields can be filled in one line and not in another, it doesn't have to be consistent (except for date which has to be filled in every line).
  • For all weight related columns there are 3 versions, for example weight, weight_kg and weight_lbs. If the first version is used, rubiTrack determines the unit of the value based on the setting in the preferences. The other two versions pre-set the unit for the import. Only one of the three variants should be used in one single CSV file.
  • All numbers with decimal digits use the dot "." as decimal separator.

Athlete Log CSV Example File

Column Example Description
date 2015-11-05 09:20:37 Timestamp in local timezone (mandatory)
weight 81.7 Weight in kilograms or pounds (depending on unit setup)
weight_kg 81.7 Weight in kilograms
weight_lbs 165.2 Weight in pounds
fatmass 8.3 Fat in kilograms or pounds (depending on unit setup)
fatmass_kg 8.3 Fat mass in kilograms
fatmass_lbs 17.2 Fat mass in pounds
fatmass_percent 7.1 Fat mass in percent
hr_min 56 Minimum heart rate
hr_max 180 Maximum heart rate
hr_rec 102 Recovery heart rate
vo2max 56 VO2 max
bodywater 43 Body water in percent
bmr 1398 Basal metabolic rate
amr 3201 Active metabolic rate
calories 2684 Calorie consumption
metabolic_age 35 Metabolic age in years
bonemass 15.1 Bone mass in kilograms or pounds (depending on unit setup)
bonemass_kg 15.1 Bone mass in kilograms
bonemass_lbs 32.8 Bone mass in pounds
musclemass 37.1 Muscle mass in kilograms or pounds (depending on unit setup)
musclemass_kg 37.1 Muscle mass in kilograms
musclemass_lbs 71.7 Muscle mass in pounds
visceralfatmass 1.2 Visceral fat in kilograms or pounds (depending on unit setup)
visceralfatmass_kg 1.2 Visceral fat in kilograms
visceralfatmass_lbs 2.6 Visceral fat in pounds
visceralfat_percent 8 Visceral fat in percent
skinfold 13 Skinfold in centimeters
bpsys 120 Systolic blood pressure
bpdia 80 Diastolic blood pressure
sleep 7 Sleep in hours
cholesterolLDL 2.43 Cholesterol Low Density Lipoprotein in mmol/l
cholesterolHDL 1.17 Cholesterol High Density Lipoprotein in mmol/l
cholesterolTriglyceride 1.45 Cholesterol Triglyceride in mmol/l
bloodSugarFasting 4.1 Fasting Glucose in mmol/l
bloodSugarTolerance 5.8 Glucose Tolerance in mmol/l
hemoglobinA1c 0.034 Hemoglobin A1c in percent (1.0 = 100%)
boneDensity 0.2 unitless

Where is my rubiTrack file?

If you can't remember where your rubiTrack file is located on your hard disk:

rubiTrack 6, rubiTrack 5, rubiTrack 4

  1. Start rubiTrack 6 (your file will be opened automatically).
  2. Select "File > Show In Finder" from the main menu.

Older Versions

  1. Start rubiTrack (your file will be opened automatically).
  2. Hold the COMMAND key and click into the filename in the title bar of the rubiTrack main window.
  3. A menu will open that shows the full path.
  4. Select the first folder in the menu to switch to Finder.

How can I upgrade my old rubiTrack file to rubiTrack 6?

All you need to do is open your rubiTrack 5/4/3/2 file in rubiTrack 6 via "File > Open…" from the main menu.

First you need to know where your put your old file (see Where is my rubiTrack file?).

  1. Start rubiTrack 6.
  2. Select "File > Open…" from the main menu.
  3. Select your old rubiTrack file.
  4. rubiTrack 6 will offer to upgrade the data, click "Upgrade".
  5. Select a new file name for the upgraded data, then continue.

Depending on the version you are upgrading from, the upgrade process may take some time to complete.

How can I transfer my data from rt2go to rubiTrack 6?

Data from rt2go can be upgraded to rubiTrack 6 by copying the data file:

  1. Install rubiTrack 6 on the device you have rt2go running on.
  2. Go to the home screen on the iPhone.
  3. Terminate both apps via the Task Manager (if they are running).
  4. Open the "Files" app.
    1. Find the folder called "rt2go".
    2. Long-press the file with the .rubitrack5 file extension (there should be only one).
    3. Select "Copy".
    4. Go back to the root level, find the folder called "rubiTrack 6".
    5. Inside "rubiTrack 6", long-press the file with the .rubitrack6 file extension (there should be only one).
    6. Select "Delete".
    7. Long-press the empty area and select "Paste" from the menu.
  5. Now that the data is copied, launch rubiTrack 6.
  6. An alert at the end of the loading process will confirm the data upgrade.

Syncing with TomTom

In order to direct sync with your TomTom device, you need to set up the TomTom MySports Connect software appropriately.

  1. Install the TomTom MySports Connect software.
  2. Set up TomTom MySports Connect to export FIT files on the "UPLOAD & EXPORT" page (Click "ADD" and select "FIT-format for training applications").
  3. Make sure you're not exporting multiple file formats as this will lead to duplicates in rubiTrack.
  4. If you changed the name of your TomTom watch, go to rubiTrack's advanced import preferences and enter the name of your watch (via "rubiTrack > Preferences >> Advanced" from the main menu).
  5. Download activities from your TomTom device using the TomTom MySports Connect software.
  6. When finished, you can use rubiTrack 6 to sync the data.

What if I find a bug?

If you find a problem please do not hesitate to let us know and email us. We appreciate your feedback!

Where did the forum go?

Due to the continued poor acceptance of the offer combined with the high level of maintenance it requires, we decided to close the forum with the release of rubiTrack 6.1.

That doesn't mean you are on your own! We remain at your disposal for any questions or problems you may have.

System Requirements

rubiTrack 6 is compatible with macOS Monterey (12.0, 64 bit), macOS Big Sur (11.0, 64 bit), macOS Catalina (10.15, 64 bit), macOS Mojave (10.14, 64 bit), macOS High Sierra (10.13, 64 bit), macOS Sierra (10.12, 64 bit) and macOS El Capitan (10.11, 64 bit). WiFi sync requires a Mac built 2012 or later.

rubiTrack 6 is available for iPhone running iOS 11 or later.

Licensing Questions

Universal App Subscription

rubiTrack 6 is available as a cross-platform subscription for your Mac and iPhone. When subscribed, all features are available for both the macOS and the iOS version. rubiTrack 6 is available as a yearly subscription.

Subscriptions can be canceled from your App Store settings. https://apps.apple.com/account/subscriptions Click here to read more on the Apple support pages.

Is there a trial version?

Yes. When you subscribe for the first time, you can test rubiTrack 6 for 7 days. You will not be charged, if you cancel the subscription at least one day before the end of the trial.

The trial version is functionally identical to the full version.

Can I use rubiTrack if I don't subscribe?

Yes. If you use rubiTrack without active subscription, there is a limited feature set available, depending on the device you are using.

I recently purchased rubiTrack 5, are there any offers?

If you purchased rubiTrack 5 on or after April 1 2021, you may choose to use rubiTrack 6 with a free one year suscription.

We will contact you about this offer shortly.

Dropbox Questions

Do NOT put rubiTrack files in your Dropbox!

Your rubiTrack file will get damaged if you do!

Dropbox does not handle Mac package files (which is a folder containing other files and folders) correctly when you put them into the Dropbox sync folder. rubiTrack for Mac uses such a package file format. Under certain circumstances, Dropbox will corrupt such files, which can cause some or all data to be lost or become unreadable. This is a problem known to Dropbox for many years and it affects not just rubiTrack but hundreds of Mac apps that use a package file format.

Do NOT use Dropbox or similar sync service with your rubiTrack for Mac file. If you want to sync multiple Macs using Dropbox, create a ZIP'd copy of your rubiTrack for Mac data file and put that into your Dropbox instead.

Why are rubiTrack's measurements different from my device's measurements?

rubiTrack calculated measures are not necessarily wrong, they're just different from what the device shows you (which sometimes is definitely wrong).

Differences part 1: Calculation vs. Copying

Whenever possible rubiTrack calculates all values it displays based on the data the device reports for the workout. The data usually consists of a stream of GPS data and heart rate, cadence, power values, and so on.

Garmin Training Center (and others) use the device-calculated averages and absolute values (like distance, duration and average heart rate) unverified. This often leads to a displayed distance that does not agree with the GPS data.

rubiTrack allows the display of calculated data or original device data. You can easily switch between the two at any time (Activity > Update Activity > Using Original Device Data).

Differences part 2: Calculation errors

In many cases the distance the device calculates is slightly different from what rubiTrack calculates. rubiTrack uses a high-precision algorithm that works very reliably, more reliable than what a device could possibly calculate given its very limited computing power. Also, in some cases the distance can differ significantly because - like any other computer - GPS devices have bugs. And those cause rather big errors in distance calculations on the device from time to time.

In both cases a difference in calculated distance will cause a - possibly significant - discrepancy in average speed, pace and other values.

Differences part 3: Different Algorithms

There are also other reasons for values being different. Those are not necessarily errors in calculations, instead they are caused by different methods of how they are calculated.

One example is maximum speed. Largely because of the very coarse time base GPS coordinates are timestamped with, calculating a maximum speed value between 2 points only leads to incorrect results. Values calculated this way would be unrealistically high if the timestamp induced error is large enough - which tests show they are.

This is why we use a running average over a couple of points to calculate the maximum speed. Garmin also does this on the device. You can verify this by watching the speed measure on the device when you stop. You will notice that the speed reported by the device will not jump to zero instantly, instead speed will drop to zero gradually. This is because it's an average over the last couple of points recorded by the device.

The reason why the values differ between rubiTrack and your device is that the way these running averages are build differ. They are calculated in different ways, both are correct.

Differences part 4: Too many unknowns

One other popular example is the calorie calculation. If you are using a heart rate monitor, chances are that the number rubiTrack calculates is different from the number your device calculated. Again, this is because the device uses a different algorithm than rubiTrack in order to calculate the calories burned. Unlike in the above maximum speed example though, there is a very high probability that both rubiTrack and the device got it wrong. This is because it's incredibly difficult to calculate burned calories with only a handful of data that is available for the calculation. Regardless of where the value is coming from, always know that this is only an estimation and it's very likely not what the real calorie expenditure was.

So, while rubiTrack does not agree with the device on the burned calorie value, neither of the calculations give you an accurate number, both are estimations.