Uploading Data

TrackOut supports telemetry files from popular motorsport data loggers. All parsing happens in your browser, so your data stays private until you choose to save it.

Supported file formats

Connect a RaceBox

In Analysis or Track Days, choose Connect RaceBox in Chrome on macOS, allow Bluetooth access, and choose your device. Close the RaceBox app first so it releases the connection. Bluetooth requires HTTPS and a browser with Web Bluetooth support; other browsers can still upload saved .racebox capture files.

Use Start recording and Stop recording to capture live data in your browser. Keep the tab open and the device nearby. The GPS status shows when a position fix is available. TrackOut labels the device's speed as Ground speed, 3D speed, or Speed mode unknown, and a live recording keeps the mode it started with. Expand Connection details for the model, firmware, and serial. Or open Track Mode, choose an exact nearby layout with timing data, and use the live speed, G, lap, best, and delta dashboard. Choose Readings only when you want a capture without lap timing.

For a Mini S or Micro, TrackOut checks stored recordings automatically and keeps a refresh control available. If memory is locked, enter the security code configured in the RaceBox app. Stop standalone recording before downloading stored data. Downloads leave the device's recordings intact. The original Mini supports live capture only.

Completing a stored-memory download automatically saves one .racebox backup. Choose Analyze capture to open that same capture without downloading it a second time. Keep the backup to return to the other recordings after opening one in analysis. If the device memory contains several recordings, select one to analyze. Choose Save capture file to keep a .racebox backup. A disconnected or stalled transfer keeps the data received so far, marked as interrupted. Interrupted captures cannot be analyzed; Save capture file exports a .racebox.partial recovery file that cannot be uploaded as a completed recording. Save it before clearing the capture and retrying. Closing the tab discards captures you have not saved.

RaceBox provides GPS, speed, acceleration, and rotation data, but it does not supply circuit gates or lap results. TrackOut compares a recording's GPS route with nearby layouts that have a surveyed start/finish marker. A clear match is timed automatically; if more than one layout fits, TrackOut asks you to choose the layout or keep the recording untimed. If no layout fits, the recording stays an untimed trace and does not establish a best lap. Calculated laps are labelled as TrackOut-calculated. Recordings without GPS fixes show sensor plots with an elapsed-time scrubber so you can inspect readings throughout the capture. Acceleration axes follow the device's mounting orientation.

VBOX export limits

VBOX .vbo uploads support files up to 50 MiB, 500,000 data rows, 256 columns, and 4 million header and data cells combined. Individual lines can be up to 64 KiB. The file can contain at most 504,096 lines total and 4,096 nonempty metadata lines, including section markers. If an export exceeds a limit, export a shorter recording or fewer channels and upload it again.

CSV column requirements

TrackOut reads the header row and matches columns by name, ignoring case and any unit written in parentheses or brackets. Speed (km/h) and SPEED[km/h] are both recognized, so exports from RaceChrono, Harry's LapTimer, and TrackAddict import without editing the file.

A file without a lap column still imports -- TrackOut derives laps from the GPS trace instead. When logging stopped mid-lap, that trailing partial lap is marked invalid so it does not distort your best lap or consistency numbers.

CSV uploads support files up to 50 MiB, 256 columns, 64 KiB per row, and 4 million cells in the header and data rows combined. The file can contain at most 1,000,000 lines after the header and 1,000,050 lines total, including blank and metadata lines. If an export exceeds these limits, split it into shorter recordings or export fewer channels and upload again.

AIM XRK/XRZ import accuracy

Older AIM record formats support up to 500,000 telemetry records containing 4,000,000 sample values, and up to 4,000,000 decoded channel samples across the recording. A recording that exceeds a limit is rejected rather than opening with missing later data. Split longer recordings into shorter exports before uploading them.

AIM wire-format imports support up to 4,000,000 unique channel samples across direct and deferred decoding, and 4,000,000 expansion-device samples per file. If a recording exceeds either limit, export a shorter session or fewer channels and try again.

For AIM files, TrackOut reads GPS position, lap timing, CAN channels, and logger metadata when those records are present. The GPS samples are decoded into accurate map coordinates, so the driving line and track-map overlay are placed correctly instead of appearing offset or distorted. A new import also reads sample types, units, and IMU axes the way RaceStudio does, and maps one GPS receiver instead of mixing an internal and an external one into one line.

If a download was damaged in transfer -- dropped chunks or a GPS frame that does not check out -- TrackOut skips those frames and keeps reading, so later laps still map instead of vanishing. Already-saved sessions keep the parse they were imported with -- dropping the same file again opens that session instead of replacing it. Delete the saved session first, then upload the original file, if an older import looked sparse, jumped off the circuit, swapped G, or showed the wrong units.

TrackOut also handles compressed .xrz files, lap-number differences between loggers, out-lap handling (including AIM sessions whose only timed lap is labeled as an out-lap), and common CAN channels such as gear when the logger records them.

If you want to import a screenshot from a timer or phone app instead of a raw file, go to Track Days and use Scan from device while adding or editing a session.

How to upload

1. Navigate to Analysis in the sidebar, or open My track days for a day-specific shortcut
2. Click Upload telemetry, drag and drop a file onto Track Days, or pick Upload telemetry from a day's row menu. On a desktop-width window you can also drop a file on the Drop telemetry panel at the bottom of the sidebar from any page
3. Select your telemetry file from your computer
4. The file is parsed instantly in your browser
5. Choose where it belongs: a likely Track Day, any other past day, an individual on-track session, Day only, or Leave unlinked
6. Once linked, you will see the lap list and interactive charts. Analysis lets you Link, Relink, or Unlink saved analysis later

Uploaded files can be up to 50MB. An account can hold up to 500 saved sessions -- see Saving sessions if you need to make room.

Dropping files on the sidebar

On a desktop-width window, the Drop telemetry panel at the bottom of the sidebar takes one or more files from any page, and Upload telemetry in Analysis does the same. Each file opens in the Drop telemetry dialog, one at a time:

• Reading -- the file is being decoded in your browser.
• Matched -- the file row says what TrackOut read (for example "AiM · 14 laps · 10 Hz GPS"). TrackOut found the one track day the file belongs to, from its date and the track its GPS resolves to, and the on-track session whose start time it fits when there is exactly one. The dialog shows the Car and Session and says what matched. Choose Open in Analysis to file it there, or Change to pick somewhere else.
• No match -- pick a car and a track day, or New track day for the track and date in the file, then choose Add as session.
• Can't read -- the file is not a format TrackOut reads. The dialog lists the exports that work; choose Try another file.
• Already imported -- the same file is already saved. The dialog says where it is and links to Open session.

Cancel sets the file aside without saving it. On a car's Driving tab, dropped files still appear as cards under the drop target.

RaceBox device-memory captures can hold several recordings, so their card opens the recording picker instead.

Automatic track detection

When you upload a file, TrackOut detects the track from the file name, any track day you attach the session to, and the decoded GPS location. If a matching track is found in the database, the official track centerline is loaded for accurate position mapping.

This means your driving line is displayed relative to the actual track layout, making it easier to identify where you are gaining or losing time in specific corners and sections.

For AIM .xrk files, TrackOut decodes the logger's recorded GPS solution directly, so the driving line and map position stay accurate even when the file's embedded track label is old or stale. Track detection uses the file name and any linked track day first, then falls back to the decoded GPS location when the name is missing or points at the wrong nearby circuit -- so a mislabeled session still attaches to the track it was actually recorded at.

Data channels

TrackOut automatically discovers and processes common channels from your telemetry data. AIM files can contain both standard channel names and logger-specific IDs, so TrackOut also exposes raw channels when they are useful for analysis.

Speed

• Channel names: VSPD, SPD, GPS Speed, GPS_Speed, GPS Spd, GPS_Spd, Speed
• Unit: mph
• Also recognized: speed_mps, which stays in metres per second and is not converted for display
• Plotted on the speed chart and used for speed-colored track map overlays

Racelogic VBOX files that record speed in km/h are normalized to mph so charts and lap summaries use the same units as AIM files.

G-Forces

• Channel names: LatA, lateral_g (lateral), InlA, longitudinal_g (longitudinal), plus supported AIM expansion-channel names when present
• Unit: G
• Used for the G-Force chart, friction circle plot, and braking zone detection

Engine

• Channel name: RPM
• Unit: revolutions per minute
• Displayed in the channel analysis charts

GPS Position

• Channel names: Latitude, Longitude
• Used for track map rendering, track detection, and position-based data alignment

For VBOX files, TrackOut can build a usable analysis from GPS samples even when the file does not include the same lap-channel structure as an AIM export. A VBOX file with a GPS trace but no lap markers is analyzed and saved as a single lap covering the whole recording.

Explicit channel mapping

If your AIM file uses custom channel names, use Add Channels in analysis to map the raw logger channel to the role TrackOut should use. High-value channels such as throttle, brake, steering angle, speed, RPM, gear, and brake pressure are suggested first so you can quickly confirm the right source instead of relying on a guessed alias.

Channel choices and labels are saved in your browser for the same file/source profile, so repeat uploads from the same logger are faster to review.