Skip to content

v0.3.0 Pre-Release

Pre-release
Pre-release

Choose a tag to compare

@pratama1246 pratama1246 released this 02 Nov 08:30
· 7 commits to main since this release

What'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 its cmplayer component).
  • Extracts audio format information from mediaFormatinfo events, including asbdFormatID, sdFormatID, asbdSampleRate, and sdBitDepth.
  • 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 as song 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).