unitracker-player
The generic player of canonical unitracker documents,
and their builder into standalone PSID .sid files.
It reads a document with the grammar of
unitracker-grammar and plays it to the state of
the 25 SID registers ($D400-$D418) at the end of each tick. It knows only the document: its
instruments, programs, expressions, phrases and timeline, and the note table F(k) at its clock.
Install
pip install "unitracker-player @ git+https://github.com/anarkiwi/unitracker-player"
Use
from unitracker_player import load, play, Player
frames = play(text) # np.uint8 array (ticks, 25), to the end of an ending song
frames = play(text, ticks=3000) # a looping song needs ticks
song = load(text) # parse and compile once; play(song, ...) reuses it
player = Player(song)
regs = player.step() # the 25 registers after one tick; None once the song ends
player.regs # the register file the last tick wrote, one store per register
read(text) returns the document as plain dataclasses. A text outside the grammar raises
unitracker_grammar.CanonicalError; a document the player refuses raises PlayError.
unitracker-play song.yaml --ticks 3000 --out frames.npz # array "frames"
unitracker-play song.yaml --out frames.csv # one row per tick, d400..d418
unitracker-play song.yaml # CSV to stdout
unitracker-sid song.yaml # song.sid
unitracker-sid song.yaml --out x.sid --ticks 3000 --load 0x2000
unitracker-sid renders the song here, proves where a looping song repeats, and assembles a
6502 playroutine (llvm-mos, locally or in the
docker-mos-llvm-sdk image) whose raster IRQ
plays the same registers tick for tick.
Docs
docs/semantics.md: the meaning of every construct of the grammar as played.
docs/sid.md: how a document becomes a .sid, and the tests that check it.
1 maintainer
Metadata
1 maintainer
Release files for unitracker-player 0.7.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 | |
|---|---|---|---|---|
| unitracker_player-0.7.1.tar.gz | 53.2 kB | With provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| unitracker_player-0.7.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 95.2 kB
Release files / unitracker_player-0.7.1.tar.gz
| Download URL | unitracker_player-0.7.1.tar.gz |
|---|---|
| Size | 53.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
c38e81e6838340ce98c05f30055ae128248b3b103d7dc377f0472ee47ec3c035
|
|
BLAKE2b-256 checksum How to use checksums |
d8b7e841eef038e747e021f80f5def33a51467d4b83468089dea946831c46222
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 23, 2026.
Transparency logRelease files / unitracker_player-0.7.1-py3-none-any.whl
| Download URL | unitracker_player-0.7.1-py3-none-any.whl |
|---|---|
| Size | 42.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
00100662d8983afa155b563663fada8e988004e5624ca34882d37b602214f93c
|
|
BLAKE2b-256 checksum How to use checksums |
460d97e7648932829be288cb3b7b6ded8002bba3189cf65d1ce4d34ed057a86b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 23, 2026.
Transparency logSecurity for unitracker-player 0.7.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.
Full provenance
All 2 files in this release have been uploaded with provenance metadata.
Attestation for unitracker_player-0.7.1.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 23, 2026.
Transparency logA 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.
