VeloViewer Race Hub and Live App

  • VeloViewer Race Hub – Provides a central location to view the details of all of your races for the season.
  • VeloViewer Live App – An app which runs on Android and iOS devices to show the upcoming course and distance to upcoming waymarkers.

There are two type of user, one with full access and the other with some restrictions:

  • Full access – Sports directors and coaches.
  • Restricted access – Riders and support staff.

The main differences being that those with restricted access can not create waymarkers for others to see on routes or create training camps in the Race Hub.  They can however make local changes to the waymarkers for a race (stored in their browser so not visible to others) in order to create personalised TCX files for use on the rider’s head-unit.

Latest New Features

See this page for a list of the new features as they are released.

Race Hub

For a more detailed overview of everything provided by the Race Hub (and Live app) then please take a look at this document.

Live App

Check out the document linked directly above for an overview of the Live app.  Here is a video of it in action:

To get the Live app up and running on your phone/tablet then please check out this guide.

If you have trouble getting your device to show your location please see this troubleshooting guide.

I also have this video that takes you through the set up of the Live app on an iPad:

Waymarkers (POIs)

Waymarkers can be added along a race route to highlight climbs, springs, feeds, dangers and any other information useful to the sports director in the car and to the rider.  When a user with full access adds a waymarker it will be visible to all other users in both the Race Hub and the Live app. When a user with restricted access adds/edits a waymarker the change will only be visible to them on that device/browser. This is to allow riders to personalise the waymarkers they want to see on their head-unit without impacting what others see.

Here is a video showing how best to set up waymarkers:

There have been a few changes since the recording of this video to make things a bit simpler.  Most importantly, you can now right click the map to add a waymarker at a specific location.

Note that I store waymarkers based on their lat/lng location, not the distance into the route, so if a route is changed in a way that affects its length, this won’t affect any waymarkers you already have set up.

Important: Do make sure you set waymarkers based on their location, using StreetView if necessary to ensure the correct position.  The distances provided in the race schedules can be used as a guide but for numerous reasons these can be a little different to the distances you see in VeloViewer.  It isn’t that one distance is wrong and another correct, they are just being measured slightly differently. Don’t rely on the race schedule distance as being perfectly accurate!

VeloViewer Live App “Recon mode”

The “Recon mode” allows users to add, edit and delete waymarkers directly in the Live app. Users will full access can add and modify any of the waymarkers whereas users with restricted mode (i.e. team helpers) can just add a feed/bidon waymarker to mark their position.  These new or edited waymarkers will then be automatically pushed to the other users using the Live app (note: internet connection required).

Turn on Recon mode in the Live app’s settings to see the buttons to add new waymarkers and the additional options to edit, move and delete existing waymarkers.

Please watch this video for a run through of how it works:

Viewing Routes and Waymarkers on GPS Head-Units

On many GPS head-units you can load up the route and waymarkers and view them during the race.  Pressing the “GPX/KML/TCX” button (on the right, just below the elevation profile) in a Race Hub route will create 4 buttons that let you download the appropriate file.  Important: The file will be created for the current selection of the course so if you are wanting the whole course in the file, make sure nothing is selected in the elevation profile.

  • GPX Track – This does not contain the waymarkers. It is the equivalent of a recording of someone riding the route.
  • GPX Route – This does include the waymarkers as GPX “waypoints”. For head-units that don’t support TCX files (e.g. Bryton I think), this would be the one to try getting onto your device. Please get in touch if having trouble.
  • KML – This does not currently contain waymarkers and lets you open the route in applications like Google Earth.
  • TCX – The does include the waymarkers and is the file to use on Garmin and Wahoo Elemnt head-units.


Getting the TCX file onto a Garmin Edge head-unit using a laptop and a USB cable is very easy: just connect the Garmin to the laptop and drag the saved TCX file into the Garmin’s “NewFiles” folder.

If you don’t have a laptop then it gets a bit trickier.  Trying to import a TCX file via the Garmin Connect app doesn’t work because it strips out all of the CoursePoints (i.e. the waymarkers) contained in the file.  I’ve reached out to Garmin to see if they can stop this from happening (7th March 2019).  You can however use the Dynamic Watch iOS and IQ app to get TCX files onto your Garmin head-unit with the waymarkers still intact.  It does require $10 yearly subscription to use. Please get in touch for more information on this.

On a Garmin you will probably need to turn off the “Turn Guidance” and “Recalculation” navigation options. This is where the options are found on an 820:
  • Start page
  • Navigation
  • Courses
  • Saved Courses
  • The menu button in the bottom right corner
  • Turn Guidance = off


  • Start page
  • The menu button in the booth left corner
  • Settings
  • Activity Profiles
  • [Your activity profile]
  • Navigation
  • Routing
  • Recalculation = off

…and finally…

  • Start page
  • The menu button in the booth left corner
  • Settings
  • Activity Profiles
  • [Your activity profile]
  • Navigation
  • Map
  • Guide Text = Never Display

Garmin data fields for next waymarker

Garmin’s have a dedicated page listing the remaining waymarkers as shown in the image above. You can also add data fields to any page to show the text for the next waymarker along with the distance to the waymarker’s location.

The “Dist to next” data field can be found under the “Courses” group.

The text for the next waymarker isn’t available by default on the Garmin but I have a custom, Connect IQ data field which you can download here.  Right click that link and save onto your computer. Then connect your Garmin and drag the file to the “Garmin/Apps/” directory.  Then you will see a data field in the “Connect IQ” group called “dfCrsNextPtName”.



The Wahoo Elemnt app will import a TCX file into the routes perfectly. Just download the TCX file from the Race Hub on the device with the Wahoo Elemnt app installed (i.e. phone or tablet) and open it the Wahoo app.  The next time you sync your routes on the Elemnt the imported route will be listed.  Note that your Elemnt needs to be connected to a WiFi to sync the routes, the bluetooth connection to the phone won’t work for this.  If you don’t have a hotel WiFi to connect to, just turn on your phone’s WiFi hotspot and connect the Elemnt to that and it should sync.


The Dash L10/M50/L50 should work with TCX files including waymarkers.  I’ve been providing the guys at Stages with sample TCX files for them to test with.  I’ll update these instructions once the devices are released.


I’ve not had chance to test these devices yet and online help info is hard to find. I don’t believe they will work with TCX files so please try the “GPX Route” file.  I’m not sure how you go about getting these files onto the device.  Please get in touch if you have success with this device and I’ll write up how it is done.


The new Pioneer devices should work with TCX files but the current firmware isn’t very reliable when trying to follow a route.  If you have further information on how to work with these units then please get in touch.


The Sigma head-units should work with waymarkers but I’m not sure which file types are supported or how you get them onto the device. Please get in touch if you know.


I believe the Giant head-units are a rebadged Bryton so may not work with waymarkers. if you know any different then please get in touch.

About VeloViewer

VeloViewer was started in 2012 by me, Ben, as a way to view my own Strava data. It quickly grew to be used by many cycling data-geeks from around the world.  At the end of 2015 I heard that Team Sky (and others) were using some of the elevation profile graphics in team presentations so we hooked up through the 2016 season and developed the beginnings of the Race Hub.  In 2017 Orica-Scott also came on board and the Live app was conceived and the first version built.  Each year since has seen more men’s and women’s teams sign up to the package.

VeloViewer is still just run by Ben in Sheffield (UK) so if you get in touch, it’ll be me that you deal with.