Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@

**[Download the latest verified ArSonMix release](https://masarray.github.io/arsonmix/#download)** from the official landing page and choose your operating system. The Windows card always selects the newest verified public Windows installer; on Windows 10/11 x64, click **Download installer ZIP**, extract it, then run Setup. No GitHub account or visit to the GitHub Releases UI is needed.

**Latest published Windows alpha as of 17 November 2026:** [v0.5.0-alpha.24 — Download installer ZIP](https://github.com/masarray/arsonmix/releases/download/v0.5.0-alpha.24/ArSonMix-v0.5.0-alpha.24-Windows-x64-Setup.zip) · [portable ZIP](https://github.com/masarray/arsonmix/releases/download/v0.5.0-alpha.24/ArSonMix-v0.5.0-alpha.24-Windows-x64-Portable.zip) · [SHA-256 checksums](https://github.com/masarray/arsonmix/releases/download/v0.5.0-alpha.24/SHA256SUMS.txt) · [release notes](docs/releases/v0.5.0-alpha.24.md). These are pinned alpha.24 links; the official landing page resolves newer verified releases automatically.
**Latest published Windows alpha as of 17 November 2026:** [v0.5.0-alpha.25 — Download installer ZIP](https://github.com/masarray/arsonmix/releases/download/v0.5.0-alpha.25/ArSonMix-v0.5.0-alpha.25-Windows-x64-Setup.zip) · [portable ZIP](https://github.com/masarray/arsonmix/releases/download/v0.5.0-alpha.25/ArSonMix-v0.5.0-alpha.25-Windows-x64-Portable.zip) · [SHA-256 checksums](https://github.com/masarray/arsonmix/releases/download/v0.5.0-alpha.25/SHA256SUMS.txt) · [release notes](docs/releases/v0.5.0-alpha.25.md). These are pinned alpha.25 hotfix links; for future verified releases, use the official version-aware landing page.

The download cards show the newest verified package available for each platform, including its version and size. Windows previews are published independently of Linux and macOS builds, so their version numbers may differ.

Expand All @@ -28,7 +28,7 @@ The download cards show the newest verified package available for each platform,
- **Harmonice, Guitar FX, EQ & Compressor:** native effects with dedicated GUI controls, alongside supported VST3 parameter hotkeys and built-in user presets.
- **Live mixer & WIRE:** input channels, MAIN/BUS routing, gain, PRE/POST sends, mute/solo and Save/Open `.smix` sessions. ArSon Player remains part of the console workflow.

Only features included in the published alpha.24 source tag are described as released; unmerged Guitar FX redesign or other experimental branches are **not** shipped. See the [alpha.24 release notes](docs/releases/v0.5.0-alpha.24.md) for scope, source-distance migration behavior and testing limitations.
**Alpha.25 hotfix:** ImmerSIB now opens its real native JUCE concert window; switching to dearVR or other VST3 editor no longer closes the ImmerSIB window, and clicking the same insert refocuses it. False “Effect settings updated” editor-open toast is removed. No spatial DSP/preset changes. Existing alpha.24 features remain. Experimental Guitar FX redesign or unmerged branches are **not** shipped. See the [alpha.25 release notes](docs/releases/v0.5.0-alpha.25.md) and [alpha.24 baseline](docs/releases/v0.5.0-alpha.24.md) for compatibility and limitations.

## Get started

Expand Down
28 changes: 28 additions & 0 deletions docs/releases/v0.5.0-alpha.25.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,28 @@
# ArSonMix v0.5.0-alpha.25 — ImmerSIB native editor reopen hotfix (Windows public alpha)

**Scope:** Windows 10/11 x64 public alpha hotfix of the previously published [v0.5.0-alpha.24](https://github.com/masarray/arsonmix/releases/tag/v0.5.0-alpha.24). This release addresses JUCE **FX editor lifecycle and UI routing** only; its native SonKu and ImmerSIB audio processing, factory concert scenes, source-distance policy and session identity are unchanged. It is not a hardware-ASIO certification.

## Fixed in this release

- **ImmerSIB opens the real native concert editor.** Clicking the accepted ImmerSIB insert in FX Rack routes to the exact JUCE `routingFxEditor` instance on the authoritative ChannelId graph, not a generic settings-update notification or an unrelated 8D-SonKu WebView overlay.
- **ImmerSIB stays open while editing VST3 plugins.** ImmerSIB owns a separate mixer-owned native floating editor and a retained processor lease, independent of the ordinary VST3 editor window. Opening/closing dearVR PRO 2 or another VST3 does not dispose ImmerSIB's editor. Clicking the same ImmerSIB insert again raises/reopens the matching window.
- **No misleading successful-open toast.** A successful native editor open no longer generates a generic FX-settings success message. Rejected/stale editor requests continue to show a meaningful error.
- **Safe retirement.** On an actual graph/processor replacement, session load, FX deletion or shutdown, editors are destroyed before processor ownership is relinquished. The timer checks both independent leases; a stale window cannot masquerade as an active FX slot.

## Preserved from alpha.24

- Approved **8D-SonKu P9.9** orbit/venue sound and **ImmerSIB's seven concert scenes**, measured-HRTF/JUCE DSP, bypass power/ACK and existing source-distance limits (1.1–2.5 m, Early Room to 180%).
- Established WIRE/BUS/MAIN mixer routing, source/FX power behavior, Harmonice, Vocal Delay, Compressor, EQ, Guitar FX, VST3 hosting, ArSon Player and `.smix` persistence.
- Single authoritative native PCM graph, exact source SHA/release checksums, AGPL-3.0 license, MIT HRIR attribution, no unauthorized bundled VST3.

## Install and verify

Use the [official download page](https://masarray.github.io/arsonmix/#download) and ensure Windows shows **v0.5.0-alpha.25** before testing. Older development builds such as `v0.5.0-dev+g5c7455d4` and alpha.24 do **not** contain this GUI window-lifetime fix. Installer ZIP is preferred; extract and run Setup. Portable ZIP is available on [GitHub Releases](https://github.com/masarray/arsonmix/releases/tag/v0.5.0-alpha.25).

At a safe monitoring volume, load CH02 with dearVR PRO 2, Compressor and ImmerSIB. Click ImmerSIB → verify its JUCE concert editor appears; open the dearVR window → verify ImmerSIB remains open; refocus ImmerSIB → verify the original editor appears without false success toast. Repeat after hiding and reopening both windows, rack/slot/global bypass, and session Save/Open. Do not assume a click toast proves audio DSP is active.

## Verification and limitations

The source integration is [PR #742](https://github.com/masarray/arsonmix/pull/742). Source/runtime contracts, native Windows JUCE build, genuine editor/DPI tests, portable package verification and SonKu RC-OFF compatibility are required before public publication. The publisher independently rebuilds **exact pinned SHA** plus installer install/upgrade/uninstall and checksum assets; if it fails, no alpha.25 prerelease should appear.

Native/Chromium/Windows CI and editor-lifetime assertions are not a physical headphone/ASIO test. Report any plugin-window focus issues, acoustic changes, hardware dropouts or session restore failures with plugin version, OS, audio backend, sample rate, buffer size and reproduction steps using [GitHub Issues](https://github.com/masarray/arsonmix/issues). Keep private session backups and never overwrite an occupied session without saving a copy first.