Skip to content

v0.3.2 Pre-Release

Pre-release
Pre-release

Choose a tag to compare

@pratama1246 pratama1246 released this 03 Nov 05:33
· 3 commits to main since this release

What's New in v0.3.2

Offline & Downloaded Media Support (Instant Local Resolver)

Version 0.3.2 introduces a local format resolver that reads Apple Music's downloaded media containers, allowing the application to identify track formats without relying solely on online catalog metadata.

  • Inspects Apple Music local download containers under %USERPROFILE%\Music\Apple Music\Media\Apple Music\...\*.movpkg.
  • Parses unencrypted HLS manifests (master.m3u8) to extract SAMPLE-RATE and BIT-DEPTH information.
  • Cross-references manifest information with completed stream IDs recorded in boot.xml to identify the corresponding downloaded media format.
  • Detects downloaded Hi-Res Lossless tracks, including 96 kHz / 24-bit and 192 kHz / 24-bit formats, without requiring an active internet connection for local format resolution.
  • For online tracks with ambiguous or capped public API metadata, an available local download can take priority and provide a more specific format reference.

Dynamic ETW Telemetry & 30-Log Learning Window

This release expands the application's ability to learn and resolve track formats from Apple Music's local playback telemetry.

Expanded Startup History Window

  • Increased the initial SavedLogs scan from 5 to 30 historical ETL logs.
  • Allows the application to process a larger playback history during startup.
  • Extracted and correlated format information is persisted in the local Adam ID format cache, helping improve resolution for previously played tracks.

Live SavedLogs Rotation Ingestion

  • Added dynamic monitoring for newly archived playback session logs in SavedLogs.
  • When Apple Music completes a session and archives its ETW log buffer, the application automatically processes the new telemetry.
  • Extracts reported format information, including asbdSampleRate and sdBitDepth, and updates corresponding cached track mappings.
  • Helps refine earlier format estimates, such as upgrading an interim 96 kHz resolution to a telemetry-reported 192 kHz format, without requiring manual cache intervention.

Startup DAC Format Preservation

Idle State Gating

  • Fixed an issue where launching LosslessSwitcher while Apple Music was paused or idle could unnecessarily force the audio endpoint to 24-bit / 44.1 kHz.
  • Added playback-state gating to prevent unnecessary endpoint format changes when no active music playback is detected.
  • Preserves the DAC's existing default endpoint format, including configurations such as 32-bit / 384 kHz or 24-bit / 48 kHz, until active playback requires a format adjustment.

Smart Hi-Res Ambiguity Handling

Rational Interim Fallback

  • Improved format estimation for streaming Hi-Res tracks when Apple's public web API provides limited sample-rate information.
  • When the actual Hi-Res sample rate cannot be determined from available metadata, the application now uses 96 kHz / 24-bit as an interim fallback instead of defaulting to CD-quality 44.1 kHz.
  • This fallback is based on the observation that approximately 85% of Apple's Hi-Res catalog uses 96 kHz, providing a more practical initial estimate while waiting for more specific format information.

Hardware Safety Clamping

  • Retains WASAPI hardware candidate probing to identify formats supported by the active audio endpoint.
  • When a requested sample rate is unsupported by the connected DAC, such as 88.2 kHz or 176.4 kHz, the application selects a supported alternative through its hardware format validation process.
  • Helps avoid requesting unsupported endpoint formats during automatic switching.

Downloads

File Type Description
AMWin-LosslessSwitcher-Setup-v0.3.2.exe Windows Installer Full Inno Setup installer for standard installation.
AMWin-LosslessSwitcher-Portable-v0.3.2.exe Portable Executable Single-file portable binary that runs without installation.

Platform: Windows 10 / 11 (64-bit)
License: GPL-3.0

For installation instructions and additional details, see the [README].