PHPackages                             andywaite/sim-telemetry-parser - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. andywaite/sim-telemetry-parser

ActiveLibrary

andywaite/sim-telemetry-parser
==============================

Library to parse UDP packets from racing sims. Currently supports Codemasters' F1 2020 only.

0.1.1(5y ago)162GPL-3.0-or-laterPHPPHP ^7.4

Since Aug 22Pushed 5y ago1 watchersCompare

[ Source](https://github.com/andywaite/sim-telemetry-parser)[ Packagist](https://packagist.org/packages/andywaite/sim-telemetry-parser)[ RSS](/packages/andywaite-sim-telemetry-parser/feed)WikiDiscussions master Synced today

READMEChangelog (2)Dependencies (1)Versions (3)Used By (0)

Library to parse UDP packets from sim racing games
==================================================

[](#library-to-parse-udp-packets-from-sim-racing-games)

**Currently only supports Codemasters F1 2020**

See:

Many sim racing games can send telemetry data over the network to a 3rd party app.

The data format varies from game-to-game, but often includes:

- Car data like speed & engine RPM
- Control data like throttle position & steering angle
- Lap data like current lap time and fastest sectors

The data sent in the UDP packets comes through as a raw binary stream. The aim of this library is to take that binary stream and turn it into something we can work with in PHP.

Note that this library does NOT handle receiving the binary stream or display it - merely parsing the raw data and turning it into a friendly model.

How to use
----------

[](#how-to-use)

1. Use Composer to install

    `$ composer install andywaite/sim-telemetry-parser`
2. Use it!

    ```
    // Create parser class
    $parser = AndyWaite\SimTelemetryParser\Parser::getParser();

    // Parse a stream
    $packet = $parser->streamToModels($binaryStream);

    // Get index of player  car
    $playerCar = $packet->getHeader()->getPlayerCarIndex();

    // Each packet contains different data. Speed is only contained in the car telemetry packet
    if ($packet instanceof \AndyWaite\SimTelemetryParser\Game\F12020\Structs\PacketCarTelemetryData) {
     echo "You are traveling at ".$packet->getCarTelemetry($playerCar)->getSpeed()."kph";
    }

    ```

For a scrappy demo of it in use, see `demo.php`

Types of model that can be returned by parse function
-----------------------------------------------------

[](#types-of-model-that-can-be-returned-by-parse-function)

- `AndyWaite\SimTelemetryParser\Game\F12020\PacketCarSetupData`
- `AndyWaite\SimTelemetryParser\Game\F12020\PacketCarStatusData`
- `AndyWaite\SimTelemetryParser\Game\F12020\PacketCarTelemetryData`
- `AndyWaite\SimTelemetryParser\Game\F12020\PacketEventData`
- `AndyWaite\SimTelemetryParser\Game\F12020\PacketFinalClassificationData`
- `AndyWaite\SimTelemetryParser\Game\F12020\PacketHeader`
- `AndyWaite\SimTelemetryParser\Game\F12020\PacketLapData`
- `AndyWaite\SimTelemetryParser\Game\F12020\PacketLobbyInfoData`
- `AndyWaite\SimTelemetryParser\Game\F12020\PacketMotionData`
- `AndyWaite\SimTelemetryParser\Game\F12020\PacketParticipantsData`
- `AndyWaite\SimTelemetryParser\Game\F12020\PacketSessionData`
- `AndyWaite\SimTelemetryParser\Game\F12020\FastestLap`
- `AndyWaite\SimTelemetryParser\Game\F12020\Penalty`
- `AndyWaite\SimTelemetryParser\Game\F12020\RaceWinner`
- `AndyWaite\SimTelemetryParser\Game\F12020\Retirement`
- `AndyWaite\SimTelemetryParser\Game\F12020\SpeedTrap`
- `AndyWaite\SimTelemetryParser\Game\F12020\TeamMateInPits`

Future development
------------------

[](#future-development)

I plan to write a much nicer server application & visualiser which will use this library.

For a complete reference of packets & their contents, see:

###  Health Score

22

—

LowBetter than 22% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity7

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity45

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~0 days

Total

2

Last Release

2086d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/df3b84c45fff8328d8900997e87a215e1e538cfea47be8872fa1c4e35afbffbc?d=identicon)[andywaite](/maintainers/andywaite)

---

Top Contributors

[![andywaite](https://avatars.githubusercontent.com/u/6773151?v=4)](https://github.com/andywaite "andywaite (7 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/andywaite-sim-telemetry-parser/health.svg)

```
[![Health](https://phpackages.com/badges/andywaite-sim-telemetry-parser/health.svg)](https://phpackages.com/packages/andywaite-sim-telemetry-parser)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)