explaingit

forza-love/fh6-virtual_tcu

Analysis updated 2026-05-18

★ 33PythonAudience · generalComplexity · 3/5Setup · moderate

TLDR

A Windows tool that automatically shifts gears in Forza Horizon 6 by reading live game telemetry and pressing the shift keys for you.

Mindmap

mindmap
  root((fh6-virtual_tcu))
    What it does
      Reads FH6 telemetry
      Auto shifts gears
      Live web dashboard
    Tech stack
      Python backend
      Vue frontend
      Windows only
    Use cases
      Auto shifting while racing
      Recording driving data
      Tuning drive modes
    Audience
      FH6 players
      Forza Mods community
      Sim racing modders

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Let the tool shift gears automatically while you focus on steering and racing lines.

USE CASE 2

Switch between comfort, race, drift, and offroad shift behavior with a hotkey.

USE CASE 3

Record telemetry from your driving sessions to review shifts later.

USE CASE 4

Run it from source and customize the web dashboard if you know Python or Vue.

What is it built with?

PythonVueNode.jsWindows

How does it compare?

forza-love/fh6-virtual_tcu410979729/scope-recallarahim3/mlx-dspark
Stars333333
LanguagePythonPythonPython
Setup difficultymoderatemoderateeasy
Complexity3/53/53/5
Audiencegeneraldeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires Windows, administrator privileges, and manual in-game transmission and telemetry setup.

The README does not state a license.

In plain English

This project is a tool that automatically shifts gears for you while playing Forza Horizon 6, a racing video game. It runs outside the game itself, reading live telemetry data the game sends out, such as speed, RPM, throttle position, and brake pressure, and then presses the shift up and shift down keys on your behalf based on how you are driving. To use it, you first switch the game's transmission setting to manual with no clutch and set your keyboard shift bindings to specific keys, then turn on the game's telemetry data output so it sends information to the tool over your local network. The tool comes as a downloadable Windows program, so most players just extract a zip file and run it as an administrator, no programming knowledge required. Developers who want to run it from the source code instead need Python and, if they plan to modify the visual dashboard, Node.js as well. Once running, it opens a web page in your browser that acts as a live dashboard, showing your gear, speed, RPM, throttle and brake input, and other engine details while you race. There are six drive modes to choose from, ranging from a fuel-efficient comfort setting to an aggressive race setting that holds gears close to redline, plus a drift mode and an offroad mode, and a manual mode that turns the automatic shifting off entirely. You can switch between these modes with a keyboard shortcut while the game is running. The tool also lets you record your telemetry data as you drive, either capturing just the moments around gear shifts or the full stream of data, which can be useful for reviewing your driving sessions later. All of your settings, saved driving profiles, and recorded logs are stored in files near the program itself. The project is written in Python for the backend and uses Vue for its web dashboard, and it is maintained by a member of a Forza Mods Discord community for players of the game. It only works on Windows and requires administrator privileges because it needs to send keyboard input directly into the game.

Copy-paste prompts

Prompt 1
Walk me through setting up FH6 in-game transmission and Data Out settings for a telemetry tool like this.
Prompt 2
Explain what each drive mode (comfort, dynamic, race, drift, offroad, manual) is likely doing based on this README.
Prompt 3
Help me write a Python script that reads UDP telemetry packets similar to what this project describes.
Prompt 4
What would I need to change in a project like this to support a different racing game's telemetry format?

Frequently asked questions

What is fh6-virtual_tcu?

A Windows tool that automatically shifts gears in Forza Horizon 6 by reading live game telemetry and pressing the shift keys for you.

What language is fh6-virtual_tcu written in?

Mainly Python. The stack also includes Python, Vue, Node.js.

What license does fh6-virtual_tcu use?

The README does not state a license.

How hard is fh6-virtual_tcu to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is fh6-virtual_tcu for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.

Alternatives & similar repos