This guide covers the currently published App Store version of onTrackTools. It explains how to import VBO telemetry, manage tracks and vehicles, compare laps, use video, and troubleshoot common issues.

---

Table of Contents

• Overview
• Quick Start
• Platform Navigation
• Main Window
• Sessions List
• Laps Table
• Charts Panel
• Map Panel
• Video Panel
• Import Session Data
• Session Editor
• Track Configuration Editor
• Tracks Manager
• Garage
• App Settings
• Subscriptions and Store
• visionOS Features
• Troubleshooting
• Suggested Future Help Topics

---

Overview

onTrackTools is a multi-platform telemetry analysis app for macOS, iOS, iPadOS, and visionOS. It imports .VBO telemetry sessions, detects laps from track start/finish lines, shows lap and sector timing, overlays telemetry traces, synchronizes video, and helps you manage tracks, configurations, vehicles, and setups.

The current app focuses on VBO session data, including RaceBox/VBOX-style channels such as GPS position, speed, heading, height, and acceleration. Imported sessions can be analyzed locally and synced across devices with iCloud when CloudKit is available.

• Import .VBO telemetry sessions, optionally with video from Photos or Files.
• Create and reuse tracks, track configurations, start/finish lines, finish lines for open courses, and sector split markers.
• Select compatible sessions from the same track and direction for comparison.
• Select up to two laps and compare lap time, sector time, speed, acceleration, map position, and synchronized video.
• Manage vehicles, configurations, and setups in Garage, then link them to imported sessions.
• Use iCloud sync for sessions, tracks, configurations, garage data, and Photos-based video references when available.

---

Quick Start

1. Open onTrackTools and choose Import data from the toolbar or File > Import session data on macOS.
2. Select a .VBO file. On macOS, you can also double-click a .VBO file in Finder or drop it on the onTrackTools Dock icon to open the import sheet with the file preselected.
3. Add optional session notes and confirm the session date. Leave Load from file enabled when the VBO file contains a valid timestamp.
4. If the session has video, enable Session has video, then select video from Photos or Files. Set the video offset to the moment the car crosses the start line for the first timed lap.
5. Choose an existing track and track configuration, or create a new track/configuration and adjust the start/finish marker in the preview map.
6. Optionally link the session to a Garage vehicle, vehicle configuration, and setup.
7. Click Import. The session appears in the Sessions list.
8. Select a session, then select one or two laps from the Laps Table.
9. Use the charts, map, and video panel to compare braking, corner speed, acceleration, sector deltas, and car position.

---

Platform Navigation

macOS

On macOS, the main window uses a session sidebar and an analysis workspace. The Window menu includes Show track manager and Show Garage. The app also provides separate windows for the Track Editor, Session Editor, Vehicle Configuration Editor, Vehicle Setup Editor, and video playback when those tools are opened.

• File > Import session data imports a .VBO session.
• File > Migrate Videos to Photos Library… opens the video migration settings.
• Edit > Edit session opens the selected session’s metadata and video editor.
• Edit > Edit track configuration opens the Track Editor for the selected session.
• View controls the video pane, entry/exit laps, map follow mode, map fitting, and time- vs distance-based comparison.
• Help > On-line Help opens this online help page.

iPadOS

On iPad, the regular-width layout adds a segmented navigation control for the main sections: Analysis, Garage, Tracks, and Settings. The Analysis section uses the session list and analysis workspace. Garage and Tracks can be managed directly from their sections.

iPhone

On iPhone, the workflow is intentionally step-by-step. Select a session from the Sessions list, tap View Laps or Compare Sessions, select one or two laps, then tap Analyze Lap or Compare Laps. In portrait orientation the analysis view shows map or video above the charts. In landscape orientation, the toolbar lets you switch between charts and video.

visionOS

On visionOS, session controls and analysis tools are presented as ornaments around the main window. Garage, Tracks Manager, Track Editor, Video, and the volumetric track map can open as separate spatial windows when available.

---

Main Window

The main window is where you select sessions, choose laps, and analyze the selected data. With a session selected, the upper area shows lap and sector timing. The lower area is split between the map and chart panels. If video is available and enabled, the video panel appears above the lap table.

If no session is selected, the analysis workspace displays Select or import a session.

Sessions List

The Sessions list shows every session currently available in the app database. Each session is created from one imported .VBO file.

Select a session to load its laps into the Laps Table. You can select more than one session, but onTrackTools only keeps sessions that are compatible with the first selected session.

• Compatible sessions must use the same track.
• Compatible sessions must use the same track direction, clockwise or counter-clockwise, as defined by the track configuration.
• When multiple sessions are selected, the analysis uses the track configuration from the first selected session.

Session Controls

• Import data opens the Import Session sheet. If you are using the free version and already have a session, this opens the Store instead.
• Edit opens the selected session in the Session Editor.
• Edit conf. opens the Track Editor for the selected session’s current track configuration.
• Delete moves the selected session or sessions to a soft-deleted state after confirmation.

The free version is limited to the import and/or analysis of a single session. The Sessions list shows an Unlock full version row when you need a subscription or lifetime purchase to manage more sessions.

iCloud Status

When iCloud sync is active, onTrackTools syncs sessions, tracks, configurations, settings, and garage data through CloudKit. If CloudKit is unavailable, a status bar shows iCloud Unavailable – Using Local Store and the app continues with local storage. While incoming CloudKit updates are being imported, a Syncing with iCloud… indicator may appear.

Laps Table

The Laps Table shows the laps detected from the selected session or compatible session set. Select one lap for single-lap analysis or up to two laps for comparison. Selecting the same lap again deselects it.

The table includes these columns:

• Lap: the lap number within the session data.
• Time: the detected lap time.
• Delta: the time difference from the best lap currently shown.
• VMax: the maximum speed during the lap, displayed in your selected speed unit.
• S. 1, S. 2, …: sector time or sector delta columns. Sector headers use the same colors as the map and chart sector bands.

The best lap is shown in bold. The fastest sector among the visible laps is highlighted in purple text. A sector that is faster than the corresponding sector of the best lap is shown in green text. Clicking or tapping a sector header zooms the map and charts to that sector; clicking or tapping the same sector again returns to the full lap.

Entry and Exit Laps

The entry lap and exit lap are usually partial laps. Use the Hide in/out control or the View menu to hide or show them. Hiding them reduces clutter when you are focused on timed laps.

Best and Ideal Lap Summary

The summary table below the Laps Table compares the best lap against an ideal lap. The ideal lap is calculated by summing the best sector times available in the currently selected session set. The summary shows total lap time, delta improvement, VMax, and sector-level improvement opportunities.

Charts Panel

The Charts Panel shows the selected telemetry traces for the selected lap or lap comparison. The default traces are Speed and Time Delta. The time delta trace is most useful when two laps are selected.

Time-Based and Distance-Based Comparison

The chart x-axis can be time-based or distance-based. Time-based comparison aligns traces by elapsed lap time. Distance-based comparison aligns traces by distance along the lap, which is usually better for comparing braking points, apex speed, and acceleration zones. Set the startup default in App Settings, or switch during analysis from the View menu or visionOS ornament.

Data Playhead

The vertical dashed playhead marks the current analysis position. The chart legend shows the values at the playhead. The map car marker and video playback position stay synchronized with the playhead.

Available Traces

The trace selector only shows traces available for the selected session set. If you select multiple sessions, a trace must be available in all selected sessions before it appears as selectable.

• Speed
• Time
• Time Delta
• Distance
• Sector
• Latitude and Longitude
• Heading
• Height
• Longitudinal Acceleration
• Lateral Acceleration
• Vertical Acceleration

Some VBO files may contain different channel names or may omit optional channels. If an expected trace is missing, confirm that the original file contains a supported channel and that the same channel is present in every selected session.

Trace Selection

Use the Traces control to open the trace selector. Enable or disable traces with the switches in the selector. On iPhone, the trace selector opens as a sheet with a Done button.

Map Panel

The Map Panel shows the GPS trace of the selected lap or laps. It displays the start/finish marker, optional open-course finish marker, sector dividers, colored sector overlays, and synchronized car-position markers.

When two laps are selected, onTrackTools sorts the compared laps by lap time. The faster lap uses the green trace and marker; the slower lap uses the red trace and marker.

Map Controls

• Fit map zooms the map to fit the full trace or active sector.
• Pin Car follows the synchronized car marker as you scrub through the data.
• Clicking or tapping a sector header, map sector, or chart sector band can zoom the analysis to that sector.

Video Panel

The Video Panel is hidden by default. Use the video-panel button, the View menu, or the platform toolbar/ornament to show it. If the selected session has no video, the video control is disabled.

Playback and scrubbing are synchronized with the chart playhead and map car position. When two laps are selected, the faster lap is shown on the left and the slower lap is shown on the right.

Videos can be linked from Photos or from Files. Photos-based videos are the best option for cross-device use because iCloud Photos can make the asset available on other devices. File-based videos depend on the original file location and security-scoped bookmark remaining available.

If a Photos video is stored in iCloud Photos and is not yet local, onTrackTools shows a loading state and retries the request. If Photos access is limited, the app may ask you to grant access to the selected video or open Settings.

---

Import Session Data

The Import Session Data sheet creates a new session from a .VBO telemetry file. The sheet can be opened from Import data, File > Import session data on macOS, or by opening a .VBO file directly on macOS.

Data File and Session Metadata

• Data File: select the .VBO telemetry file. After a valid file is selected, the GPS trace preview appears.
• Description: add notes or a short label for the session.
• Date: keep Load from file enabled to use the timestamp from the VBO file, or disable it and set the date manually.

Video

• Session has video: enable this when you want synchronized video.
• Photos: choose a video from the Photos Library.
• Files: choose a video file from local or cloud file storage.
• Offset: set the timestamp where the car crosses the start line for the first timed lap. Use the preview playback controls to find the crossing.

Vehicle and Setup

If you use Garage, you can link the imported session to a vehicle, vehicle configuration, and setup. onTrackTools creates session-scoped copies of linked configurations and setups so the historical session remains stable even if the base Garage records are changed later.

Track and Configuration

• Track: choose an existing track or create a new one.
• Track Name: required when creating a new track.
• Track Config: choose an existing configuration or create a new one.
• Config Name: required when creating a new configuration.
• Direction: choose clockwise or counter-clockwise when creating a new configuration.
• Open Course: enable when the data is point-to-point instead of a closed circuit. Open-course configurations use separate start and finish markers.

When creating a new track or configuration, drag the start/finish marker in the preview map so it crosses the driven GPS path. Accurate marker placement is essential for accurate lap timing.

Import Validation

The Import button is enabled only when the required file, track, configuration, and video selections are valid. If the button is disabled, check for missing names, missing file selections, or an enabled video option without a selected video.

---

Session Editor

The Session Editor lets you update an existing session without re-importing it. Open it from the selected session’s Edit button, the Edit menu on macOS, or the session context menu.

• Edit the session description and date.
• Add, remove, or replace synchronized video.
• Change the video source between Photos and Files.
• Adjust the video offset.
• Link or change the Garage vehicle, configuration, and setup for the session.
• Change the track and track configuration assigned to the session.

Changing the track configuration can change lap detection and sector timing. Review the Laps Table after saving session edits.

---

Track Configuration Editor

The Track Configuration Editor is used to refine timing markers and sectors for a track configuration. It opens from Edit conf., Edit > Edit track configuration on macOS, the Tracks Manager, or the import flow when creating a new configuration.

• Add sector: add a sector divider at the current marker position.
• Remove sector: remove the selected sector divider.
• Reset config: return the editable markers to the saved configuration.
• Apply config: save the edited marker positions and recalculate session analysis.

Drag start/finish and sector markers on the map to refine timing. Apply the configuration after you finish editing. onTrackTools recalculates lap and sector data for the selected session after the configuration is applied.

Closed Courses and Open Courses

A closed-course configuration uses one start/finish separator. This is the normal mode for circuit laps. An open-course configuration uses separate start and finish separators and is intended for point-to-point data. Open-course configurations require at least two separators.

---

Tracks Manager

Tracks Manager shows the tracks created from imported sessions. Select a track to view its configurations. Each track row shows the number of sessions and configurations associated with that track.

• Rename a track by double-clicking its name on macOS or using the context menu.
• Delete a track only when no sessions are linked to it.
• Select a track to see its configurations, direction, sector count, session usage, and last update date.
• Rename a configuration by double-clicking its name on macOS or using the context menu.
• Edit a configuration with the slider/control button.
• Delete a configuration only when no sessions are using it.
• Add a configuration with the Add row at the bottom of the selected track’s detail view.

If a track is missing its reference lap, Tracks Manager shows a repair banner. Use Repair Reference Lap to rebuild the reference lap from existing sessions before adding new configurations.

---

Garage

Garage manages vehicles, vehicle configurations, and setups. It helps you keep a record of the car and setup used for each session, then link those records to imported telemetry.

Vehicles

A vehicle stores a name, make, model, color, year, vehicle type, description, and optional photo. Add a vehicle with New vehicle. The new vehicle starts with a base configuration and default configuration elements for its vehicle type.

• Add or change a vehicle photo from Photos or Files.
• Set the current active configuration with Set Active.
• Delete a vehicle only when none of its configurations or setups are linked to sessions.

Vehicle Configurations

A vehicle configuration describes the physical or build-level state of the vehicle, such as components, tires, brakes, suspension hardware, or other configurable metadata. The exact element list depends on the vehicle type and the Garage metadata bundled with the app.

• Add Configuration creates a new configuration.
• Clone Selected creates a copy of the selected configuration, optionally carrying over the selected setup.
• Set Active marks the selected configuration as the vehicle’s current configuration.
• Remove Selected soft-deletes the selected configuration and its setups.
• Show disabled displays disabled configuration elements.
• Add Element adds an allowed configuration element when dependencies and multiplicity rules permit it.

Configuration elements may have units, numeric limits, steps, enum choices, and dependency rules. Disabled elements can be hidden or shown from the Garage toolbar.

Setups

A setup is tied to a vehicle configuration and describes adjustable values used for an event or session, such as setup ranges, values, or per-corner/per-axle entries. Setup elements are created from the Garage metadata and can be associated with enabled configuration elements.

• Add Setup creates a setup for the selected configuration.
• Clone Selected copies the current setup.
• Remove Selected soft-deletes the selected setup.
• Add Element adds an allowed setup element.
• Some setup elements appear or disappear depending on the enabled configuration elements.

Session-Linked Configurations and Setups

When you link a session to a Garage configuration or setup during import or session editing, onTrackTools creates a session-scoped copy. This protects the historical session from later changes to your base Garage configuration. Use Show session-linked in Garage to reveal or hide these session-specific copies in the Garage list.

---

App Settings

Settings are available from onTrackTools > Settings on macOS, the Settings section on iPad, and the Settings sheet on visionOS. On iOS, settings also include subscription management and a link to the online help.

Analysis Preferences

• X-Axis base type: choose Time or Distance as the startup chart comparison mode.
• Show in-out laps: choose whether entry and exit laps are visible at startup.
• Follow car position: choose whether the map follows the synchronized car marker at startup.

Units Preferences

• Distance: meters, kilometers, yards, feet, or miles.
• Speed: kilometers/hour, miles/hour, meters/second, feet/second, or yards/second.
• Acceleration: Gs, meters/second squared, feet/second squared, or yards/second squared.
• Temperature: Celsius, Fahrenheit, or Kelvin.
• Altitude: meters or feet.

User Interface Preferences

• Show toolbar labels: show or hide text labels next to toolbar icons where supported.
• Show laps table while video is active: keep the lap table visible below video when the video pane is open.
• Use Volumetric Map on visionOS: enables the separate volumetric track map window.

Video Library

Enable Always save imported videos to Photos when you want file-selected videos to be copied into the Photos Library during import. Use Migrate to Photos to convert sessions that still use local file references. Migrating to Photos improves cross-device video resolution through iCloud Photos.

---

Subscriptions and Store

The free version is limited to the import and/or analysis of a single session. To import and manage multiple sessions, purchase a subscription or lifetime license from the onTrackTools Store.

• Monthly subscription: full-version entitlement while the subscription is active.
• Yearly subscription: full-version entitlement while the subscription is active.
• Lifetime purchase: one-time non-consumable purchase for full-version entitlement.
• Restore Purchases: use this if your entitlement is not recognized after reinstalling, changing devices, or signing in again.

On iOS and visionOS, the Store view includes links to the Apple standard license agreement and the LVSoftware.io privacy policy. If App Store products cannot be loaded, the Store shows a retry-later message.

Image placeholder: Add a Store screenshot showing the free-version note, subscription options, lifetime purchase, and Restore Purchases button.

---

visionOS Features

Analysis Ornaments

On visionOS, the session list and analysis controls are displayed as spatial ornaments. The analysis ornament includes controls for video, entry/exit laps, time/distance comparison, traces, and either the volumetric map or regular map controls depending on settings.

Volumetric Track Map

If Use Volumetric Map is enabled in Settings, the analysis ornament can open the Track map volume. The volumetric map shows the same synchronized trace/map data in a circular spatial presentation. Its ornament includes Fit map to volume and Follow car position.

Image placeholder: Add a visionOS screenshot or capture showing the main analysis window, the analysis ornament, and the volumetric track map volume.

---

Troubleshooting

The Import button is disabled

• Confirm that a .VBO data file is selected.
• If creating a new track, enter a track name.
• If creating a new configuration, enter a configuration name.
• If Session has video is enabled, choose a valid video from Photos or Files.

No laps were detected

• Verify that the selected track configuration matches the session.
• Check that the start/finish marker crosses the driven GPS path.
• For open-course sessions, verify both start and finish markers.
• Open the Track Editor, adjust the markers, apply the configuration, and try again.

A session cannot be selected with another session

onTrackTools filters multi-session selection to compatible sessions only. The sessions must use the same track and same direction. If a session is removed from the selection, check its assigned track and track configuration in the Session Editor.

Expected chart traces are missing

The trace selector only shows supported channels present in the selected session set. If multiple sessions are selected, each trace must be present in all selected sessions. Some VBO files may use unsupported or unexpected channel names.

Video is not available or does not load

• Open the Session Editor and confirm that Session has video is enabled.
• If the video is from Photos, confirm that onTrackTools has Photos access.
• If Photos access is limited, include the required video in the app’s allowed selection or grant full Photos access.
• If the video is stored in iCloud Photos, wait for it to sync or use the Retry button.
• On visionOS, if a Photos asset has not synced to the device, re-link the video from iOS or macOS after the video is available in Photos.
• If the video was linked from Files and the file moved or the bookmark expired, reselect the file in the Session Editor.

Subscription is not recognized

Open the onTrackTools Store and use Restore Purchases. The app verifies entitlements at launch and may briefly show Verifying purchases… while StoreKit checks current transactions.

iCloud is unavailable

If CloudKit cannot be opened, onTrackTools shows iCloud Unavailable – Using Local Store and continues locally. Check that you are signed into iCloud, that iCloud Drive/CloudKit services are available, and that network access is working. Data created while using local storage may not appear on other devices until iCloud is available again.

A track configuration cannot be deleted

A configuration cannot be deleted while sessions use it. Reassign or delete those sessions first. The Track Editor delete flow replaces affected sessions with a default configuration when possible, but the Tracks Manager delete button is disabled for configurations currently in use.

A vehicle cannot be deleted

A vehicle cannot be deleted while its configurations or setups are linked to sessions. Remove or edit the session links first.

---

For additional support, use the contact page at lvsoftware.io/contact-us/.