onTrackTools – online help

This guide covers the currently published App Store version of onTrackTools. It explains how to import VBO and MoTeC LD telemetry, manage tracks and vehicles, compare laps, create calculated Math Channels, generate track sectors, use video, and troubleshoot common issues.

What’s New Since The Previous Help Update

The previous online help described the 1.1.x feature set. The app has since added major import, track-management, analysis, and charting capabilities.

Built-in race track library: browse predefined tracks from Tracks Manager without importing telemetry first.
Automatic track detection: imported sessions are matched against existing and built-in tracks when possible.
MoTeC LD import: import .ld log files in addition to RaceBox/VBOX-style .vbo files.
Logged channels: channels present in imported log files appear dynamically in the trace selector.
Math Channels: create calculated traces using expressions, unit-aware inputs, aliases, and per-session input overrides.
Automatic sectors: generate sectors from corners, braking zones, speed peaks, or equal-distance splits in the Track Configuration Editor.
Analysis state restoration: lap selection, chart traces, zoom, scrubber position, map state, sector zoom, and follow-car mode are remembered per selected session set while the app is running.
Large-file sync improvements: telemetry blobs are stored in a compressed onTrackTools format to make large sessions more reliable with iCloud sync.

Overview

onTrackTools is a multi-platform telemetry analysis app for macOS, iOS, iPadOS, and visionOS. It imports 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 supports RaceBox/VBOX-style .vbo files and MoTeC .ld log files. Imported sessions can be analyzed locally and synced across devices with iCloud when CloudKit is available.

Import .vbo or .ld telemetry sessions, optionally with video from Photos or Files.
Use the built-in track library or create custom tracks and configurations.
Let onTrackTools auto-detect the track during import when the data matches a known layout.
Create and reuse start/finish lines, open-course finish lines, 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, logged channels, Math Channels, 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, settings, Math Channels, and Photos-based video references when available.

Quick Start

Open onTrackTools and choose Import data from the toolbar or File > Import session data on macOS.
Select a .vbo or .ld file. On macOS, double-clicking a supported telemetry file or dropping it on the Dock icon opens the import sheet with the file preselected.
Wait for the track preview to load. If onTrackTools recognizes the session, it may automatically select a matching track from your database or the built-in track library.
Add optional session notes and confirm the session date. Leave Load from file enabled when the telemetry file contains a valid timestamp.
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.
Choose or confirm the track and track configuration. If you create a new track/configuration, adjust the start/finish marker in the preview map.
Optionally link the session to a Garage vehicle, vehicle configuration, and setup.
Click Import. The session appears in the Sessions list.
Select a session, then select one or two laps from the Laps Table.
Use the charts, map, video panel, logged channels, and Math Channels 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, Show Garage, and Show Math Channels. The app also provides separate windows for the Track Editor, Session Editor, Vehicle Configuration Editor, Vehicle Setup Editor, video playback, and Math Channels library.

File > Import session data imports a .vbo or .ld 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.
Window > Show Math Channels opens the Math Channels library.
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 Analysis, Garage, Tracks, Math Channels, and Settings where available. The Analysis section uses the session list and analysis workspace. Garage, Tracks, and Math Channels can be managed from their own 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. Math Channels are managed from the app navigation.

visionOS

On visionOS, session controls and analysis tools are presented as ornaments around the main window. Garage, Tracks Manager, Track Editor, Video, Math Channels, 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 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 telemetry 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.

When you switch between session sets during the same app run, onTrackTools restores the analysis state for each set. This includes selected laps, selected traces, sector zoom, scrubber position, chart viewport, map region, map type, and follow-car mode.

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, garage data, and Math Channels 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.

Large telemetry data is stored in a compressed onTrackTools container to improve CloudKit reliability, especially for large .ld sessions. Keep all your devices updated to the current app version so they can read newly compressed sessions.

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.

Standard Traces: built-in traces such as Speed, Time, Time Delta, Distance, Sector, Latitude, Longitude, Heading, Height, and acceleration channels.
Math Channels: calculated traces you create in the Math Channels library.
Logged Channels: additional channels imported from the source telemetry file. These are especially useful for .ld logs, where available channels depend on the logger or simulator export.

Some 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. Logged Channels include a search field so you can find a channel by name. On iPhone, the trace selector opens as a sheet with a Done button.

Math Channels

Math Channels let you define calculated telemetry traces and chart them alongside built-in and logged channels. A Math Channel is evaluated only when it is available for the selected session set and selected in the trace inspector.

Open Math Channels from Window > Show Math Channels on macOS, from the Math Channels navigation section on iOS/iPadOS, or from the Math Channels ornament/window on visionOS.

Creating a Math Channel

Open the Math Channels library.
Click or tap New Draft to start a new channel definition.
Enter a Name and Output label.
Enter a Unit label, or keep it unitless if the result is not a standard unit.
Write an expression using input variable names, numbers, operators, comparisons, and functions.
Add one or more inputs. Each input maps an expression variable to a built-in or logged channel label.
Use Signal Labels to browse channels from the currently selected sessions and add them as inputs.
Use Expression Reference when you need the supported operators and functions.
Check Current Session Preview for resolution and evaluation diagnostics.
Click Create Math Channel or Save Changes.

Expressions

Expressions support arithmetic operators, comparisons, parentheses, and common functions. Comparisons return 1 when true and 0 when false, which makes them useful with if(condition, trueValue, falseValue).

Arithmetic: +, -, *, /, and ^.
Comparisons: >, >=, <, <=, ==, and !=.
Functions: abs, min, max, clamp, sqrt, pow, log, exp, trigonometric functions, rounding functions, if, derivative, and integral.

Examples:

speed * 1.60934
sqrt(lat_g^2 + long_g^2)
if(speed > 1, derivative(speed), 0)
clamp(throttle, 0, 100)

Inputs, Units, Aliases, and Overrides

Each input defines the expression variable name, the required channel label, an optional expected unit, and optional aliases. When a compatible unit conversion is known, onTrackTools converts the input before evaluating the expression.

If automatic input matching is not enough for a specific session, use the preview/override flow to map an input to a different available trace for that session. This is useful when different loggers use different channel names for the same signal.

Using Math Channels In Charts

After a Math Channel is enabled and can be resolved for the selected session set, it appears in the Math Channels section of the trace selector. Select it like any other trace. The input traces do not need to be selected separately.

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 telemetry file. The sheet can be opened from Import data, File > Import session data on macOS, or by opening a supported telemetry file directly on macOS.

Supported Data Files

RaceBox/VBOX-style VBO: .vbo telemetry files remain supported.
MoTeC LD: .ld log files can be imported. Logged channels in the file become dynamic chart traces.

For .ld files that do not contain GPS coordinates, onTrackTools may reconstruct and align the session path against a detected track using available simulator/world-position data. If no complete lap can be found, it may estimate GPS coordinates from the full session and warn that accuracy may be reduced.

Data File and Session Metadata

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

Automatic Track Detection

After a file is loaded, onTrackTools attempts to match the session to existing tracks and to the built-in track library. A successful match selects the detected track automatically and displays an Auto-detected message. You can also use Detect manually after changing the data file or track selection.

If a built-in track is detected, onTrackTools materializes it in your local database so the imported session can use it like any other track.

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, use an auto-detected track, select a built-in library 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.

From left to right:

Reset config: return the editable markers to the saved configuration.
Apply config: save the edited marker positions and recalculate session analysis.
Add sector: add a sector divider at the current marker position.
Remove sector: remove the selected sector divider.
Auto sectors: open automatic sector detection.
Fit Map: adjust the zoom so that the track map fits the window

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.

Automatic Sector Detection

Automatic Sector Detection helps you create sector dividers from a selected complete lap. The result is temporary until you use Apply config, so you can detect, review, drag markers manually, reset, or try a different algorithm before saving.

Open the Track Configuration Editor, then use Auto sectors. The panel appears as an inspector on macOS/iPadOS, a background-interactive sheet on iPhone, and a trailing ornament on visionOS.

Algorithms

Corners: detects corners from lateral acceleration and places boundaries in the middle of the straights so each sector contains a corner complex.
Braking zones: detects sustained braking and places boundaries just before each braking point so each sector starts with corner entry.
Speed peaks: places boundaries at speed peaks reached at the end of each straight.
Equal distance: splits the lap into sectors of equal length.

Parameters

Sensitivity: higher sensitivity detects weaker features and generally produces more candidate sectors.
Limit sector count: keeps only the most significant boundaries up to the selected sector count.
Sectors: sets the target count for equal-distance sectors, or the limit when sector count limiting is enabled.
Advanced settings: tune corner merge distance, speed peak offset, or braking boundary offset depending on the selected algorithm.
Source lap: choose the complete lap whose telemetry will be used to place sectors.

If required data is missing, onTrackTools shows an availability note and uses fallback signals where possible. Automatic sector detection needs position and speed data, and some methods work best with lateral acceleration, longitudinal acceleration, or heading.

After detection, inspect the placed separators on the map. Drag any separator to refine it, then use Apply config to save or Reset config to discard.

Tracks Manager

Tracks Manager shows both user-created tracks and the built-in track library. You can browse tracks before importing telemetry, materialize a built-in track by selecting it, and manage configurations for tracks already in your database.

Use Filters to show or hide user-defined tracks, the built-in library, or tracks without sessions.
Use the search field to filter tracks by name.
Use the quick-jump side bar when the track list has many alphabetical sections.
Select a built-in track to materialize it locally and view its configurations.
Rename a user-defined 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 or has a corrupted configuration, Tracks Manager shows a repair banner. Use the repair action to rebuild or reset what can be recovered.

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. During an app run, onTrackTools restores follow-car state per selected session set.

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.

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, Math Channels, 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.

Troubleshooting

The Import button is disabled

Confirm that a supported telemetry file is selected: .vbo or .ld.
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.
For .ld imports, confirm that the file contains enough usable samples and that track alignment succeeded.

Automatic track detection did not choose a track

Track detection requires enough valid movement samples and a candidate track that matches the imported path. Choose a track manually, then adjust the configuration if needed. For .ld files without GPS data, check that the file metadata or driven shape can be aligned to a known track.

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. Logged channel names may vary by logger or simulator export.

A Math Channel does not appear in the trace selector

Confirm that the Math Channel is enabled.
Open the Math Channels library and check the validation status.
Make sure every input can be matched for the selected session or session set.
Use aliases or a per-session override when the source file uses a different channel name.
If multiple sessions are selected, the Math Channel must resolve for all selected sessions.

A Math Channel evaluates but looks wrong

Check input units and expected units.
Check whether the input is a built-in trace or a logged channel with a different scale.
Use Current Session Preview for diagnostics about missing inputs or invalid samples.
Use Expression Reference to confirm function names and argument counts.

Automatic sectors did not find boundaries

Choose a complete source lap with enough samples.
Try a higher sensitivity.
Try a different algorithm. Equal distance is the most predictable fallback.
Some algorithms work best when lateral acceleration, longitudinal acceleration, or heading are available.
After sectors are placed, remember to use Apply config to save them.

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 large session does not appear on another device

Large telemetry sessions use compressed storage in the current app. Make sure all devices are updated to the current App Store version. Then leave the source device open long enough for CloudKit to upload and the receiving device open long enough to import the update.

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/.