Download, pick your OS, follow the steps — then everything joins back up. Roughly 10 minutes start to finish.
Or clone from GitHub: github.com/ransh2014/gt7telemtrace
Right-click gt7telem.zip → Extract All → choose somewhere you'll remember, like Documents. This creates a gt7telem folder with everything inside.
Go to python.org, download Python 3.10 or later, and run the installer.
In File Explorer, open the gt7telem folder. Click the address bar at the top — it goes blue and shows the full path. Copy it.
Press Win + R, type cmd, press Enter. Then in the terminal:
Paste your actual copied path inside the quotes.
Double-click gt7telem.zip in Finder — macOS extracts it automatically into a gt7telem folder right next to it. Move it somewhere you'll remember, like your home folder or Documents.
Go to python.org, download the macOS installer for Python 3.10 or later, and run it. macOS ships with a very old Python 2 — you need 3.10+.
brew install python3 in Terminal instead.Press Cmd + Space, type Terminal, hit Enter. Then navigate to the folder:
Adjust the path if you put the folder somewhere else. If you're not sure, drag the gt7telem folder from Finder directly into the Terminal window after typing cd — it fills in the path automatically.
Press Ctrl + Alt + T (works on most distros). If that doesn't work, find Terminal in your app launcher.
Navigate to wherever the zip downloaded (usually ~/Downloads) and extract it:
sudo apt install unzip (Debian/Ubuntu) first.Most Linux distros already have Python 3 — check with python3 --version. You need 3.10 or later. If it's missing or too old:
Open config.py in any text editor. Find this line and replace the example IP with your PS4/PS5's actual IP:
One requirements file covers both tools. Run:
pip3 instead of pip if the above doesn't work.pip install pycryptodome --userMake sure GT7 is open and running on your PS4/PS5 first, then in your terminal:
python3 gt7telem.py instead.config.py, and make sure your PC and console are on the same network. GT7 needs to be in-game, not on the home screen.After recording some laps with the dashboard running, your data is saved automatically. To open the lap analyst — 14 chart groups, A vs B comparison, sector timing, driver ratings:
python3 lap_analyst.pyCore protocol by
Bornhall — GT7 UDP TelemetryWant to save laps to a different location or tweak the sample rate? Open config.py and edit these two lines:
Windows example: "C:\Users\YourName\Documents\laps"
macOS / Linux example: "/home/yourname/documents/laps"
Yes. The telemetry UDP stream is identical on PS4 and PS5. Just set your PS5's IP in config.py the same way.
Two most common causes: the IP in config.py is wrong, or your PC and PS4/PS5 are on different subnets (e.g. one on 2.4 GHz, one on 5 GHz). Also make sure GT7 is actually in-game, not just sitting on the PS home screen.
Try installing with the user flag: pip install pycryptodome --user. On macOS/Linux, use pip3. If that still fails on Windows, make sure you ran the Python installer with "Add to PATH" ticked, and restart your terminal after installing Python.
In File Explorer, click View in the top menu and make sure Address bar is ticked. Then click directly on the address bar text — it highlights and reveals the full path like C:\Users\YourName\Documents\gt7telem. Copy that exactly.
macOS ships with no Python or a very old version. Use python3 and pip3 for all commands — that's the version you installed from python.org or Homebrew.
tkinter isn't always included in Linux Python installs. Fix it with: sudo apt install python3-tk (Debian/Ubuntu) or sudo dnf install python3-tkinter (Fedora).
The GT7 UDP telemetry stream was reverse-engineered by the community — specifically Bornhall, whose gt7telemetry repo figured out the Salsa20 decryption key and full packet structure. This project's core data layer is built on that work.