From 1b115d6f2a49f2c8814f6c9fbb61f59619cc1eed Mon Sep 17 00:00:00 2001
From: Joona <joona.metsankyla@outlook.com>
Date: Sat, 6 Jun 2026 21:28:27 +0300
Subject: [PATCH] edit Readme

---
 README.md | 103 ++++++++++++++++++++++++++++++++++++++++++------------
 1 file changed, 80 insertions(+), 23 deletions(-)

diff --git a/README.md b/README.md
index ae53b9e..49f6413 100644
--- a/README.md
+++ b/README.md
@@ -1,35 +1,92 @@
-# Forza-Telemetry
+# Forza Telemetry
 
-Telemetry application for forza horizon.
+External telemetry dashboard for Forza Horizon.
 
-![Application](images/appWindow.jpg)
+<p align="center">
+  <img src="images/appWindow.jpg" width="100%" alt="Forza Telemetry application window">
+</p>
 
-Vehicle dashboard
-![Dashboard](images/dashboardjpg.jpg)
+## Features
 
-Vehicle telemetry
-![Telemetry](images/telemetry.jpg)
+### Vehicle dashboard
 
-Livegraphs
-![Livegraphs](images/livegraphs.jpg)
+Displays RPM, speed, gear, steering, boost, throttle, brake, and clutch telemetry.
 
-Setting up.
+<p align="center">
+  <img src="images/dashboardjpg.jpg" width="100%" alt="Vehicle dashboard">
+</p>
 
-Open app.
-From top left corner open settings.
-Set port and press start or use default one.
-![Setup_1](images/setup_1.jpg)
+### Vehicle telemetry
 
-Open settings and search HUD & Gameplay
-![Setup_0](images/setup_0.jpg)
+Displays tire temperatures, suspension travel, slip vectors and vehicle information.
 
-Search Telemetry.
-Toggle Data Out -> On
-Data out ip address should be local host -> 127.0.0.1
-Data out ip port is same that you defined in application settings.
-![Setup_2](images/setup_2.jpg)
+<p align="center">
+  <img src="images/telemetry.jpg" width="100%" alt="Vehicle telemetry board">
+</p>
 
+### Live graphs
 
+Displays real-time telemetry history for engine data, tire temperatures, and suspension travel.
 
-Known bugs
-    -Rear right wheel temperature value is from rear left wheel.
\ No newline at end of file
+<p align="center">
+  <img src="images/livegraphs.jpg" width="100%" alt="Live telemetry graphs">
+</p>
+
+## Installation
+
+1. Open the repository's **Releases** page.
+2. Download the latest Windows ZIP package.
+3. Extract the entire ZIP file.
+4. Run `ForzaTelemetry.exe`.
+
+The application is self-contained, so no separate .NET installation should be required.
+
+## Forza setup
+
+### 1. Start the telemetry application
+
+Open Forza Telemetry.
+
+Open the menu from the top-left corner.
+
+Use the default UDP port or enter another port, then press **Start**.
+
+<p align="center">
+  <img src="images/setup_1.jpg" width="700" alt="Forza Telemetry connection setup">
+</p>
+
+### 2. Open the Forza settings
+
+In Forza Horizon, open **Settings** and select **HUD & Gameplay**.
+
+<p align="center">
+  <img src="images/setup_0.jpg" width="700" alt="Forza HUD and Gameplay settings">
+</p>
+
+### 3. Enable Data Out
+
+Find the telemetry or Data Out settings and configure:
+
+```text
+Data Out: On
+Data Out IP Address: 127.0.0.1
+Data Out IP Port: 20440
+```
+
+The port must match the port configured in Forza Telemetry.
+
+<p align="center">
+  <img src="images/setup_2.jpg" width="700" alt="Forza Data Out settings">
+</p>
+
+## Known issues
+
+* The rear-right tire temperature may duplicate the rear-left tire temperature. This appears to be caused by the telemetry data provided by the game.
+
+## Disclaimer
+
+This is an unofficial community application and is not affiliated with or endorsed by Microsoft, Xbox, Playground Games, Turn 10 Studios, or the Forza franchise.
+
+## License
+
+This project is licensed under the [MIT License](LICENSE).