austinbaccus / forza-telemetry

Record and Display Telemetry from Forza Motorsport 7, Horizon 4, and Horizon 5.
MIT License
234 stars 36 forks source link
forza forza-horizon forza-horizon-4 forza-horizon-5 forza-motorsport-7

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

  1. Visit Microsoft's .NET 6.0 download page
  2. Download the x64 SDK version of the installer for Windows

Configuring Forza's UDP settings

Motorsport 7/2023
  1. Launch the game and head to the HUD options menu
  2. Set Data Out to ON
  3. Set Data Out IP Address to 127.0.0.1 (localhost)
  4. Set Data Out IP Port to 5300
  5. Set Data Out Packet Format to CAR DASH
Horizon 4/5
  1. Launch the game and proceed through the menus until you can drive your car
  2. Pause the game and navigate to the Settings menu
  3. Navigate to HUD and Gameplay
  4. Set Data Out to ON
  5. Set Data Out IP Address to 127.0.0.1 (localhost)
  6. Set Data Out IP Port to 5300

Enable UDP Loopback for Forza (not needed for Steam versions or any version of FM2023)

  1. Install Window 8 AppContainer Loopback Utility
  2. Start the utility (if it shows a message about orphan sid, you can safely ignore it)
  3. Make sure that Forza Horizon 4 / Motorsport 7 are checked
  4. Save changes

More information on how to enable this and why it's necessary can be found here

Running the App

  1. Pre-requisites: Make sure git and npm are installed
  2. Clone this repository: git clone https://github.com/austinbaccus/forza-telemetry.git
  3. Open a terminal and navigate to the folder containing the src folder
  4. Install dependencies with npm install
  5. Run: npm run build:react | npm run build | npm run start

OR

  1. Download the latest release version
  2. Unzip the folder
  3. Run the executable

🚀 Features

Record Telemetry


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

Fuel Management

Lap Dashboard

Runs on your Local Machine

⚒️ 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.