GT7 Telemetry Dashboard & Driving Coach

Real-time telemetry dashboard and AI driving coach for Gran Turismo 7. Captures live data from your PlayStation via UDP telemetry, displays it on any device with a browser (optimized for iPad), and analyzes your driving to help you get faster.

Features

Live Telemetry Dashboard

• Speed, RPM, Gear with large, glanceable display
• Throttle & Brake vertical bars
• RPM bar with redline flash warning
• Tire temperatures (FL/FR/RL/RR) with color coding (cold/optimal/hot)
• Tire slip detection — lockup and wheelspin warnings
• G-force meter — real-time lateral/longitudinal G with trail
• Turbo boost indicator
• Oil & water temperature
• Fuel level with laps-remaining prediction
• Race position (1st/2nd/3rd...)
• Lap times — current, best, last

Track Map

• Speed-colored track map — built in real-time from car position data
• Color gradient from blue (slow) → green → yellow → red (fast)
• Live car position dot

Sector Times

• Track auto-divided into 3 sectors
• Sector times for every lap in a table
• Color-coded: purple (best overall), green (improved), red (slower)
• Live current-lap sectors

AI Driving Coach

• Delta time — ahead/behind your best lap in real-time
• Speed comparison — current vs reference at every point
• Driving tips: BRAKE LATER, MORE THROTTLE, CARRY MORE SPEED, BRAKE NOW!, GOOD SPEED!
• Full-screen alerts — impossible-to-miss colored bars for braking and shifting

Gear Shift Assistant

• Automatic gear limit learning — detects max speed per gear for any car
• Shift up/down indicators with distance warnings (e.g., ↓ 3 in 50m)
• Reference gear display — shows what gear the best lap used at each point
• Speed ceiling alerts — LIMIT ↑ 5 (max 256) when hitting a gear's top speed
• Works from lap 1 — no reference needed for basic shift advice

Post-Lap Error Analysis

• After each lap, detailed error report comparing to your best
• Track divided into 20 zones, each analyzed for:
  • Early/late braking (with distance in meters)
  • Slow corner speed (delta in km/h)
  • Slow exit speed
  • Wrong gear selection
  • Unnecessary braking
• Time lost/gained per zone
• Top 5 errors sorted by severity
• Improvements highlighted in green

Requirements

• Gran Turismo 7 running on PS4 or PS5
• Python 3.10+ on a computer on the same network
• A browser to view the dashboard (iPad, phone, laptop, etc.)

Quick Start

1. Clone & install

git clone https://github.com/plirex/gran-turismo.git
cd gran-turismo
python3 -m venv .venv
.venv/bin/pip install -r requirements.txt

2. Find your PlayStation's IP address

On your PS4/PS5: Settings → Network → View Connection Status — note the IP address.

3. Run

./run.sh --console-ip YOUR_PS_IP

Or directly:

.venv/bin/python server.py --console-ip 192.168.1.100

4. Open dashboard

On your iPad/phone/laptop browser, go to:

http://YOUR_COMPUTER_IP:8080

Find your computer's IP with ifconfig (macOS) or ip addr (Linux).

5. Start a race in GT7

The dashboard will automatically connect when you're on track. Telemetry is only sent during gameplay (not in menus).

Command Line Options

python server.py [--console-ip IP] [--port PORT]

  --console-ip    PlayStation IP address (default: 192.168.112.107)
  --port          Web server port (default: 8080)

How It Works

1. The server sends a UDP heartbeat to your PlayStation on port 33739
2. GT7 responds with telemetry packets (296 bytes, 60Hz) encrypted with Salsa20
3. Packets are decrypted, parsed, and broadcast to connected browsers via WebSocket
4. The driving coach records every lap and compares to your best in real-time
5. Post-lap analysis identifies specific errors and time losses

Architecture

PlayStation (GT7)
    │ UDP telemetry (60Hz, Salsa20 encrypted)
    ▼
server.py ─── gt7_packet.py (decrypt + parse)
    │         coach.py (real-time comparison)
    │         analyzer.py (post-lap analysis)
    │ WebSocket (30Hz)
    ▼
Browser (iPad/phone/laptop)
    └── static/index.html + style.css + app.js

Tips

• iPad fullscreen: Add to Home Screen for a fullscreen app experience (uses apple-mobile-web-app-capable)
• Multiple devices: Any number of browsers can connect simultaneously
• Car changes: Gear limits auto-reset when you switch cars (detected via RPM limit change)
• New track: Track map and sectors auto-rebuild on each session
• Best lap reference: Updates automatically when you set a new personal best

Supported Data (GT7 Telemetry Packet)

Field	Source
Position (X/Y/Z)	0x04-0x0F
Velocity (X/Y/Z)	0x10-0x1B
Rotation (Pitch/Yaw/Roll)	0x1C-0x27
Engine RPM	0x3C
Fuel level/capacity	0x44-0x4B
Speed (m/s)	0x4C
Turbo boost	0x50
Oil pressure/temp	0x54-0x5F
Water temp	0x58
Tire temps (4 wheels)	0x60-0x6F
Lap/time data	0x70-0x7F
Race position	0x84-0x87
RPM limits	0x88-0x8B
Gear/Throttle/Brake	0x90-0x92
Tire angular speed	0xA4-0xB3
Tire diameter	0xB4-0xC3
Suspension travel	0xC4-0xD3
Gear ratios	0x100-0x123

License

MIT