aionlslivetiming
Async-first Python client for the Nürburgring Langstrecken-Serie livetiming service.
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
- Quickstart — full walkthrough (live + replay + record + filter)
- Examples — three worked examples
- API Reference — auto-generated from docstrings
- Changelog
- Contributing
- License — MIT
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.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| aionlslivetiming-0.1.1.tar.gz | 501.6 kB | Without provenance | Details for aionlslivetiming-0.1.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| aionlslivetiming-0.1.1-py3-none-any.whl | Python 3 | none | any | Details for aionlslivetiming-0.1.1-py3-none-any.whl |
Total release size: 571.9 kB
Release files / aionlslivetiming-0.1.1.tar.gz
| Download URL | aionlslivetiming-0.1.1.tar.gz |
|---|---|
| Size | 501.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
42412a9566bc0ffb2461c5e95292bad830023904179edd7d83e1be335d3a6151
|
|
BLAKE2b-256 checksum How to use checksums |
48a82f24cd27754e9601c822fbc7d2b4026dace094dbcc56d35b103d2d3ce5ff
|
| 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.1-py3-none-any.whl
| Download URL | aionlslivetiming-0.1.1-py3-none-any.whl |
|---|---|
| Size | 70.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
0b3492e8f9133752be40f78274d874203dbd6f76b7ab6714b86b4c8b44f52f12
|
|
BLAKE2b-256 checksum How to use checksums |
d8bc176ad63abdd83e22a63b674f09d90081d5b7c867661a585fad6938e04420
|
| 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.1
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.