Repository navigation
v0.3.0 Pre-Release
Pre-releaseWhat's New in v0.3.0
Hybrid Detection Engine (Native ETW Telemetry)
Previous versions relied primarily on Apple Music's public Web API (amp-api) to resolve track formats. However, its browser playback manifests are limited to 48 kHz, making it difficult to distinguish between 96 kHz and 192 kHz Hi-Res Lossless tracks.
Version 0.3.0 introduces a native diagnostic log reader (EtwLogReader) that combines catalog metadata with local playback telemetry:
- Reads Event Tracing for Windows (
.etl) logs generated by Apple Music Windows' playback agent (AMPLibraryAgent.exe, including itscmplayercomponent). - Extracts audio format information from
mediaFormatinfoevents, includingasbdFormatID,sdFormatID,asbdSampleRate, andsdBitDepth. - Identifies ALAC playback formats, including sample rates such as 96 kHz and 192 kHz, with their reported bit depth.
- Filters transitional buffering events (
qaac→qlac) to avoid applying preliminary format information. - Correlates track identifiers (
adamID) with playback events across track transitions, using related playback log events such assong changed,/syllable-lyrics, and FairPlay lease events. - Uses dynamic telemetry parsing without track-specific or artist-specific hardcoding.
Live Format Refinement
For uncached tracks, Apple Music may take a few hundred milliseconds to flush playback telemetry to its local log.
During this period, the Coordinator can apply an initial format estimate from catalog metadata. Once the corresponding ETW telemetry becomes available, the endpoint format is automatically refined to match the reported playback format.
This allows playback format detection to proceed without waiting for the local log buffer before making an initial adjustment.
Cache Architecture v4
- Upgraded the local catalog cache schema to v4 (
catalog_cache.json). - Stores track ID (
adamID) to resolved format mappings locally. - Repeated playback of cached tracks can use previously resolved format information for faster switching.
Audio Transparency
Version 0.3.0 also improves the project's documentation around Windows audio behavior:
- Clarifies that the application synchronizes sample rate and bit depth at the Windows audio endpoint level.
- Documents Apple Music for Windows' use of WASAPI Shared Mode.
- Explicitly states that the application does not provide WASAPI Exclusive Mode, ASIO bypass, or a bit-perfect guarantee.
Verified Resolution Tests
The following tracks were used to test format detection and endpoint switching:
| Track & Artist | Catalog Trait | Resolved Endpoint Format | Lossless Status |
|---|---|---|---|
| Coldplay — Yellow (Parachutes) | Hi-Res Lossless | 192 kHz / 24-bit | Lossless (ALAC) |
| Eagles — Hotel California (2013 Remaster) | Hi-Res Lossless | 192 kHz / 24-bit | Lossless (ALAC) |
| RIIZE — Behind The Shine (The Perfect Crown OST) | Hi-Res Lossless | 96 kHz / 24-bit | Lossless (ALAC) |
| The Rose — Back To Me (DUAL) | Lossless | 48 kHz / 24-bit | Lossless (ALAC) |
| DxS — Blue (Serenade - EP) | Lossless | 44.1 kHz / 16-bit | Lossless (ALAC) |
| JOY — Hello (Special Album) | Lossy AAC | 44.1 kHz / 16-bit | Lossy (AAC) |
These results represent the tested endpoint formats and reported playback information. They do not establish bit-perfect output.
Downloads
| File | Type | Description |
|---|---|---|
AMWin-LosslessSwitcher-Setup-v0.3.0.exe |
Windows Installer | Installs the application, creates Start Menu and Desktop shortcuts, and provides an optional startup launch setting. |
AMWin-LosslessSwitcher-Portable-v0.3.0.exe |
Portable Executable | Runs without installation and supports adjacent configuration and cache storage using portable.dat or the --portable argument. |
Platform: Windows 10 / 11 (64-bit)
License: GPL-3.0
For installation instructions and additional details, see the [README](../../#readme).