GTelemetry / Help

Setup

GTelemetry records the telemetry from your sim racing and real-world track sessions, then helps you understand where you're losing time and what to change. You record on a phone or computer next to your PS5, and review on any computer in your browser at app.trackandsim.com.

The GTelemetry dashboard showing the Summary page of a GT7 session at Brands Hatch
The dashboard: sessions on the left, page tabs across the top, and the Summary page of a GT7 session.

What you can record

SourceHow you record itWhat you get
Gran Turismo 7 (PS5)The GTelemetry Recorder Android app, or the gtelemetry command-line recorder on a MacEvery page and all 13 analysis cards
Project CARS 2 (PS5) — experimentalThe gtelemetry command-line recorder on a computer wired to your routerEvery page; 12 analysis cards (the game doesn't report traction control)
RaceBox GPS lap timerExport a session from the RaceBox app as CSV and upload itSummary, Video and 5 analysis cards: four based on your line, speed and grip, plus an estimate of where you accelerate and slow

GT7 needs no setup in the game: as long as your phone or computer is on the same home network as the PS5, the recorder finds it and asks it for telemetry automatically. Full instructions are on the Recording tab.

1. Create your account

Sign-up is by invitation. Go to app.trackandsim.com, choose Sign up, and enter:

Confirm your email. We email you a link to confirm your address. You can record and analyse laps straight away; friends, messages and sharing unlock once it's confirmed. Can't find it? Check your junk folder, or use Resend email on the bar at the top of the dashboard. The link works for 3 days.

Everything you record or upload is private to your account until you choose to share it with a friend.

Forgotten your password? On the sign-in screen, choose Forgot your password? and enter your email. The link we send works once, for an hour, and setting a new password signs you out everywhere else. It comes from noreply@trackandsim.com; if it doesn't arrive within a few minutes, check your junk or spam folder.

2. Find your way around

The header stays the same on every page:

ControlWhat it does
Page tabsHOME, DASH, SUMMARY, ANALYSIS and VIDEO. Only the pages that suit the active session are shown: a loaded session (GT7, Project CARS 2 or RaceBox) offers Summary, Analysis and Video, and switching between sessions keeps you on the same page; a live recording shows the Dash.
PS5 StatusCONNECTED agent while the gtelemetry recorder is streaming live to your account, otherwise IDLE, including while you review a recorded session.
✉ Friends & messagesOpens the social panel: messages, friends and friend requests. A badge counts new requests and unread messages. See Racing your friends.
Your name (account menu)Downloads… (the recorder app and command-line recorder), Devices… (pair and manage recorders) and Log out.
SettingsTheme, style and layout (below).
HelpThis page.

Loading, recording and switching sessions happen in the Sessions panel on the left. See Sessions & Library.

3. Make it yours: Settings

Click Settings in the header. Changes apply immediately and are saved to your account, so they follow you to any computer you sign in on.

SettingChoices
ThemeEight palettes. Dark: Midnight (default), Graphite, Racing Green, Scarlet. Light: Paper, Ice, Sand, Mist. Charts, maps and traces recolour to match.
StyleClassic, or Metro: flat tiles, square corners and bold type. A live preview shows both.
LayoutFor the Video page: Lanes Below (the two lap panels side by side, lap lanes underneath) or Lanes Right (panels stacked, lanes beside them; drag the divider to resize).

4. Pair a recorder

The Android app and the command-line recorder each pair with your account once. After that they upload straight into your Library. You never type your password on the phone.

  1. On the dashboard, open your account menu (your name, top right) and choose Devices… → Pair a device. A QR code and an 8-character code appear.
  2. Phone: in GTelemetry Recorder tap Scan QR code. Computer: run gtelemetry login and type the code.
  3. The device appears in the Devices list straight away. Codes last 5 minutes and work once; press New code if one expires.
The Devices dialog showing a pairing QR code and its 8-character code
Devices… → Pair a device.

In Devices… you can Rename a device or Remove it. Removing one stops it uploading immediately, which is what to do if you lose a phone. Paired devices stay paired when you Log out of the browser; logging out only signs out your browsers. Resetting your password unpairs every device, so pair them again afterwards.

Next
Head to Recording to set up the Android app, the command-line recorder or RaceBox.

Recording

Pick the recorder that suits you. Both GT7 recorders talk to the PS5 over your home network, so the phone or computer must be on the same network as the PS5. Nothing needs setting up in GT7.

Which recorder?

GTelemetry Recorder (Android)gtelemetry (Mac)
GamesGT7GT7 and Project CARS 2
How it worksPress Record, drive, press Stop. It uploads by itself.Record to a file and upload, or stream live to the dashboard while you drive
Live view while drivingNo: review after you stopYes: the Dash shows your telemetry as you drive
Get itAccount menu → Downloads…Account menu → Downloads… (Apple-silicon Macs)

GTelemetry Recorder for Android

Records GT7 from your phone and uploads each session to your Library when you stop. Needs Android 7 or later.

Install

  1. On your phone, sign in at app.trackandsim.com, open the account menu → Downloads… and download GTelemetry Recorder for Android. (Or download it on a computer and copy the .apk file to the phone.)
  2. Open the downloaded file. Android asks to allow installs from that app (Chrome, Files or Drive): turn on Allow from this source, go back, and tap Install.
  3. If Play Protect warns about an unknown app, choose More details → Install anyway. It warns because the app isn't from the Play Store.

Updates: download the new version and install it straight over the top, without uninstalling first. Your pairing and recordings are kept.

Pair

Open the app, tap Scan QR code and scan the code from Devices… → Pair a device on the dashboard (see Pair a recorder). Check the app names app.trackandsim.com, give the phone a name, and tap Pair. No camera? Tap Type the code instead.

Record

  1. Start GT7 on the PS5 and open the app. It starts Looking for your PS5… straight away. Leave PS5 address blank and it finds the PS5 itself, and remembers it for next time. If it can't, type the PS5's IP address (PS5: Settings → Network → Connection Status → View Connection Status).
  2. When it shows PS5 connected (in green) and the rings pulse, data is arriving and Record is ready. It also shows what the game is doing: On track, In menus, Paused or Loading.
  3. Press Record when you head out. If the rings turn orange mid-session, nothing has arrived for a few seconds: check the PS5 is in GT7 and the phone is still on Wi-Fi.
  4. While recording it shows your lap progress, for example Lap 4 · 3 complete · last 1:42.450.
  5. Press Stop when you're done. The session uploads and appears in your Library, and the app stays connected, ready for your next session.
At least one full lap
A recording is only kept if it contains at least one complete lap: you need to cross the start/finish line twice while recording. Anything shorter has nothing to analyse, so the app discards it instead of uploading it, and tells you so.
Restarting starts a new recording
If you restart a race or choose a new event from a GT7 menu while recording, the app finishes that recording and starts a new one by itself, so each session is kept separately. Pausing and carrying on doesn't do this. Each recording still needs a complete lap. Turn it off under Settings → New recording on restart.

The Recordings tab lists anything still waiting to upload. A failed upload stays listed; use ⋮ → Retry upload. Uploaded recordings are removed from the phone unless you turn on Keep copies on this phone in Settings.

Recording with the screen off

The first time you press Record, the app asks to run without battery restrictions. Allow it: without it, many phones (Samsung especially) pause the app a minute or two after the screen turns off, and the recording stops receiving. While recording, a Recording GT7 session notification shows; allow notifications so you can see it.

The gtelemetry command-line recorder

A small program you run in Terminal on a computer on the same network as your PS5. It can record to a file, upload files, or stream live to the dashboard while you drive. It's available for Macs with Apple silicon (M1 or later).

Install

  1. Open the account menu → Downloads… and download the gtelemetry command-line recorder zip. Unzip it.
  2. Pair it: run ./gtelemetry login and enter the code from Devices… → Pair a device.

The first time you record, macOS may ask whether gtelemetry can accept incoming network connections. Choose Allow: that's how the PS5's telemetry reaches it.

Commands

CommandWhat it does
gtelemetry streamStreams live to your dashboard. Then press Record Session on the dashboard to record (see below).
gtelemetry startRecords to a .gt7raw file in Documents/GTelemetry/Sessions. Works offline. Press Ctrl+C to stop. Restarting from a GT7 menu starts a new file, and files without a complete lap are deleted (--no-split and --keep-partial turn these off).
gtelemetry upload --allUploads every recording in that folder to your Library (or name files individually). Files already uploaded, and GT7 files without a complete lap, are skipped.
gtelemetry loginPairs this computer with your account using a code from Devices….
gtelemetry logoutUnpairs the computer and forgets its sign-in.

Add --source pcars2 to start or stream for Project CARS 2. gtelemetry --help lists every option. While running, a status line shows whether telemetry is arriving.

Recording live in the dashboard

With gtelemetry stream running, the dashboard can record what it's streaming, and you can watch the Dash live while you drive.

  1. Run gtelemetry stream next to your PS5. The PS5 Status pill reads CONNECTED agent once telemetry is flowing.
  2. Click Record Session in the Sessions panel. A REC session appears and the Dash page shows your live telemetry.
  3. Drive. Each completed lap is captured. If you restart or change event from a GT7 menu, the recording so far is saved to your Library (or discarded if it has no complete lap) and a new one starts by itself.
  4. Click Stop Recording. The session becomes UNSAVED and opens on Summary.
  5. Click Save on its card to keep it in your Library, or Unload to discard it.
Closed the tab mid-recording?
The recording keeps running. Next time you open the dashboard it offers to Resume it, Stop & keep it, or Discard it.

Project CARS 2 (experimental)

Project CARS 2 broadcasts its telemetry to your whole network rather than to one device, so it needs switching on in the game and a wired computer to receive it.

  1. In Project CARS 2, go to Options → System. Set UDP Protocol Version to Project CARS 2 and UDP Frequency to 1.
  2. Run gtelemetry stream --source pcars2 (live) or gtelemetry start --source pcars2 (to a file) on a computer connected to your router by Ethernet cable.
  3. Watch the status line: it shows the share of the game's packets arriving.
Why experimental
Wi-Fi routers hold back broadcast traffic: over Wi-Fi only about 12% of packets arrive, which is too little for good analysis whatever the frequency setting. A wired receiver should do much better, but that hasn't been measured yet. Project CARS 2 also doesn't report traction control, ASM or a suggested gear, so the TCS card and those statistics are hidden for its sessions. The game's own track name is used, so there's no track matching.

RaceBox

A RaceBox is a GPS lap timer for real track days. GTelemetry reads its Track Session CSV export.

  1. In the RaceBox app, open the session and export it as CSV.
  2. On the dashboard, click Upload Session (or drag the file onto the page) and choose the .csv.
  3. It opens on Summary. Lap and sector times come straight from the RaceBox.

A RaceBox records position and speed but nothing from the car (no pedals, gears or RPM), so it gets the analysis cards based on your line, speed and grip, the Accel / Decel (estimated) card in place of Coasting, and the rendered driver's view without engine gauges. In place of a pedal trace, its lap traces show an A/D estimate of where you were accelerating and slowing, worked out from your speed. It is not pedal data.

Uploading files

Click Upload Session in the Sessions panel, or drag a file onto the page:

The session loads in a few seconds and is added to your Library. Uploading the same file again just reopens the stored copy.

Pages

What each part of the dashboard shows and how to use it.

Sessions & Library

GTelemetry works in sessions: each recording, upload or comparison is one session. The Sessions panel on the left lists the ones you have open, and you can keep several open and switch between them. Your Library holds everything you've kept.

The Sessions panel

ControlWhat it does
Upload SessionOpen a .gt7raw or RaceBox .csv (see Uploading files).
Record Session / Stop RecordingRecord what gtelemetry stream is sending (see Recording live).
LibraryOpen your stored sessions (below).

Each session card shows a track-shape thumbnail, the track, car and in-game time of day, and badges:

Card actions: Select (or double-click) makes it the active session; Save keeps an unsaved one in your Library; Share sends it to a friend; Unload closes it (your Library copy stays). Drag cards to reorder them. The sessions you have open are remembered, so they reopen when you come back on any computer.

Library

The Library panel listing stored sessions grouped by track
The Library, grouped by track.

Everything you've stored is here, including sessions recorded on your phone or with the command-line recorder: they arrive in the Library without being opened. When new ones arrive, the Library button shows how many (for example 2 new), even while the dashboard is open, and they're tagged NEW the next time you open it.

Download gives you the exact original file (.gt7raw or .csv).

Dash

The live instrument panel, shown while you record with gtelemetry stream. Handy on a second screen beside your rig.

PanelShows
Speedmph (large) and km/h.
RPMAn arc gauge that fills towards the car's shift-light point; when it's nearly full, shift up.
PedalsThrottle, brake and clutch, 0–100%: what you're asking for, not what traction control lets through.
GearThe current gear (N for neutral).
Race InfoLap (current/total in a race), Best, Last, Position (in a race), Water °C and Oil °C.
Lap MapThe track drawn from your car's position as you drive, with the car, the car name, and numbered corners (Corners On/Off toggles the labels). After a lap the track is identified and named in the header.

Below the Dash and on the Video page are the lap traces (see Lap traces below).

Summary

Every session opens here. Summary answers what was this session and where is the time?: the session's details, a sector-by-sector breakdown, your theoretical best, and a statistical comparison of two laps.

The Summary page: session details, sector map, sector summary table and theoretical best lane
Summary: Session, Sector Map, and the Sector Summary with the theoretical-best lane.

Fastest and Pinned

Summary, Analysis and Video all compare two laps: your Fastest lap, the benchmark, and your Pinned lap, the one you're working on. GTelemetry pins your second-fastest lap automatically when a session loads or a recording stops. Pin a different lap by clicking its row in the Sector Summary or its Pin button in the lap traces; once you choose, your choice sticks. Click Pinned on that lap again to go back to the automatic second-fastest lap.

Session

The session's details, grouped as Track (name, RaceBox configuration, approximate length), Car, Environment (in-game time of day) and Capture (date recorded, source, laps, total time). Only details the session really has are shown. A comparison session also shows where its Fastest and Pinned laps came from.

Sector Map

The track drawn from your fastest lap's line, split into sectors. Each sector is coloured by the lap that was fastest through it and labelled with that lap and time (e.g. S2 · Lap 4 · 29.167). Numbered corners show where they are; Corners On/Off toggles their labels. Until you have two complete laps, it shows the plain line.

Sector Summary

One row per lap, with each lap's sector times, lap time and gap to your best; for GT7 also fuel used, average tyre temperature and traction-control interventions. The fastest time in each sector is green, and each lap's icon is coloured from fastest (green) to slowest (red). Click a row to pin that lap; tick its checkbox to add it to a comparison.

Lap Telemetry Statistics

Pick a Signal and compare Fastest against Pinned in three ways: a table of statistics with the difference worked out, a distribution (how much of each lap was spent at each level), and a box-and-whisker plot. Signals: Speed, Throttle, Brake, RPM, Gear, Lateral / Longitudinal / Combined G, Line offset, and the TCS and ASM assists. RaceBox offers Speed, the G signals and Line offset.

Analysis

Your coaching workspace. Each card measures one part of your driving, a map shows where it happens, and a coaching panel explains it in plain language, all comparing your Fastest and Pinned laps.

The Analysis page: diagnostic cards on the left, comparative lap map and coaching panel on the right
Analysis: cards on the left; map and coaching on the right follow the selected card.

The coaching is worked out from your telemetry on your computer; it says plainly when two laps are similar. With nothing pinned, cards show your fastest lap on its own. You need at least one complete lap.

The coaching panel in Narrative mode: a corner-by-corner walkthrough of the lap
Narrative: the whole lap as one debrief.

Show me: see the ideal technique

Every card has a ▶ Show me button under its advice. It opens an animation of the technique the card is about, played on the corner that card flagged on your lap: the longest coast for Coasting, the sharpest brake release for Brake Release, and so on. Only one animation plays at a time.

The Coasting card with Show me open: Druids hairpin drawn from the lap with the ideal line and car on the left, and the pedals, steering wheel, G-dot and a pedal trace on the right, with the mistake switched on
Show me on the Coasting card: the ideal brake-to-throttle blend at Druids, with the mistake car's coasting gap shaded blue in the trace.
An example, not a replay of your lap
The corner's shape and your speeds come from your lap, but the inputs are a textbook pattern and the mistake is a typical one. The time marked ≈ is roughly what that mistake would cost on this corner, not what you lost. Your real numbers are on the card and in the coaching. Corners you take flat out play as a lift rather than a stop.

Exit priority: what comes after the corner

The best line through a corner depends on what follows it.

The Driving Line and Min Corner Speed coaching says so when it applies, and their Show me animations switch to the matching line. For every corner type, elevation and camber, read the Corners, elevation and exit priority guide.

The Show me overlay for Driving Line on a corner followed by a 570 metre straight, captioned: exit speed matters most
Before a long straight, Show me plays an exit-first line.

Which cards you see depends on what the source records: GT7 all 13; Project CARS 2 12 (no TCS); RaceBox 5: Accel / Decel (estimated) in place of Coasting, then Min Corner Speed, Traction, Steering Smoothness and Driving Line. Each card below is tagged with the sources it works for.

Coaching guides: learn each discipline

The cards tell you what happened on your lap; the coaching guides teach you how to fix it. There is a guide for each card (the RaceBox Accel / Decel card shares Coasting's), plus six Foundations chapters that underpin them all. Each one is written for real track days and for sim racing, and layered Fundamentals, Intermediate and Advanced so you can stop at your level.

Advice, not tuition
The guides are general coaching advice. On a real track, take tuition from a qualified instructor, follow the organiser's briefing (it always overrides the guides), and remember that setup changes and track driving are at your own risk.

The cards

Coasting (Dead Pedal)

GT7PC2RaceBox

What it measures

The share of the lap with neither pedal applied (throttle and brake both under 5%). Every moment here the car is neither slowing usefully nor accelerating. The brief lift during an upshift doesn't count.

The chart

A bar split into throttle, coast and brake time. The coaching names your longest coast and where it happens: the best place to start.

CoastingMeaningWhat to do
under 2%Very littleFine, but check TCS and Throttle Application: getting on the power too early can explain it.
2–8%Good pedal disciplineGains now come from where you switch pedals, not removing coasting.
8–15%ModerateWork through the longest coasts first.
over 15%A lotYour biggest quick win: brake deeper into the corner or get back on the throttle sooner.

Show me

The brake blends straight into the throttle around the apex, with a brief overlap and no gap. The mistake releases the brake early and coasts; the dead time is shaded blue.

Accel / Decel (estimated)

GT7PC2RaceBox

What it measures

A RaceBox can't see your pedals, so this card takes Coasting's place for RaceBox sessions. It uses the A/D estimate, worked out from how quickly your GPS speed changes, not measured pedal data. For each corner it finds where you appear to start slowing and where you're back on the power. Every metre between the two is a metre not spent accelerating.

The chart

A bar split into accelerating, coasting and slowing time (A, C, D). With a pinned lap, the number is the average change in each corner's slow-to-power gap compared with your fastest lap (+ is a longer gap). On the lanes, each corner is drawn |——| from where slowing starts to where the power comes back. The line is red where that gap is at least 10 m longer than on your fastest lap, green where it's at least 10 m shorter, and grey in between (within the estimate's error). A thicker line is a bigger difference, labelled in metres. Your fastest lap's row is always thin grey: it's the reference. On the map, a red dot marks where slowing starts and a green dot where the power comes back, ringed where the gap differs from your fastest lap by 10 m or more.

Gap vs fastestMeaningWhat to do
within ±10 mWithin the estimate's errorNothing to chase here. Look at the other cards.
10–25 m longerSlowing earlier or back on the power later at some cornersStart with the corner the coaching lists first: brake a touch later or pick up the power sooner.
over 25 m longerA lot of time not acceleratingYour biggest gain on a RaceBox lap. Compare your brake marker and exit with the fastest lap there.

Only differences of 10 m or more are called out, because the estimated points are accurate to a few metres.

Show me

The same ideal brake-to-throttle blend as Coasting, played as the ideal (it isn't your lap): the brake blends straight into the throttle around the apex, with no gap.

TCS Interventions

GT7PC2RaceBox

What it measures

How many times traction control stepped in. The coaching also flags rear wheelspin that happened without TCS reacting, when there's a lot of it.

The chart

The track outline with an orange dot where each intervention started, so you can see which exits overload the rear.

InterventionsMeaningWhat to do
0CleanExcellent throttle control.
1–3ManageableAt those corners, feed the throttle in 10–15 m later or more gradually.
over 3FrequentYou're overloading the rear on exit. Wait until the car is pointing straight before full throttle.

Show me

The throttle is fed in as the steering unwinds, and the TCS light stays off. The mistake stabs the throttle with lock still on, so TCS fires; where it fires is shown orange.

Throttle Application

GT7PC2RaceBox

What it measures

At each corner, how far past the apex (the slowest point) you travel before the throttle reaches 20%, and how that compares with your fastest lap at the same corner.

The chart

A bar per corner: red where you were later than the fastest lap, blue where you were earlier, with the fastest lap's average as a dashed line.

Average vs fastestMeaningWhat to do
over 5 m laterLate on the powerCommit as soon as the car is pointing straight: exit speed carries all the way down the straight.
within 5 mOn paceLook elsewhere for time.
over 5 m earlierEarlier than your bestCheck it isn't causing understeer or TCS; if the car runs wide, early throttle costs time.

Show me

The throttle comes in at the apex and builds as the wheel unwinds. The mistake waits well past the apex.

Throttle Ramp Rate

GT7PC2RaceBox

What it measures

Once you're back on the throttle, how far you travel to reach 50% and then 90%.

The chart

A row per corner: a green tick at 50% and a blue tick at 90%. Ticks on the left mean a quick, committed squeeze. A quick 50% followed by a slow 90% is hesitation that costs exit speed.

Average to 90%MeaningWhat to do
over 40 mVery gradualAim for 50% within 10 m of picking up, then full over the next 30 m.
20–40 mProgressiveGood. Target 50% within 10 m and 90% within 35 m.
under 20 mVery quickCheck TCS: a fast squeeze can cause wheelspin.

Show me

One decisive squeeze to full throttle. The mistake ramps up slowly and timidly.

Throttle Commitment

GT7PC2RaceBox

What it measures

The "squeeze, breathe, squeeze": corners where you got on the throttle, then lifted again (by 8% or more, after reaching at least 30%) before going flat out. The card counts how many corners show it.

The chart

Your throttle trace for the lap, with each corner exit where you lifted shaded red.

What matters is when you reach full throttle, not when you first touch it. A tentative pickup you have to back out of is slower than a slightly later, clean one. Pause briefly to let the car rotate, then commit in one squeeze.

PatternMeaningWhat to do
No liftsClean commitmentKeep picking up only once the car will take it.
One or two cornersOccasional early pickupAt those corners, pause after the brake, then commit in one go.
Many cornersA habitYou're on the power before the car has turned. Delay slightly and commit cleanly.

Show me

Waits for the car to finish turning, then commits in one clean squeeze. The mistake picks up early, lifts, then squeezes again.

Braking Zones

GT7PC2RaceBox

What it measures

The average peak brake pressure across your braking zones (a zone runs from the brake passing 5% until it drops back below).

The chart

Your brake pressure around the lap with each zone shaded. Sharp spikes are jabs; broad humps are progressive braking. The coaching compares the number and strength of zones with your fastest lap.

Average peakMeaningWhat to do
under 60%Under-brakingBrake harder and sooner in the zone: reach peak within the first 5–10 m.
60–79%ModerateFind the zones with low peaks and work on those.
80% or moreConfidentPressure is there. Look at Brake Release next.

Show me

Brakes at the board and reaches peak pressure almost at once. The mistake brakes early and gently.

Brake Release Profile

GT7PC2RaceBox

What it measures

How quickly you come off the brake after peak pressure, in percentage points per metre. This is trail braking: easing off gradually as you turn in keeps weight on the front tyres.

The chart

A bar per braking zone: red released too sharply, green progressive, yellow very gradual.

Release rateMeaningWhat to do
over 3 %/mToo sharpThe front unloads just as you turn in. Ease off over the last 30–50 m towards the apex.
1–3 %/mProgressiveGood. Refine the last 20% of pressure at turn-in.
under 1 %/mVery gradualMake sure you're fully off the brake by the apex, or it scrubs exit speed.

Show me

Trails the brake off as the steering goes in, reaching zero at the apex, so the G-dot rolls round the edge of the circle. The mistake drops the brake all at once at the turn-in.

Brake Pressure Shape

GT7PC2RaceBox

What it measures

How much of each braking zone's work happens in its first third. Fast drivers hit the brake hard early, then bleed it off. The road-car habit is the opposite: softest first, hardest at the end.

The chart

Your brake trace with each zone shaded green (front-loaded), yellow, or red (back-loaded), and a line marking the first third.

In the first thirdMeaningWhat to do
55% or moreDecisiveKeep hitting peak early. Try braking a touch later.
40–55%Middle-loadedHit peak harder and earlier: it shortens the stop.
under 40%Back-loadedCommit to firm pressure in the first few metres. You can often brake later once you do.

Show me

A front-loaded stop that tapers off. The mistake builds up street-style, hardest at the end.

Min Corner Speed

GT7PC2RaceBox

What it measures

Your slowest speed in each corner, compared with your fastest lap at the same corner. The coaching also notes where in the corner the slowest point falls: reaching it earlier lets you unwind the wheel and get on the power sooner.

The chart

A bar per corner: green faster than your fastest lap, red slower, grey when there's nothing to compare.

Average vs fastestMeaningWhat to do
over 1 mph slowerLosing speed mid-cornerTrail braking and a later, more patient apex carry more speed through.
within 1 mphMatchingWork on consistency across all corners.
over 1 mph fasterStrong commitmentMake sure the exit follows: corner speed only helps if you keep it.
Speed isn't everything
A higher corner speed that pushes you wide on exit can lose time. Check Throttle Application at the same corner: faster through the apex and on the power earlier is the combination that pays.

Show me

Brakes only as much as the corner needs and carries speed through the middle; the line is coloured by speed. The mistake over-slows the entry. Before a long straight it plays an exit-first version (see Exit priority).

Traction Circle Utilization

GT7PC2RaceBox

What it measures

How consistently you use the grip available: your average combined cornering-and-braking/accelerating force as a share of the peak you reach. 100% would mean always at your own limit. The coaching also reports how much of your loaded time is combined loading (turning while braking or accelerating), compared with your fastest lap.

The chart

A scatter of sideways G (left–right) against braking/accelerating G (up–down) for the whole lap; the last few seconds are highlighted.

  • Sparse at the top: braking could be harder. Sparse at the bottom: hesitant on the throttle. Sparse at the sides: carrying too little corner speed.
  • A plus-sign shape with empty diagonals means you brake, then turn, then accelerate as separate steps. Fill the diagonals by trailing the brake into the corner and feeding in throttle while still turning.
UtilizationMeaning
under 35%Lots of grip unused
35–49%Reaching the limit, but not holding it
50% or moreConsistently working the grip

Show me

Braking blends into turning and turning into throttle, so the G-dot follows the edge of the circle; the trace shows how much grip is in use. The mistake does one thing at a time, and the dot cuts across the middle.

Gear & RPM

GT7PC2RaceBox

What it measures

Rev-limiter hits, missed downshifts (corners you reached still in a higher gear than the downshift GT7 suggested on the approach) and your average RPM.

The chart

RPM around the lap, with the car's shift-light range shaded green where GT7 provides it and red ticks where you hit the limiter. On the Video page this card colours the lap by gear, from light purple (1st) to dark purple (8th), with a badge at each missed downshift.

ResultWhat to do
Limiter hitsShift up earlier, at 95–98% of peak RPM: the limiter cuts power just when you want it.
Missed downshiftsTake the suggested downshift before turning in, to keep the engine in its strongest range.
CleanGear choice is solid.

Project CARS 2 doesn't report the rev limiter or a suggested gear, so for its sessions this card shows RPM only.

Show me

Downshifts through the braking zone (purple marks on the corner) so the engine pulls from the apex; a rev strip shows the RPM. The mistake arrives a gear too high. It plays on a corner that needs a downshift, and the gear numbers come from a generic gearbox.

Steering Smoothness

GT7PC2RaceBox

What it measures

How economical your steering is through each corner: the total turning your car's path does, compared with the minimum (one clean arc). 1.0× is a single smooth arc; higher means corrections or sawing at the wheel. It's worked out from your line, so it works for RaceBox too.

The chart

A bar per corner, green (economical) through yellow to red (lots of extra input).

RatioMeaningWhat to do
up to 1.15×One clean arcKeep the wheel quiet; look to carry more speed.
1.15–1.4×Some extra inputOne progressive turn-in, one arc through the corner.
over 1.4×Sawing / correctingSlow your hands at turn-in and stop chasing the line mid-corner.

Show me

One smooth turn-in, a steady wheel through the middle and a smooth unwind; the trace shows the steering. The mistake saws at the wheel.

Driving Line

GT7PC2RaceBox

What it measures

How far your line is from your fastest lap's line, all the way round, in metres: the average and the largest gap.

The chart

A trace around zero (the fastest line). It dips (red) where you're to the right of the fastest line and rises (blue) where you're to the left. On the map your path is tinted the same way, over a faint fastest line.

  • Close to zero (under about 0.4 m on average): your line isn't costing time; look at braking and throttle.
  • A bulge at a corner: a different turn-in, apex or exit. It often explains that corner's slow minimum speed or late throttle.
  • The coaching also flags long stretches off-line on straights and transitions, not just corners.
  • Needs a pinned lap that isn't your fastest.

Show me

Outside on entry, a late turn-in, the apex, then out to the exit kerb. The mistake turns in and apexes early and runs out of road. Before a long straight it plays an exit-first line; before a corner close behind, it finishes on the side the next corner turns in from (see Exit priority).

Lap traces

Across the bottom of the Dash and Video pages, one block per completed lap, plotted against distance round the lap. Each lap shows the lanes its data supports: GT7 and Project CARS 2 laps show T/B, MPH, RPM, GR and G; RaceBox laps show A/D, MPH and G.

LaneShows
T/BThrottle (green) and brake (red), 0–100%
A/DRaceBox: estimated accelerating (green) and slowing (red), in place of T/B. Not pedal data
MPHSpeed, 0–200 mph
RPMEngine speed, 0–9,000
GRGear
GLateral (yellow) and longitudinal (purple) G

A collapsed block shows only its top lane; hover to read every lane's value at the cursor. Blocks are ordered fastest first, with your Pinned lap second, and a session keeps up to 50 laps. Each lap header shows the lap time and its gap to your best. Expand/Collapse shows or hides the lap, Pin makes it your Pinned lap, Del removes it from the open session, and the checkbox selects it for a comparison. Move the mouse over the traces, or drag a finger across them on a phone or tablet, and a cursor lines up every lap at the same point on track. Drag up or down to scroll the laps.

Video

For every session, GT7, Project CARS 2 or RaceBox: see the difference between your Fastest (left) and Pinned (right) laps side by side, scrubbed together by distance as you move along the lap traces. The driver's view is a good place to practise where you look: see the Vision and the vanishing point guide.

The Video page with two rendered driver's-view panels above the analysis lane and lap traces
Video: rendered driver's view of both laps, the analysis lane, and the lap traces.

The controls

ControlWhat it does
VIEW: Video / MapsVideo shows the two driver's views; Maps swaps them for two top-down lap maps, coloured for the selected analysis (coasting stretches, braking zones, a grip heat map…), with numbered corners.
ANALYSISWhich card's findings to show. It's the same selection as on the Analysis page, so whatever you pick there appears here.
▶ Show meOpens an animation of the ideal technique for the selected analysis over the left panel, played on the corner nearest the cursor as you move along the lap. Mistake adds a car making the common error. Drag its bottom-left corner to resize it; your size is remembered. See Show me.
SOURCE: Rendered / VideoRendered draws a driver's-eye view of each lap from the telemetry, with a HUD (speed, gear, pedals, G-meter), corner names and trackside scenery. No video needed. Video plays your own gameplay recording (below).
The Video page with the Show me overlay for Brake Release open over the left driver's-view panel at Clearways
Show me on the Video page: the Brake Release technique at the corner under the cursor, over the rendered view.

Analysis lane and lap delta

Above the lap traces, the analysis lane marks where the selected card's findings happen around the lap, in the card's own colours: coasting stretches, TCS interventions, braking zones, the throttle ramp, apex speeds as ticks, a grip heat-strip for Traction, the lap coloured by gear for Gear & RPM, and so on. Hover any marking and both panels jump to that spot. That's the quickest way to see what you were doing where the analysis says you lost time. The Lap Delta lane shows the time gap building up between the two laps.

Below the lanes are the lap traces.

Track surfaces

The rendered view draws each track as it's driven: tarmac circuits get kerbs, barriers and braking boards. GT7's dirt rally stages (Colorado Springs Lake, Fisherman's Ranch, Sardegna Windmills) get a narrow dirt road with marker poles and bales; Lake Louise is drawn as snow with ploughed banks; Barcelona-Catalunya Rallycross is drawn as dirt. A track that hasn't been identified is drawn as tarmac.

Using your own gameplay video

  1. Record the session on the PS5 while you record telemetry: Create → Start recording, or Save recent gameplay afterwards.
  2. Copy it to your computer: a USB drive (PS5 Media Gallery → Copy to USB) or the PlayStation App.
  3. Open the matching session in GTelemetry and go to Video.
  4. Set SOURCE to Video, click Choose File… and pick the MP4 (MOV, WebM and M4V work too). It loads into both panels.
  5. Sync it once: move the mouse off the traces, scrub the left video to the exact frame the car crosses the start/finish line at the start of Lap 1 (the session's first lap), and click ⊙ Set Sync Point. Both panels now follow the traces.
Your video stays on your computer
The file plays from your browser and is never uploaded. Each open session keeps its own video, so switching sessions and back brings it with you. After a reload, choose it again; the sync is remembered for that file name. If the video drifts out of step over a lap, the recording and capture ran at slightly different speeds; there's no automatic correction.

RaceBox sessions

A RaceBox session uses the same Summary, Analysis and Video pages as a game session, so switching between your real and sim laps keeps you on the same page. What's different comes from what a RaceBox records: position and speed, but nothing from the car.

The Video page with a RaceBox session: two rendered driver's-view panels above the lap delta, analysis lanes, and an expanded lap showing the estimated accel/decel (A/D) lane above its speed and G lanes
A RaceBox session on the Video page: rendered views, lap delta, analysis lanes and per-lap lanes, with the A/D estimate on top.

Lap and sector times come from the RaceBox, and lap names match its file; only complete laps are shown. G-forces are worked out from your speed and line, which is more reliable than the device's own sensors here. Altitude is evened out across laps so the lines overlay properly.

A/D: estimated accelerating and slowing (not pedal data)

The Video page in Maps view for a RaceBox session, with the Accel / Decel (estimated) card selected: the fastest and comparison laps at Mugello, each coloured green where the car is estimated to be accelerating, red where slowing and blue where coasting, with red and green dots where each corner's slowing starts and the power comes back, and a key reading: estimate, not pedal data
Maps view with the Accel / Decel (estimated) card selected: green accelerating, red slowing, blue coasting, and dots where each corner's slowing starts and the power comes back (all estimated).

A RaceBox can't see your pedals. The A/D lane is an estimate, drawn like the GT7 throttle/brake lane: green where the car is gaining speed, red where it is losing speed, and neither where it is coasting. It comes from how quickly your speed changes (longitudinal G). The "est." in its readout is there to remind you it is not a measured pedal.

How close is it? We checked it against real pedal data from Gran Turismo 7 laps, working from speed and position only, as a RaceBox would. In testing over a wide variety of cars and tracks we see about 87% agreement with the real pedals (accelerating, braking or coasting), with 94% of braking zones found. Where a braking zone is found, it typically starts within a few metres of the real brake point. It is least reliable off-road or on loose surfaces, where the car can lose speed with the throttle on.

What it can't show:

Use it to compare laps (where you started slowing, how early you were back on the power), not as an exact pedal trace. The Accel / Decel (estimated) analysis card does that comparison for you, corner by corner, and colours the maps when it's selected.

Workflows

How to get the most out of GTelemetry: turning a session into lap time, building comparisons, and racing your friends.

Your first session, start to finish

  1. Record 5–10 laps of one track and car with your recorder. More laps give the analysis more to compare.
  2. Open it from your Library. It lands on Summary with your second-fastest lap pinned against your fastest.
  3. Read the Sector Summary. The theoretical best tells you how much time your own best sectors add up to. Green cells show where each sector was won.
  4. Go to Analysis, switch the coaching to Narrative, and read the lap debrief. It ends with your biggest opportunities.
  5. Go to Video and hover the analysis lane to see those moments from the driver's seat.

Finding lap time: a coaching routine

The cards are listed in the order worth working through, grouped by pedal: throttle cards first, then brakes, then the results of both.

  1. Pin the right lap. Compare your fastest with a typical lap, not a lap with a spin. Click its row in the Sector Summary.
  2. See it before you try it. On any card, ▶ Show me plays the technique on the corner it flagged; turn on the mistake to compare. On the Video page the same animation follows your cursor round the lap.
  3. Learn the technique. The card's coaching guide explains how to do it, with drills to practise. Start at your level (Fundamentals, Intermediate or Advanced).
  4. Coasting: the largest, easiest gains are usually here. Start with the longest coast.
  5. TCS Interventions, then the throttle cards (Throttle Application, Throttle Ramp Rate, Throttle Commitment): late on the power, slow to full throttle, or lifting after picking up? Low coasting with high TCS means you're on the throttle early but the rear can't take it.
  6. The braking cards (Braking Zones, Brake Release, Brake Pressure Shape): reaching peak pressure, hitting it early, releasing progressively into the turn.
  7. Min Corner Speed: the result of your braking and turn-in. A slow corner points back to that corner's braking.
  8. Traction Utilization and Gear & RPM: unused grip, and easy wins from limiter hits and missed downshifts.
  9. Steering Smoothness and Driving Line: where your line differs, which often explains the other cards' findings at a corner.
Practise one thing at a time
Pick the one or two corners the coaching ranks highest, go back on track and work only on those, then record again and compare. Small, repeated changes beat trying to fix everything at once. Use the Sectors slider in Summary (more sectors = shorter stretches) to check the time arrived exactly where you worked on it.

Comparison sessions

A comparison session puts laps from different sessions together, such as your best lap from each of three evenings, or your lap against a friend's. It works like any other session: Summary, Analysis and Video (or RaceBox) all compare its fastest and pinned laps.

  1. Open a session and tick the checkbox on the laps you want, in the Sector Summary, the lap traces, or the RaceBox lap list. A bar appears at the bottom of the screen.
  2. Click Create Comparison. The first lap sets the track; every lap you add must be the same type (GT7, PC2 or RaceBox) and track.
  3. Open another session, tick more laps, and click Add to… to add them to the same comparison.
  4. Click Save on the comparison's card to keep it. Once saved, adding or removing laps updates it automatically.

Racing your friends

Add friends, chat, and share sessions to compare against each other's laps.

The friends and messages panel showing a conversation with a shared session
The ✉ panel: a conversation with a shared session.

Add a friend

Click ✉ in the header → Friends, type their @username and click Add. They'll see your request under Requests and can Accept or Decline. There's no directory to browse: you need their exact username.

Message

Under Friends, click Message. Conversations appear under Messages, with a badge for unread ones. If you unfriend someone, your conversation becomes read-only.

Share a session

  1. Click Share on a session card, or on its Library row.
  2. Pick the friend, add a message if you like, and click Share.
  3. Your friend gets it in your conversation. Add to my library adds a copy to their Library and opens it; after that the button reads View session. Offers not accepted within 14 days expire.

A shared session is a read-only copy: your friend can open it and analyse it, but not download, edit or re-share it. Comparisons can be shared too.

Block or report someone

Click Block… on their request, on their row under Friends, or at the top of your conversation with them.

Lap against lap
Once a friend's session is in your Library, open it, tick their best lap and Add to… a comparison with your own best lap at the same track and car. Analysis then coaches you on exactly where their lap is faster.

Reviewing with real video

The rendered view needs no setup and is great for line and inputs. To see what really happened (traffic, a twitchy rear, a missed apex), record gameplay on the PS5 at the same time as your telemetry, then follow Using your own gameplay video. Sync once per video; the sync is remembered.

A RaceBox track day

  1. Export each session from the RaceBox app as CSV and upload them.
  2. In Summary, compare Dynamic sectors (consistent splits you can resize) with From Track (the RaceBox's own sectors).
  3. In Analysis, use Accel / Decel (estimated) to see where you start slowing and get back on the power compared with your best lap, then Min Corner Speed, Traction, Steering Smoothness and Driving Line for your line and commitment.
  4. On the Video page, add your onboard video and hover the analysis lanes to watch each corner. Compare the A/D lanes of two laps to see where you started slowing and got back on the power; switch VIEW to Maps to see it on the track.
  5. Build a comparison of your best lap from each session to track progress over the day.

Before the day, read Racecraft, safety, flags and penalties (flags, passing etiquette, what to do in a spin) and Vision and the vanishing point. If rain is forecast, read Surfaces, weather and tyres.

Troubleshooting & FAQ

Recording

ProblemTry this
The app stays on Looking for your PS5…Make sure GT7 is running and the phone and PS5 are on the same Wi-Fi (not a guest network). On iPhone, Local Network access must be allowed (Settings → Privacy & Security → Local Network). Or type the PS5's IP address in the app.
Recording stops when the phone's screen turns offAllow unrestricted battery use (the app asks on Record; also under Settings → Battery). On Android 14 or newer, keep Keep screen on while recording switched on.
"No complete lap — recording discarded"The recording didn't include a full lap: a lap counts once you've crossed the start/finish line twice while recording. Press Record before you start your out-lap or flying lap, and Stop after crossing the line at the end.
Rings turn orange mid-sessionNo data for a few seconds: you're in a menu or loading screen, the PS5 is off, or the phone has dropped off Wi-Fi. Telemetry only flows while you're on track.
"No active gtelemetry stream" when clicking Record SessionRun gtelemetry stream on the computer next to your PS5 first, and check it's paired (gtelemetry login).
gtelemetry shows no telemetrySame network as the PS5? GT7 on track? Did you allow incoming connections when macOS asked? (System Settings → Network → Firewall → allow gtelemetry.)
macOS says gtelemetry can't be openedDownload the latest zip from Downloads…: it's notarized by Apple and opens normally. (An older copy can be opened with xattr -d com.apple.quarantine gtelemetry in its folder.)
Project CARS 2 shows a low packet shareUse a computer connected by Ethernet. Over Wi-Fi only about 12% of packets arrive.

Pairing and uploads

ProblemTry this
"That code didn't work"Codes last 5 minutes and work once. Click New code in Devices… and try again.
The app went back to the Pair screenThe phone was removed under Devices…. Pair it again; recordings waiting to upload are kept.
An upload failedRecordings tab → ⋮ → Retry upload once you have internet. Very long sessions (over about 2 hours) can be too large.
Lost phone or computerRemove it under Devices…: it can't upload any more.

Reviewing

QuestionAnswer
Why does it say "Unknown Track"?The track couldn't be matched to GTelemetry's track list (new or unusual layouts). Everything works except the track name and corner names, and the rendered view draws it as tarmac.
Why is Analysis empty?It needs at least one complete lap. Out-laps and in-laps don't count.
Is the time in Show me what I lost?No. It's marked ≈ because it's an example: what a typical version of that mistake would roughly cost on that corner. The card and the coaching show your real numbers.
Why does Show me pick that corner?It uses the corner the card flags most strongly that suits the animation: the pedal cards need a corner you brake for, and Gear & RPM one that needs a downshift. On the Video page it follows the cursor. Choose Generic to see a standard corner instead.
Why are some cards or statistics missing?They need data the source doesn't record: TCS for Project CARS 2; pedals, gears and RPM for RaceBox.
The comparison looks oddCheck which lap is pinned: compare your fastest with a representative lap, not one with a spin or an off.
Can I change my username?No: usernames are permanent. Your display name can differ from it.

Privacy

“Gran Turismo”, “PlayStation” and “PS5” are registered trademarks or trademarks of Sony Interactive Entertainment Inc. Project CARS is a trademark of its respective owner. RaceBox is a trademark of its respective owner. GTelemetry is not affiliated with, endorsed by or sponsored by Sony Interactive Entertainment Inc., Polyphony Digital Inc. or any other owner named here.