Projects 01
An explainable audio analysis and mastering engine, written in modern Python.
Hear it · the pilot's first record, track 01
What WPAudio Engine is
Every decision WPAudio Engine makes answers three questions: what, why, and how. Not as a comment in the source, and not as a paragraph in a manual. Each answer carries the metric IDs it used, the thresholds it compared against, the confidence it had, and what it chose to protect at the cost of something else.
Mastering tools that work well tend to be either a cloud service you upload to and hope, or a chain of processors that will not tell you what they did. WPAudio Engine is an argument that an engine can make good decisions and account for them.
01
Five stages, with strict boundaries between them. Three are built, one is partly built, and one is an empty package with a name.
01Built
Immutable buffer, loader
02Built
Five analysers, 39 metrics
03Not yet built
Milestone M2: an empty package
04Partially built
Reference mastering only
05Built
HTML, JSON, CSV
One line through five stages. A built stage is a filled node joined by a solid segment; the partly built stage is a ring joined by a long dash; the planned stage is a quiet ring joined by a short dash. Each stage says its state in words above its name.
Those are three of twelve rules the project holds itself to. The one that matters most for explainability is blunter: the “why” is not a comment. It is a test. A rule that cannot be asserted against a table of inputs and expected decisions does not ship.
02
Ruff and strict MyPy clean. Python 3.12 or later, on numpy, soundfile and pyloudnorm: three runtime dependencies, deliberately. Figures from a run on 20 August 2026.
03
Not a mockup: the engine running locally, mid-session, on a track from the pilot's first record. It analysed the file, mastered it to a stated target, then re-opened the written file from disk and checked its own work with a second, independent meter.
04
Album-level analysis exists because another Studio project needed it. The twelve-track Wings & Prayers record by The Little Blue Pilot was WPAudio Engine's first real production workload: thirty-three minutes of finished masters, analysed end to end in seventy-nine seconds. Those reference masters have since shipped. The album was released on streaming platforms on 11 August 2026, byte for byte from the files this engine verified.
Running a real record through it surfaced things a synthetic test signal never would. The clearest: silence was reporting an integrated loudness of 0.0 LUFS, maximal loudness, the worst possible sentinel a loudness metric could pick. It now reports negative infinity, and the JSON exporter serialises non-finite values as null rather than emitting invalid JSON.
One project's engine, mastering another project's music. That is the whole Studio thesis inside a single working directory.
A month after the first record, the same engine mastered the same songs again for the Second Flight record, to a different brief: one platform-reference level for every track, and every figure cross-checked by a meter from outside the project before it was published.
05
Architecture notes, benchmark results, a roadmap read from the repository rather than maintained twice, and documentation as the API settles. Each appears on this page when there is something real behind it, and not before. A hosted service is a later chapter, not a product and not a waitlist.
06
DropTrack's Music Analyzer scored Wings & Prayers: Second Flight between 94 and 97 out of 100. The full results, what the tool says the number is, and the line between a proprietary score and a measurement someone else can repeat.
The mastering case study forced a decision about evidence: quote the private engineering reports, or measure the published files. Choosing the second changed what the page could honestly say, and became a standing rule.