https://github.com/p403n1x87/f1-telemetry
F1 telemetry data collection and visualisation
https://github.com/p403n1x87/f1-telemetry
Last synced: 7 days ago
JSON representation
F1 telemetry data collection and visualisation
- Host: GitHub
- URL: https://github.com/p403n1x87/f1-telemetry
- Owner: P403n1x87
- Created: 2022-07-11T11:40:14.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2025-07-15T19:01:29.000Z (3 months ago)
- Last Synced: 2025-09-27T22:19:37.486Z (15 days ago)
- Language: HTML
- Size: 4.15 MB
- Stars: 13
- Watchers: 2
- Forks: 2
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# F1 Telemetry Data Collector
This Python application uses InfluxDB to collect telemetry data from the
official F1 game.
It is also possible to display live session and car data.
## Installation
The application requires Python >= 3.8 to work.
~~~
pip install pipx
pipx install f1-telemetry
~~~
## Usage
Ensure that InfluxDB is running with at least an Org and an access token, and
configured with an `f1-telemetry` bucket.
~~~
f1-tel
~~~
This also serves a very basic web application for telemetry and live data
visualisations. With InfluxDB still running, navigate to
`http://localhost:20776/index.html` page in the browser with the `org` and
`token` parameters, e.g.
~~~
http://localhost:20776/index.html?org=P403n1x87&token=NLyjW4ml8XuTPTwCbtC5PC1Z-JJ6lwjAm7B1-ScM_XP9N_eoCkIGTmm3wHrC92cQVsMmKofgqbx6PM-ZZgVQKw==
~~~
> **NOTE**: The application can run without InfluxDB. In this case, no telemetry
> data will be stored. If you are using this tool without a running instance of
> InfluxDB, the `` and `` arguments must still be provided, but they
> can be random values, e.g.
> ~~~
> f1-tel no influxdb
> ~~~
## Additional Features
### TT Rival Data
When collecting data from Time Trials and competing against a rival, some of
the rival's car data is also collected, like throttle, brake, speed, and gears,
for comparison.
### Reporting
After sessions like Qualifying and Race, the final classification data can be
collected in CSV reports by passing the `-r`,`--report` option from the command
line. The files are generated in the current working directory. The collected
data can be useful for league coordinators.