Skip to content

Releases

Nativerate 0.1.12

Choose a tag to compare

@dizzysound dizzysound released this 29 Oct 20:44
5a5e5c9

Nativerate 0.1.12 moves the bit-perfect check out of the main menu, stops false Sound Check and lossy readings, and shows the Dolby Atmos item only where it applies. The driver is unchanged (still 1.2.1).

Changed: the bit-perfect check runs only when you ask for it (#75). "Bit-perfect check…" now sits at the bottom of the menu next to Settings and About, and the warning icon and "N to review" count are gone from the top. The check runs when you open its window or press Refresh; nothing runs in the background any more. While a check runs the window shows "Checking…" and Refresh is disabled, so you never see the previous result. The "Music settings" warning line stays at the top.

Changed: the Dolby Atmos item shows only for Apple Music subscription streams (#75). It is hidden for local, matched and uploaded tracks. Nativerate does not detect the subscription itself (Music stores no reliable key); it uses the track's cloud status plus a file on disk.

Fixed: Sound Check warning that could not be cleared (#75). The "Music settings" window, its notification and the top menu line now count Sound Check as on only when Music's own setting is on. The Bit-perfect check window still reports any Sound Check scaling Music logs for a track, with its scalar.

Fixed: AAC start followed by a lossless upgrade was labeled "lossy" (#74). A track that started on a lossy (AAC) decoder line and then upgraded to the lossless decoder was relabeled "lossy" on one Mac, because plain 24-bit tracks there were off both sample grids. Cause, from Music's log: Sound Check scaling every track while the optimizeSongVolume preference read off. Nativerate now reads Sound Check from Music's own log line, and after a lossless upgrade a lossy start counts as lossy only when Music's settings leave the samples alone.

Verified:

  • scripts/tests/run.sh passes on a Mac, with new cases for the stream check (9) and the Sound Check readings; the Debug build succeeds. The release zip is built from the same code as the tested branches.
  • An adversarial review of the branch (four rounds for #75), plus a review of the version bump, passed.
  • Checked on a Mac on macOS 27.2: the window wording in the dev build. The bit-perfect window and the Atmos item were not clicked through on a subscription stream and a local track in every combination.

Not verified: the Equalizer/Crossfade row (shown as "check in Music" by design), the "DAC takes 32-bit float only" row, the alert and other-apps rows. The lossy-flip fix (#74) was not replayed with this build on the affected Mac. A Sound Check change made mid-track shows at the next track, because Music logs the line only when a track starts. docs/menu.png still shows the old menu.

Updating from 0.1.11: quit Nativerate and replace the app. There is no driver update. macOS asks for Microphone access again because this is a new ad-hoc signed copy; until you allow it, Nativerate leaves the output alone.

Installing fresh: unzip to ~/Applications, right-click Nativerate > Open the first time (ad-hoc signed, not notarized), then use Install Exclusive Mode driver… in its menu. Allow Microphone and Automation. Full steps are in the README.

If something goes wrong: menu About Nativerate > Export logs… and attach the zip to an issue.

SHA-256 of Nativerate-0.1.12.zip: 67e685f14d60b35a68d6a5dccb3a61946ed4272d819c09216edf78efc223a7a7

Nativerate 0.1.11

Choose a tag to compare

@dizzysound dizzysound released this 28 Oct 14:50
8b98617

Nativerate 0.1.11 fixes a crash when Music changes tracks. It is a fix release; the driver is unchanged (still 1.2.1).

Fixed: crash when Music changes tracks (#69). On one Mac (DAWN PRO2, Exclusive Mode, 96 kHz) Nativerate crashed with EXC_BAD_ACCESS as Music changed tracks. The crash report put the crashing thread in the bit-perfect check, inside NSAppleScript, which Apple lists as main-thread-only; the check ran it on a background queue. This is the likely cause, not a confirmed one: the crash was seen once and was not reproduced.

Changed: the bit-perfect check's AppleScript now runs in an osascript process (#70). The check runs its script in a child /usr/bin/osascript with a 10 s timeout instead of inside Nativerate. It is safe from any thread, cannot corrupt the app, and a hung Music costs one timeout instead of the app.

Changed: local track lookups and the Music volume reset moved too (#71). LocalTrack and the Music volume reset used the same pattern (a fresh NSAppleScript on a background thread) and now also run in osascript. Leading and trailing spaces in a returned path are kept; only the final line break is removed. Cost: osascript is slower per call than in-process (median on one Mac, 20 runs each: player state 14 ms vs 66 ms, volume 37 ms vs 67 ms).

Not changed: the scripts in TrackBoundarySwitcher and RendererEngine still run in-process. They sit on the latency-critical paths (pause at the track boundary, position polling), osascript would add about 50 to 60 ms per call there, and there is no crash evidence for them. The administrator-password prompt for the driver install is unchanged too.

Verified:

  • scripts/tests/run.sh passes on a Mac, including osascript_runner (output, syntax error, timeout, 16 concurrent background callers, edge whitespace). The Debug build succeeds. The tested code is identical to this release's code.
  • Bench on a Mac with a Neumann MT 48, Exclusive Mode, local tracks at 44.1, 48, 88.2, 96 and 192 kHz, using a build of #70: 48 track changes at 4 s gaps, 48 at 1 s gaps and 24 at 0.3 s gaps gave 0 AppleScript errors and 0 crashes. The check read Music volume correctly (60% reported as REVIEW, 100% as ok) and reported Music volume couldn't be read with Music not running, without crashing.
  • For #71, the two local-track scripts gave identical results in-process and in osascript in 20 of 20 calls over 10 local tracks (44.1, 88.2 and 96 kHz, spaces in names, a non-ASCII path, one track with no location).

Not verified: the original crash was not reproduced, so there is no before-and-after run showing the crash gone; 0 crashes in the bench is the evidence, and a long listening session is not covered. The bench ran a build of #70 only. #71 (local track lookups, volume reset) has the unit tests, the build and the 20-call comparison above, but no full track-change bench run of its own. The macOS Automation prompt on a clean install was not checked.

Updating from 0.1.10: quit Nativerate and replace the app. There is no driver update. macOS asks for Microphone access again because this is a new ad-hoc signed copy; until you allow it, Nativerate leaves the output alone.

Installing fresh: unzip to ~/Applications, right-click Nativerate > Open the first time (ad-hoc signed, not notarized), then use Install Exclusive Mode driver… in its menu. Allow Microphone and Automation. Full steps are in the README.

If something goes wrong: menu About Nativerate > Export logs… and attach the zip to an issue.

SHA-256 of Nativerate-0.1.11.zip: 8ed79d9ff48a3a8b60c050bf8e9856df4ad5cd38483144c1fcda1510fe0620a0

Nativerate 0.1.10

Choose a tag to compare

@dizzysound dizzysound released this 26 Oct 19:33
f708675

Nativerate 0.1.10 hardens Exclusive Mode against a stalled DAC and a stalled Core Audio. It is a fix release; the driver is unchanged (still 1.2.1).

Changed: stutter, stop and catch-up after a rate switch (#63). On one Mac with a Neumann MT 48, a switch from 44.1 kHz up to 88.2/96 kHz sometimes left the DAC restarting its IO about 3.7 times a second for 45 to 55 seconds, while the machine was under heavy CPU load from compiles (the trigger is not proven). Nativerate waited 12 s, then played into the half-stopped DAC anyway: about 18 s of audio was dropped, and once the DAC settled the output ran about 10.9 s behind Music until the next track switch. Now, after the 12 s wait, a rate switch keeps Music paused and waits up to 90 s more for the DAC. The clock lock also cuts a buffer that has grown to more than twice its target back to the target before it locks, so the delay cannot stick. Turning Exclusive Mode off ends the wait, and a play or pause you make in Music during the wait is kept. Under full CPU load on that Mac, one switch took 77 s to become ready (Music is silent for that time); nothing was dropped and the buffer stayed at about 0.5 s.

Changed: a stalled Core Audio call could freeze a rate switch (#63). The built-in-speakers player for other apps was started on the engine thread. In a load test one such call did not return for over 3 minutes and Music stayed paused. It now starts on a background thread; if it hangs, other apps stay silent until it returns, and Music is not held. A log line the player is still starting after 10 s marks it.

Changed: stop then start could run two engines (#64, #65). If turning Exclusive Mode off timed out after 20 s, a new start could run a second engine next to the old thread, and a switch blocked past the timeout could re-select the virtual output and play Music again. The engine's slot now stays taken until the old thread ends, a start in that time is deferred, and a switch that outlives the timeout stops instead of playing.

Fixed (build 12): playback stayed paused after a rate switch (#67). In build 11, a switch sometimes ended with Music paused until you pressed Play. Music posts its own "playing" state a fraction of a second after Nativerate pauses it; the watch for your own play/pause took that for you pressing Play, then saw Music paused and concluded you had paused it, so it never resumed. In the logs from one Mac, 2 of 3 switches stalled this way (28 s and 20 s until Play was pressed). Now a "playing" within 2 s of our pause still triggers a re-pause but no longer counts as you pausing. Trade-off: a play and pause you make within 2 s of our pause is not seen. Not reproduced on hardware with a DAC; covered by unit tests (scripts/tests/run.sh). Build 11 (Oct 26, 2026) is replaced by build 12 under the same version number; the build number is in the app's bundle (CFBundleVersion 12).

README (#62): the menu's format label, the rate-change script, and the Switch margin latency (0.35 to 0.75 s) are documented.

Not verified: the MT 48 stall cannot be triggered on demand, so there is no before-and-after run on hardware for the 90 s wait. The background start and the stop/start changes have no hardware run. The background start and the engine slot (#64) have unit tests (scripts/tests/run.sh); #65 has no unit test and was source-reviewed and built only, not exercised on hardware on its own. Nativerate 0.1.9 can also hang at startup under saturated CPU (seen on one Mac); this release does not fix that. If you see Music stays paused, waiting in the log, that is the new wait.

Updating from 0.1.9: quit Nativerate and replace the app. There is no driver update. macOS asks for Microphone access again because this is a new ad-hoc signed copy; until you allow it, Nativerate leaves the output alone.

Installing fresh: unzip to ~/Applications, right-click Nativerate > Open the first time (ad-hoc signed, not notarized), then use Install Exclusive Mode driver… in its menu. Allow Microphone and Automation. Full steps are in the README.

If something goes wrong: menu About Nativerate > Export logs… and attach the zip to an issue.

SHA-256 of Nativerate-0.1.10.zip (build 12): c9c6e7db0921ecae4c02182e5e8f81fdaecdb02a9d9ae9f322197a5ee4e3bd8f

Nativerate 0.1.9

Choose a tag to compare

@dizzysound dizzysound released this 24 Oct 18:53

Nativerate 0.1.9 is a hot fix for the format label (#60). Since 0.1.7 the menu could call a lossless streamed track "lossy" (seen on one Mac with a 24-bit lossless ALAC track).

Fixed: "lossy" shown for lossless tracks. When a track's samples fit neither the 16-bit nor the 24-bit grid and Music gave no decoder line for it, Nativerate called it lossy whenever Music's volume, Sound Check and Sound Enhancer were off. Music can reuse an earlier decoder, so a missing line says nothing, and the first track after launch (no decoder history at all) was labeled lossy. Now "lossy" needs a positive sign: the newest decoder line must have been lossy. Otherwise the menu shows "? bit". No audio-path code is touched; sample rate switching is the same as 0.1.8.

Not changed: a 16-bit track can still show as 24 bit. That comes from the 0.1.7 rule that keeps Music's 24-bit setting over a 16-bit grid. Open: why the samples on that Mac sit off both grids is not found; it needs a live probe on that Mac. The fix is covered by a unit test (scripts/tests/run.sh) and a Debug build; it is not verified live on that Mac.

Updating from 0.1.8: quit Nativerate and replace the app. There is no driver update (the driver stays at 1.2.1). macOS asks for Microphone access again because this is a new ad-hoc signed copy; until you allow it, Nativerate leaves the output alone.

Installing fresh: unzip to ~/Applications, right-click Nativerate > Open the first time (ad-hoc signed, not notarized), then use Install Exclusive Mode driver… in its menu. Allow Microphone and Automation. Full steps are in the README.

If something goes wrong: menu About Nativerate > Export logs… and attach the zip to an issue.

SHA-256 of Nativerate-0.1.9.zip: 2cb6942fdb43d2d9b784c30833694a9b2126e3f0f7145000e281aa7dc5b28bbf

Nativerate 0.1.8

Choose a tag to compare

@dizzysound dizzysound released this 24 Oct 17:49

Nativerate 0.1.8 fixes a regression from 0.1.7: a streamed track could play for about 3 seconds at the previous track's sample rate and then rewind to the start at the right rate (#57).

Fixed: wrong rate at the start of a streamed track. 0.1.7 waits up to 3 seconds for a streamed track's own decoder line before it picks the rate (this stops the 44.1, 48, 44.1 kHz flap). When the track changed by itself (auto-advance) or by a skip while playing, the output kept running during that wait, so the new track played at the old rate until the line arrived. Now the output holds at the track's first sample during the wait and restarts at the right rate. The wait itself is unchanged, so the 48 kHz flap fix stays (#58).

Checked on two Macs with the same method (cold streamed tracks with auto-advance, plus a mixed 44.1/48/88.2/96 kHz playlist). The 0.1.7 build played at the wrong rate at the start of a track in 4 of 52 track changes on one Mac, and in 13 of 59 on the other (7 of those ran the full 3 seconds and rewound). The 0.1.8 build did it in none of the 42 and 59 track changes. Road To Reno still shows no 48 kHz switch. A short silent start (up to 3 seconds) is possible on a few streamed tracks while Nativerate waits for the track's own rate. Not tested: unplugging the DAC.

Updating from 0.1.7: quit Nativerate and replace the app. There is no driver update (the driver stays at 1.2.1). macOS asks for Microphone access again because this is a new ad-hoc signed copy; until you allow it, Nativerate leaves the output alone.

Installing fresh: unzip to ~/Applications, right-click Nativerate > Open the first time (ad-hoc signed, not notarized), then use Install Exclusive Mode driver… in its menu. Allow Microphone and Automation. Full steps are in the README.

If something goes wrong: menu About Nativerate > Export logs… and attach the zip to an issue.

SHA-256 of Nativerate-0.1.8.zip: 8d3a55da00b60d81b877594fcfeaee4e88611f9084aab6f5b21e8d2d87f80f51

Nativerate 0.1.7

Choose a tag to compare

@dizzysound dizzysound released this 19 Oct 01:27

Nativerate 0.1.7 fixes more cases where Exclusive Mode got the rate or the bit depth wrong for Apple Music streamed tracks (#41). It builds on 0.1.6.

Fixed: false "lossy" after taking the output back. After a long pause, Nativerate could show a lossless stream as lossy (for about 27 seconds in the case we traced) because the decoder line Music had logged for the track was missed or came late. Take-back now keeps the track's own lossless line, and a decoder-log feed that stops is restarted and noted in the engine log (#53, #55).

Fixed: 24-bit tracks shown as 16-bit. When Music says a track is 24-bit but all its samples sit on the 16-bit grid (for example a 16-bit master in a 24-bit file), the label now keeps 24-bit instead of dropping to 16 (#54).

Fixed: no more 48 kHz flap. For a streamed track Music can report a stale rate (48 kHz) at the track change while the stream is 44.1 kHz, which made the DAC go 44.1, 48, then back to 44.1. Nativerate now waits up to 3 seconds for the track's own decoder line before it decides (#54).

Fixed: Down Home Girl rate. A stream whose library info is empty kept Music's 44.1 kHz instead of its own 48 kHz lossless rate. It now switches to the stream's rate (#49).

Checked on a test Mac with Road To Reno and Old Brown Shoe: Road To Reno keeps 24-bit with no rate flap, Old Brown Shoe stays correct, and a take-back after a pause logs the rate and depth it kept. Not yet checked on the reporter's setup.

Updating from 0.1.6: quit Nativerate and replace the app. There is no driver update (the driver stays at 1.2.1). macOS asks for Microphone access again because this is a new ad-hoc signed copy; until you allow it, Nativerate leaves the output alone.

Installing fresh: unzip to ~/Applications, right-click Nativerate > Open the first time (ad-hoc signed, not notarized), then use Install Exclusive Mode driver… in its menu. Allow Microphone and Automation. Full steps are in the README.

If something goes wrong: menu About Nativerate > Export logs… and attach the zip to an issue.

SHA-256 of Nativerate-0.1.7.zip: 05f4ed81320d60abc6e6cbeb90d74de6a75c8035be4e48e0be2f354ccf00d337

Nativerate 0.1.6

Choose a tag to compare

@dizzysound dizzysound released this 16 Oct 11:39
6b67e20

Nativerate 0.1.6 fixes Exclusive Mode picking the wrong sample rate for some Apple Music streamed tracks (#41).

Fixed: wrong rate for library-added Apple Music streams. For a streamed track (Apple Music subscription, no file on disk), Music can report the catalog rate (often 44.1 kHz) while the lossless stream it plays is 48, 88.2, 96 kHz or higher. Nativerate took Music's number, left the DAC at 44.1 kHz, and showed the track as lossy. Now, when the track's own lossless decoder reports a different rate shortly after it starts, Nativerate switches the DAC to that rate and treats the track as lossless. Local files, matched or uploaded tracks, and lossy streams behave as before.

Checked on a DragonFly Black with seven library-added streams: the 88.2 kHz and 96 kHz tracks now play at their own rate; 192 kHz tracks are capped at 96 kHz by that DAC; 44.1 kHz tracks are unchanged.

Fixed: lossless stream shown as lossy. A lossless Apple Music stream could show as lossy when Music reused the decoder already in use and logged no decoder line for the track. Nativerate now takes the bit depth from that decoder line. A second fix: when the next track's pre-roll decoder line arrived just after the track's own, the next track's bit depth could be shown (for example 24-bit on a 16-bit track after a skip back); only the first line now counts (#45). The zip was rebuilt with these fixes (same version and build number); if you downloaded 0.1.6 before 2026-10-17 10:30 AM CT, replace it (#44).

Known limits. On some tracks the switch comes about 3 seconds after the track starts, so the start can be at 44.1 kHz before it switches (a short gap). Gapless auto-advance and take-back after stepping aside were not tested for this fix.

Updating from 0.1.5: quit Nativerate and replace the app. There is no driver update (the driver stays at 1.2.1). macOS asks for Microphone access again because this is a new ad-hoc signed copy.

Installing fresh: unzip to ~/Applications, right-click Nativerate > Open the first time (ad-hoc signed, not notarized), then use Install Exclusive Mode driver… in its menu. Allow Microphone and Automation. Full steps are in the README.

If something goes wrong: menu About Nativerate > Export logs… and attach the zip to an issue.

SHA-256 of Nativerate-0.1.6.zip: f1f5a1ac47f39b2204b71513a3789803f8638d521612ef47494ae39a0705ebe4

Nativerate 0.1.5

Choose a tag to compare

@dizzysound dizzysound released this 07 Oct 21:10
3a6b212

Nativerate 0.1.5 adds Integer Mode, mute and software volume for DACs without a volume control, a DAC Info view, and a cleaner menu.

New: Integer Mode (Settings > Advanced, off by default, Exclusive Mode only). A lossless track plays in the DAC's integer format of its own depth: 16, 24 or 32 bit. If the DAC has no integer format of that depth, the format stays as before. It replaces "Bit depth match"; that old setting is not carried over.

New: mute and software volume for DACs with fixed output. On a DAC with no volume control, mute now gives silence (before, it did nothing). The option Software volume (Advanced, off by default) lets the volume keys scale the output on such a DAC. At the top of the slider the output is still bit-perfect; below it the Bit-perfect check says "Software volume -N dB". The option is shown and applied only while the DAC has no volume of its own, so a DAC with hardware volume is never scaled. With the option off, the first volume key press shows a one-time notice.

New: Advanced > DAC Info. Shows the DAC's PCM bit depths and sample rates. In Exclusive Mode it shows the real DAC, not the Nativerate device.

Changed: the menu. Sections (status, Output, Settings), SF Symbols, sentence case, VoiceOver labels. The menu-bar icon is now a speaker, filled while Exclusive Mode is on. "Virtual Output Device" is now Settings > Advanced > Exclusive Mode driver.

Fixed: lip sync for other apps. Nativerate now reports the real delay of the path that video apps use, so their picture and sound stay in sync, with Exclusive Mode engaged or released.

Updating from 0.1.4: quit Nativerate and replace the app. There is no driver update this time (the driver stays at 1.2.1). macOS asks for Microphone access again because this is a new unsigned copy.

Installing fresh: unzip to ~/Applications, right-click Nativerate > Open the first time (ad-hoc signed, not notarized), then use Install Exclusive Mode driver… in its menu. Allow Microphone and Automation. Full steps are in the README.

If something goes wrong: menu About Nativerate > Export logs… and attach the zip to an issue.

SHA-256 of Nativerate-0.1.5.zip: e87a067d231d9a8eade506778c9bace0ede339129c2496ceddc0374da1a0ce78

Nativerate 0.1.4

Choose a tag to compare

@dizzysound dizzysound released this 04 Oct 23:01
d9b7653

A small update to Nativerate 0.1.3, with two fixes to the Bit-Perfect Check's reading of the source's bit depth.

Fixed: Music no longer gets blamed for macOS 26's rounding of 24-bit tracks. On macOS 26, Music's samples arrive scaled by about 0.99999997, within 1.5 steps of a 24-bit value. Nativerate already allowed for this on 16-bit tracks, but on 24-bit tracks the Bit-Perfect Check said "Music is changing the samples: volume, Sound Check or EQ" with all of them off, and 24-bit Apple Lossless files on disk could show as lossy. It now shows "24 bit", rounded in the playback path and not bit-exact. A real level change, even -0.01 dB, is still caught. macOS 27 passes Music's samples through unchanged.

Fixed: a rate switch no longer spoils the depth reading of the next track. The first measurement after a sample-rate switch could include the switch itself, so a bit-exact track that followed one read "neither 16 nor 24 bit" and the Check again blamed Music.

Updating from 0.1.3: quit Nativerate and replace the app. There is no driver update this time (the driver stays at 1.2.1). macOS asks for Microphone access again because this is a new unsigned copy.

Installing fresh: unzip to ~/Applications, right-click Nativerate > Open the first time (ad-hoc signed, not notarized), then use Install Exclusive Mode Driver… in its menu. Allow Microphone and Automation. Full steps are in the README.

If something goes wrong: menu About > Export Logs… and attach the zip to an issue.

SHA-256 of Nativerate-0.1.4.zip: 53008ce46a2be09c8359997b394195738dec458227379897c14dd61588126eba

Nativerate 0.1.3

Choose a tag to compare

@dizzysound dizzysound released this 04 Oct 01:50
2080122

A small update to Nativerate 0.1.2, with two fixes to sample-rate switching in Exclusive Mode.

Fixed: a pause during a rate switch stays a pause. If you paused Music while Nativerate was switching the DAC's sample rate, the switch started Music playing again. Now the rate still switches, and Music stays paused.

Fixed: a rate switch no longer skips the start of the new track. When the next track needed a different sample rate, its first 0.15-0.5 s never reached the DAC. The switch now restarts the track from its true beginning.

Updating from 0.1.2: quit Nativerate and replace the app. There is no driver update this time (the driver stays at 1.2.1). macOS asks for Microphone access again because this is a new unsigned copy.

Installing fresh: unzip to ~/Applications, right-click Nativerate > Open the first time (ad-hoc signed, not notarized), then use Install Exclusive Mode Driver… in its menu. Allow Microphone and Automation. Full steps are in the README.

If something goes wrong: menu About > Export Logs… and attach the zip to an issue.

SHA-256 of Nativerate-0.1.3.zip: e00274578460e25627a87d9289ca2cfa5efad4e103a520d1bb373b27e6076dce