Skip to main content

aionlslivetiming

Async-first Python client for the Nürburgring Langstrecken-Serie livetiming service.

PyPI Python License Status

aionlslivetiming wraps the official NLS livetiming WebSocket feed at livetiming.azurewebsites.net and exposes a clean async Python API. It works equally well in two modes: live (connected to a running race) and replay (driven from a recorded JSONL log). Downstream projects (Discord bots, dashboards, Home Assistant integrations, analytics tools) consume NLS race data without reverse-engineering the Azure WebSocket or the cryptic short-code JSON the server actually emits.

Installation

uv add aionlslivetiming
# or:
pip install aionlslivetiming

Requires Python 3.12+. No Home Assistant-specific dependencies; safe to install anywhere.

60-Second Quickstart

Live (5 lines)

import asyncio
from aionlslivetiming import NLSClient

async def main():
    async with NLSClient(event_id="20") as client:
        async for msg in client.messages():
            print(msg)

asyncio.run(main())

Replay (3 lines)

from aionlslivetiming import NLSClient

async with NLSClient.from_replay("recording.jsonl") as client:
    async for msg in client.messages():
        print(msg)

Filter (5 lines)

async with NLSClient.from_replay("recording.jsonl") as client:
    async for _ in client.messages():
        pass  # populate state
    top3 = client.state.filter().by_position(lo=1, hi=3).cars()
    for car in top3:
        print(car.starting_no, car.driver)

Recording

uv run nls-record 20 /tmp/event.jsonl

Captures a live race to JSONL for offline replay.

Documentation

Full documentation: docs/quickstart.md

License

MIT — see LICENSE.

Acknowledgements

Race data is published by the Nürburgring Langstrecken-Serie. This library is a community wrapper; it is not affiliated with or endorsed by the NLS organization.

Metadata

Release files for aionlslivetiming 0.1.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for aionlslivetiming 0.1.2
File Size Uploaded Provenance Actions
aionlslivetiming-0.1.2.tar.gz 503.2 kB Without provenance Details for aionlslivetiming-0.1.2.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for aionlslivetiming 0.1.2
File Interpreter ABI Platform Actions
aionlslivetiming-0.1.2-py3-none-any.whl Python 3 none any Details for aionlslivetiming-0.1.2-py3-none-any.whl

Total release size: 574.9 kB

Release files / aionlslivetiming-0.1.2.tar.gz

Download URL aionlslivetiming-0.1.2.tar.gz
Size 503.2 kB
Tags Source
SHA-256 checksum
How to use checksums
4cd81b59ac921eac32c6deacf521297c32441906feb766d0398a2df9a6dbf825
BLAKE2b-256 checksum
How to use checksums
ace45043243e350e841f6a7fa1e71119c3583902b5ad271129867b338b23a676
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.12.1 {"installer":{"name":"uv","version":"0.12.1","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / aionlslivetiming-0.1.2-py3-none-any.whl

Download URL aionlslivetiming-0.1.2-py3-none-any.whl
Size 71.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
24d4a9bdb7b8258bc44a5a4aced0b1c524bd45934255f5e93f827aa8b2d453e1
BLAKE2b-256 checksum
How to use checksums
4b3a24c8bb34f2d15bdb27ba77969f98af1ce91e97ed214a1af535f944461a35
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.12.1 {"installer":{"name":"uv","version":"0.12.1","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Security for aionlslivetiming 0.1.2

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page