# @deltazeroproduction/f1-udp-parser

> The F1 series of games support the outputting of key game data via a UDP data stream. This data can be interpreted by external apps or connected peripherals for a range of different uses, including providing additional telemetry information, customised HU

Latest version **1.2.2** (published 2025-10-06) · MIT license · 0 weekly downloads

## Install

```sh
npm install @deltazeroproduction/f1-udp-parser
pnpm add @deltazeroproduction/f1-udp-parser
yarn add @deltazeroproduction/f1-udp-parser
bun add @deltazeroproduction/f1-udp-parser
```

## Health

**Score 55/100 (C)** — status: stable.

Positive: has types; no vulnerabilities; high quality score.

Warnings: low downloads; no esm support.

## Facts

| | |
|---|---|
| Version | 1.2.2 |
| Published | 2025-10-06 |
| First published | 2023-05-04 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | CommonJS |
| Dependencies | 2 |
| Unpacked size | 251.2 KB |
| Known vulnerabilities | 0 (+1 in 1 direct dependencies) |
| Install scripts | no |
| GitHub stars | 11 |
| Maintainers | delta-zero-production |
| Keywords | automotive, grand prix, f12022, f122, f1 2022, f12023, f123, f1 2023, f12024, f124, f1 2024, f125, f1 2025, formula 1, f1, codemasters, EA, udp, telemetry, racing, simracing, gaming, formula, ps4, ps5, xbox, xbox one, playstation, playstation 4, playstation 5, esports, e sports, e-sports, f1 sim racing, videogame, podium, dzp, delta zero, delta zero production |

## Links

- npm: https://www.npmjs.com/package/@deltazeroproduction/f1-udp-parser
- Repository: https://github.com/deltazeroproduction/f1-udp-parser
- Homepage: https://github.com/deltazeroproduction/f1-udp-parser#readme
- Issues: https://github.com/deltazeroproduction/f1-udp-parser/issues
- npm.io page: https://npm.io/package/@deltazeroproduction/f1-udp-parser

## Dependencies (2)

- [struct](https://npm.io/package/struct.md) ^0.0.12
- [binary-parser](https://npm.io/package/binary-parser.md) ^1.5.0

## Alternatives

- [mobx-react](https://npm.io/package/mobx-react.md) — 2.8M weekly downloads
- [rc-tree](https://npm.io/package/rc-tree.md) — 2.6M weekly downloads
- [@react-oauth/google](https://npm.io/package/@react-oauth/google.md) — 1.3M weekly downloads
- [@wagmi/connectors](https://npm.io/package/@wagmi/connectors.md) — 877.0K weekly downloads
- [vee-validate](https://npm.io/package/vee-validate.md) — 836.4K weekly downloads

## Recent versions

- 1.2.2 (latest) — 2025-10-06
- 1.1.2-beta.0 (beta) — 2024-05-30
- 1.0.11 (preRelease) — 2023-06-07
- 1.2.1 — 2025-07-18
- 1.2.0 — 2025-07-18
- 1.1.2 — 2024-05-31
- 1.1.1 — 2024-05-04
- 1.1.0 — 2024-04-26
- 1.1.0-beta.2 — 2024-04-26
- 1.1.0-beta.1 — 2024-04-26
- 1.0.13 — 2024-04-05
- 1.0.12 — 2024-02-24
- 1.0.10 — 2023-06-02
- 1.0.9 — 2023-05-29
- 1.0.8 — 2023-05-29
- … 8 more at https://npm.io/package/@deltazeroproduction/f1-udp-parser/versions

## README

# F1 UDP Parser

The F1 series of games support the outputting of key game data via a UDP data stream. This data can be interpreted by external apps or connected peripherals for a range of different uses, including providing additional telemetry information, customised HUD displays, motion platform hardware support or providing force feedback data for custom steering wheels.

This is a TypeScript UDP client and telemetry parser for EA - Codemaster's F1 2022, F1 23, F1 24, and F1 25.

## Installing

```
$ npm install @deltazeroproduction/f1-udp-parser
```

or

```
$ yarn add @deltazeroproduction/f1-udp-parser
```

## Running the parser

```
$ npm run start
```

or

```
$ yarn start
```

## Usage

```
import { F1TelemetryClient, constants } from "f1-telemetry-client";
// or: const { F1TelemetryClient, constants } = require('f1-telemetry-client');
const { PACKETS } = constants;

/*
*   'port' is optional, defaults to 20777
*   'forwardAddresses' is optional, it's an array of Address objects to forward unparsed telemetry to. each address object is comprised of a port and an optional ip address
*                   defaults to undefined
*   'skipParsing' is optional, setting it to true will make the client not parse and emit content. You can consume telemetry data using forwardAddresses instead.
*                   defaults to false
*/
const client = new F1TelemetryClient({ port: 20777 });
client.on(PACKETS.event, console.log);
client.on(PACKETS.motion, console.log);
client.on(PACKETS.carSetups, console.log);
client.on(PACKETS.lapData, console.log);
client.on(PACKETS.session, console.log);
client.on(PACKETS.participants, console.log);
client.on(PACKETS.carTelemetry, console.log);
client.on(PACKETS.carStatus, console.log);
client.on(PACKETS.finalClassification, console.log);
client.on(PACKETS.lobbyInfo, console.log);
client.on(PACKETS.carDamage, console.log);
client.on(PACKETS.sessionHistory, console.log);
client.on(PACKETS.tyreSets, console.log); // F1 23 and 24 only
client.on(PACKETS.motionEx, console.log); // F1 23 and 24 only
client.on(PACKETS.timeTrial, console.log); // F1 24 only
client.on(PACKETS.lapPositions, console.log); // F1 25 only

// to start listening:
client.start();

// and when you want to stop:
client.stop();
```

## Documentation

The following links contain information that summarises the UDP data structures so that developers of supporting hardware or software are able to configure these to work correctly with the F1 game.

[F1 2022 UDP Spec](https://answers.ea.com/t5/General-Discussion/F1-22-UDP-Specification/td-p/11551274)

[F1 23 UDP Spec](https://answers.ea.com/t5/General-Discussion/F1-23-UDP-Specification/m-p/12633159)

[F1 24 UDP Spec](https://answers.ea.com/t5/General-Discussion/F1-24-UDP-Specification/m-p/13745220)

[F1 25 UDP Spec](https://forums.ea.com/blog/f1-games-game-info-hub-en/ea-sports%E2%84%A2-f1%C2%AE25-udp-specification/12187347)

## License

Licensed under the MIT License.

---
_Source: https://npm.io/package/@deltazeroproduction/f1-udp-parser · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._