Telemetry setup guide
Tell us how you play, and we'll tell you exactly what to set in the game and in Track N Race.
The settings for every setup on one page. With JavaScript on, the Setup page asks how you play and shows only your steps.
Your setup
Track N Race on a computer Android, Direct mode Desktop + Android, Paired mode
- F1 on your device
- UDP · 20777 inside this PC over your network
- Track N Race on your computer
- Paired encrypted, over Wi-Fi
- Track N Race for Android · Direct · Paired
Direct mode: the game sends its telemetry straight to your phone, and the phone decodes and records it itself. No computer involved.
Paired mode: the game talks only to your computer. The phone connects to the desktop app and shows what it shows, live or during playback of a recording, so you never have to change the game's settings to switch screens.
Want a computer in the loop as well? Pick to use Paired mode instead.
Open it on macOS
Track N Race isn't signed with an Apple Developer certificate, so the first time you open it macOS blocks it with "Track N Race" Not Opened (or "cannot be opened because Apple cannot check it for malicious software"). That's expected. To let it run:
- Open the
.dmgand drag Track N Race into Applications. - Open it once. When macOS blocks it, click Done (not Move to Trash).
- Go to System Settings → Privacy & Security, scroll down to Security, and click Open Anyway next to the Track N Race message.
- Open Track N Race again and click Open Anyway, then enter your password if asked. macOS remembers this, so you only do it once per version.
A damaged message means macOS has quarantined the download. After copying the app to Applications, clear the quarantine flag:
xattr -dr com.apple.quarantine "/Applications/Track N Race.app"
The Minimal Recorder is unsigned too: use the same steps, with its own app name in the command. This is separate from the keychain password prompt in step 04.
Find its IP address
The game needs the local network address of the device
running Track N Race. It looks like 192.168.1.150.
Press Win + R, type cmd or open PowerShell, then run:
ipconfig
Look for IPv4 Address under your active connection.
Open Settings → Network & internet → click Wi-Fi or Ethernet → scroll down to Properties to view the IPv4 address.
Open the Apple menu → System Settings → Network → select your connected network (Wi-Fi or Ethernet) → click Details... to view your IP Address.
Open Terminal and run the command for your active interface:
ipconfig getifaddr en0
Use en0 for Wi-Fi or en1 for Ethernet.
Open your terminal and run:
hostname -I
On second thought, why am I even telling you this. You are on Linux. You either know how to do this, or know how to Google how to do this.
Open Track N Race and tap the menu button in the top bar. The source
line shows the phone's address, like Direct UDP · 192.168.1.42.
Open Settings → Network & internet → Internet → tap the gear icon next to your connected Wi-Fi network to view the IP address. On Samsung phones, go to Settings → Connections → Wi-Fi instead. Menu names vary between manufacturers.
Set up the game
In the game, open Settings → Telemetry Settings and set:
Start Track N Race
- Open Track N Race. It starts listening on port
20777straight away. - If Windows asks whether to allow Track N Race on the network, allow it on Private networks.
- If macOS asks whether Track N Race may accept incoming network connections, choose Allow.
- Leave the session menu and get on track. The dashboard fills in within a second.
Set the app to Direct mode
On your phone
- Open Track N Race. On Android 17 and later, allow Nearby devices when asked: without it the app can't hear the game.
- Go to Settings → Telemetry → Source and choose Direct UDP. It's the default.
- Keep the dashboard open on screen while you drive. Android pauses the listener when the app is in the background.
Pair your phone
You only pair once. After that the phone finds the desktop by itself, even if its IP address changes.
On your computer
- Open Track N Race → Settings → Paired Devices.
- macOS only: turn on Allow keychain access and restart the app. macOS then asks for your login password, because the app isn't signed with an Apple certificate.
- Turn on Enable paired mode.
- Click Pair a device. A QR code and an 8-character matching code appear for two minutes.
On your phone
- Open Track N Race → Settings → Telemetry → Pair a desktop. On Android 17 and later, allow Nearby devices when asked.
- Tap Scan desktop QR and point it at the screen. Or pick your computer under Nearby desktops and type the matching code.
To finish
- The desktop asks Allow <your phone>? Click Allow.
- The phone switches its source to Paired desktop and shows whatever the desktop shows, live or in playback. The top bar says which driver it's following.
Recording happens on the desktop in Paired mode. The phone doesn't save a second copy.
Record your sessions
Recording is off until you turn it on. Each session is saved as a .tnrd file
you can play back and analyse later, lap by lap.
In Paired mode the desktop does the recording, so set it up there.
Electron app
- Open Settings → Data Storage.
- Turn on Record Session Data.
- Next to Output Directory, click Browse and choose a folder.
- Under Practice, Qualifying, Race and Time Trial Sessions, choose which drivers to save.
Native app
- Open Settings → Recording.
- Tick Start recording when a session starts.
- Next to Save to, click Change… and choose a folder.
- Under Drivers to Save, choose an option for each session type.
On your phone
- Open Settings → Recording and turn on Record sessions.
- Recordings go to the app's Documents folder, in
Track N Race. To save them somewhere else, tap Recording folder and pick one. - Recording only works in Direct mode. When paired, the desktop records instead.
Watch a recording back
- Electron: click the upload icon in the title bar (Load Session Data File) and pick a
.tnrdfile. - Native: click Open File in the toolbar. It asks first, because opening a file closes any live session.
- On the phone: start playback on the desktop and the phone follows it, pause, seek and speed included.
- On the phone: tap the menu button → Open recording to play a session saved on the phone.
Only want recordings, with no dashboard? The Minimal Recorder in the download menu records every session automatically once you choose a folder.
If nothing shows up
- Be on track. The game only sends telemetry once you're in a session, not from the main menu.
- Same network. The game and the device must share a router. Guest Wi-Fi and some mesh systems block devices from talking to each other.
- IP changed? Routers can hand out a new address after a restart. Check it again, or reserve one for the device in your router's settings.
- Windows Firewall. Allow inbound UDP on port
20777for Track N Race, and make sure your network is set to Private, not Public. - macOS Firewall. In System Settings → Network → Firewall → Options, make sure Track N Race is allowed incoming connections.
- Firewall. Open UDP
20777(for examplesudo ufw allow 20777/udp). - "Local network access is off". Grant Nearby devices to Track N Race in Android's app settings.
- Wi-Fi, not mobile data. Turn off any VPN on the phone; it can hide the Wi-Fi address from the game.
- Desktop not in Nearby desktops? Some networks block discovery. Use Scan desktop QR instead: the QR carries the address.
- Found but won't connect. Paired mode uses TCP port
20779on the computer. Allow Track N Race through its firewall. - "Pairing is not open on the desktop". The pairing window lasts two minutes. Click Pair a device again.
- "This is not the desktop this phone paired with". Track N Race was reinstalled on the computer. Use Forget paired desktop on the phone and pair again.
- Port in use. Only one app can listen on
20777. Close other telemetry tools, or change the port in both the game and Track N Race. - Wrong format. In Track N Race's Settings → Protocol, leave Protocol Version Override on Auto so it follows the game.
Pick the address to send to
Finding an IP address
- Windows: run
ipconfigand look for IPv4 Address under your active connection. - macOS: run
ipconfig getifaddr en0in Terminal (en1for Ethernet). - Linux: run
hostname -I. - Android: open Track N Race and tap the menu button. The source line shows it, like
Direct UDP · 192.168.1.42.
Set up the game
In the game, open Settings → Telemetry Settings and set:
Start Track N Race
- On a computer: open it. It listens on port
20777straight away. If the system asks, allow it on the network. - On Android, Direct mode: open Settings → Telemetry → Source and choose Direct UDP (the default). Allow Nearby devices if asked, and keep the app on screen.
- On Android, Paired mode: on the computer, open Settings → Paired Devices, turn on Enable paired mode and click Pair a device. On the phone, open Settings → Telemetry → Pair a desktop and scan the QR code.
On macOS, the first launch is blocked because the app isn't signed. Go to System Settings → Privacy & Security and click Open Anyway.
If nothing shows up
- Be on track. The game only sends telemetry once you're in a session.
- Same network. The game and Track N Race must share a router. Guest Wi-Fi can block this.
- Firewall. Allow inbound UDP on port
20777for Track N Race (and TCP20779for Paired mode). - Port in use. Close other telemetry tools listening on
20777.