Repository navigation
v0.3.2 Pre-Release
Pre-release
Pre-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 extractSAMPLE-RATEandBIT-DEPTHinformation. - Cross-references manifest information with completed stream IDs recorded in
boot.xmlto 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
SavedLogsscan 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
asbdSampleRateandsdBitDepth, 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].