Forza Telemetry
[![Status](https://img.shields.io/badge/status-active-success.svg)]()
[![GitHub Issues](https://img.shields.io/github/issues/austinbaccus/forza-telemetry.svg)](https://github.com/eastonco/YikYak/Issues)
[![GitHub Pull Requests](https://img.shields.io/github/issues-pr/austinbaccus/forza-telemetry.svg)](https://github.com/eastonco/YikYak/pulls)
[![License](https://img.shields.io/badge/license-MIT-blue.svg)](/LICENSE)
Record and Display Telemetry from Forza Motorsport 2023, Forza Motorsport 7, Horizon 4, and Horizon 5.
📝 Table of Contents
🏁 Quick Start
Configuration
Installing .NET 6.0
- Visit Microsoft's .NET 6.0 download page
- Download the x64 SDK version of the installer for Windows
Configuring Forza's UDP settings
Motorsport 7/2023
- Launch the game and head to the HUD options menu
- Set
Data Out
to ON
- Set
Data Out IP Address
to 127.0.0.1
(localhost)
- Set
Data Out IP Port
to 5300
- Set
Data Out Packet Format
to CAR DASH
Horizon 4/5
- Launch the game and proceed through the menus until you can drive your car
- Pause the game and navigate to the Settings menu
- Navigate to HUD and Gameplay
- Set
Data Out
to ON
- Set
Data Out IP Address
to 127.0.0.1
(localhost)
- Set
Data Out IP Port
to 5300
Enable UDP Loopback for Forza (not needed for Steam versions or any version of FM2023)
- Install Window 8 AppContainer Loopback Utility
- Start the utility (if it shows a message about orphan sid, you can safely ignore it)
- Make sure that Forza Horizon 4 / Motorsport 7 are checked
- Save changes
More information on how to enable this and why it's necessary can be found here
Running the App
- Pre-requisites: Make sure
git
and npm
are installed
- Clone this repository:
git clone https://github.com/austinbaccus/forza-telemetry.git
- Open a terminal and navigate to the folder containing the
src
folder
- Install dependencies with
npm install
- Run:
npm run build:react | npm run build | npm run start
OR
- Download the latest release version
- Unzip the folder
- Run the executable
🚀 Features
Record Telemetry
- This app allows users to save all telemetry to a CSV file for later analysis
- All incoming telemetry data is saved (along with the timestamp)
This gif was created by using the Recording feature and Forza Map Visualization to make a 3D trace of the player's XYZ coordinates during a race
Map Trail
- Your car's path will be drawn in real-time as you drive around in either Motorsport or Horizon
Fuel Management
- Displays the number of laps you can go until you run out of fuel
- Displays the amount of fuel consumed per lap
- Displays your car's MPG
Lap Dashboard
- Displays time and split time for every lap, not just your best and previous lap
Runs on your Local Machine
- Forza Telemetry uses a UDP loopback so that you can run this program on the same computer that you're using to play Forza
⚒️ Built Using
❓ FAQ
Why does the MPG value look off?
Because Forza doesn't tell us how much fuel is actually in the car, so a best guess is made. The MPG calculation is assuming that every car in Forza has around 14 gallons of fuel. Fixing this (or getting the correct fuel capacity values) is on my to-do list.
Why is the app running slowly?
Most likely the map has too much data to render.
Why do some things look out of place?
This app looks best when it's in a 1920x1080 window (and looks even better in fullscreen mode). When the window deviates from this size, some visual elements might be placed incorrectly. Press F11 to make the app fullscreen.
Can I use this app with an Xbox?
Yes! You have to change the IP address and port in the Forza settings menu to match your computer's IP and port.
🆘 Troubleshooting
The app appears but I can't see any data
This probably means that you don't have the right version of the C# SDK installed, or you downloaded the SDK but did not install it. Run dotnet --info
in any terminal and make sure you have .NET SDK v6.0 installed.