TrainingPeaks Virtual supports modding and completely custom UIs for individuals, broadcasters and other platforms.
- As an individual rider, you can now “mod” TrainingPeaks Virtual, using the raw data that goes into the UI display (e.g. the numbers in your HUD, rider lists, event results etc) to create overlays, dashboards or applications to display whatever you want, wherever and however you want it – all live and in real-time as you ride.
- As a broadcaster (NGBs / Organisers / Streamers etc) you can now present and broadcast your own races using your own branding, not anyone elses. With seamless integration of the raw UI data into streaming software such as vMix or Singular.live, you can now create professional quality branded broadcasts. Use your own logos, graphics, fonts and colour schemes to display all the information from your own events your own way.
- As another platform you can now benefit from all the back-end data processing that TrainingPeaks Virtual provides, but skinned to look like your own brand. Part of TrainingPeaks Virtual's mission is to be a “service-provider” to other platforms to raise the standard of online cycling everywhere, and this means that your platform can now have engaging tactics where riders skills and judgement matter, unparalleled accuracy and precision of results, and world class credibility from in-built performance verification, but in your own brand image for commercial broadcast, or integration with your own game-engine.
Custom UIs are initially being rolled out in Early Access to members of the TrainingPeaks Virtual Founders Club and will continue to be worked on and improved based on your feedback. Find out more about how you can get involved and help shape the future of online cycling by clicking here.
Accessing Data
TrainingPeaks Virtual provides two ways to access the raw UI data; local files and HTTP POSTs.
- Local Files. TrainingPeaks Virtual can be configured to write the data out to local files on the computer TrainingPeaks Virtual is running on. These can be monitored for changes through polling by a 3rd party application (for example, a local python script or 3rd party software such as vMix). Note that the local directory can of course be shared on a local network for access by other computers on your network, which can be useful if running streaming software separately from TrainingPeaks Virtual.
- HTTP POSTS. TrainingPeaks Virtual can be configured to POST the data out to configurable 3rd party URLs. These will be sent on interrupt whenever there are changes in the data and can be useful if running streaming software in the cloud (for example, 3rd party software such as Singular.live).
Either / both options can be set in the “Broadcast Settings” menu on the “Options” tab of The Hub.
Data Format
All data is supplied in JSON format using 4 different local files / HTTP POST streams.
- Focus data. Data about the current rider the camera is currently focussed on – their speed, distance travelled, TSS, relative wind direction etc.
- Nearest data. Data about the riders nearest to the rider the camera is currently focussed on – their name, country, team, speed, time gap etc.
- Entries data (Events only). Data about all the entries into the event – bib number, name, nationality, team etc.
- Groups data (Events only). Data about all the groups in the event – time gap from the leader, number of riders in the group, group leaders name etc.
- Individual Results data (Events only). Data about all the individual results in the event – positions, points scored, time taken etc.
- Team Results data (Team Events only). Data about all the team results in the event – positions, total points scored, time of best counting rider etc.
Additional data can be easily added. If there is anything extra that you would like to see, please just email virtual@trainingpeaks.com.
Design Principles
TrainingPeaks Virtual puts fairness at the heart of racing. As a fundamental design principle, modding and custom UIs should not provide a material competitive advantage to riders. As such, only data that is available for riders to view within TrainingPeaks Virtual will be available over the API to view outside TrainingPeaks Virtual.
The primary purpose of modding and custom UIs is to give you the option to be able to display the same data that is available to everyone in way that is tailored for you.