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
70 changes: 70 additions & 0 deletions .github/workflows/p1-windows.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,70 @@
name: Windows Native VST3 Host
on:
push:
branches: [ main, feature/p1-first-sound-windows, feature/p2-native-vst-catalog-fx-rack, feature/p2-daw-workflow-progress, fix/p2-native-output-monitor-diagnostics, fix/p2-realtime-glitch-telemetry-latest-gui, fix/p2-truthful-meter-pan-fx-toggle, feature/p2-native-state-presets, fix/p2-fabfilter-add-workflow, feature/p25-live-preset-graph-swap, integration/p25-gui-engine-reconciled, integration/main-v08-gui-p25-native ]
pull_request:
workflow_dispatch:

concurrency:
group: windows-vst3-${{ github.head_ref || github.ref_name }}
cancel-in-progress: true

permissions:
contents: read

jobs:
windows-build:
runs-on: windows-2022
timeout-minutes: 50
steps:
- uses: actions/checkout@v4
- name: Checkout JUCE 8 pinned
uses: actions/checkout@v4
with:
repository: juce-framework/JUCE
ref: 8.0.15
path: third_party/JUCE
- name: Install WebView2 SDK for JUCE
shell: pwsh
run: nuget install Microsoft.Web.WebView2 -Version 1.0.3485.44 -OutputDirectory .deps -NonInteractive
- name: Validate native UI JavaScript
shell: pwsh
run: |
node --check web/bridge.js
node --check web/monitor.js
node --check web/app.js
node --test tests/native_ui_contract_test.mjs
node --test tests/native_preset_contract_test.mjs
node --test tests/fx_add_contract_test.mjs
node --test tests/live_graph_contract_test.mjs
node --test tests/reconciled_gui_engine_contract_test.mjs
node --test tests/main_v08_native_integration_test.mjs
- name: Configure Windows x64
shell: pwsh
run: >
cmake -S . -B build -G "Visual Studio 17 2022" -A x64
-DJUCE_ROOT="${{ github.workspace }}/third_party/JUCE"
-DBUILD_TESTING=ON
-DJUCE_WEBVIEW2_PACKAGE_LOCATION="${{ github.workspace }}/.deps"
- name: Build executable and native RT tests
run: cmake --build build --config Release --target ARMixConsole ARMixRTTests ARMixPresetTests --parallel 2
- name: Test realtime control primitives
run: ctest --test-dir build -C Release --output-on-failure
- name: Package native executable
shell: pwsh
run: |
New-Item -ItemType Directory -Force -Path dist | Out-Null
$exe = Get-ChildItem -Path build -Filter "*.exe" -Recurse |
Where-Object { $_.Name -like "*AR*Mix*" -and $_.FullName -match 'Release' } |
Select-Object -First 1
if (-not $exe) { throw "ARMixConsole EXE not found" }
Copy-Item $exe.FullName "dist/ArSonMix-P2.5-GUI-v0.8-Native-Windows.exe"
Copy-Item README.md "dist/README.md"
"P2 experimental: audio routes automatically; use headphones at low level. Only Channel 1 is native. Other strips are inactive previews." |
Out-File -FilePath dist/FIRST_SOUND_README.txt -Encoding utf8
- uses: actions/upload-artifact@v4
with:
name: ArSonMix-P2.5-GUI-v0.8-Native-Windows-x64
path: dist/
if-no-files-found: error
retention-days: 14
3 changes: 3 additions & 0 deletions AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,3 +19,6 @@
2. Check current native PRs / base graph before cherry-picking; do not accidentally erase more recent GUI or engine work.
3. Propose and implement only the requested incremental changes, validate actual behavior, and capture new checkpoints if another GUI revision is approved.
4. Distinguish *GUI-preview simulation* from *live native audio* in reports and releases.

## Post-lock native integration update (PR #13, 2026-10-25)
The **experimental** P2.5 JUCE VST3 engine has now been integrated into `main` using the approved v0.8 GUI as its ancestor; it does not supersede the visual approval or certify audio. Archived stacked PRs and the v0.5 integration PR #11 remain as lineage, not a source for overwriting the GUI. Work on later engine phases starts from latest `main`, tests with both Windows MSVC and the GUI lock Chromium workflow, and preserves all locked visual geometry. Do not merge a stale P2.5 branch wholesale back into main.
2 changes: 2 additions & 0 deletions AR-MIX-Live-FX-Host-Standalone-v0.3.html
Original file line number Diff line number Diff line change
Expand Up @@ -982,6 +982,8 @@
});
document.addEventListener('keydown',e=>{if(e.ctrlKey&&e.key.toLowerCase()==='s'){e.preventDefault();if(persistSession())flash('UI state saved locally');else flash('Browser storage unavailable')}});
let lastMeterFrame=0;function meters(t){
// JUCE desktop reads actual audio meters; browser demo only animates a preview.
if(window.__JUCE__?.backend?.emitEvent)return;
requestAnimationFrame(meters);if(t-lastMeterFrame<33||document.hidden)return;lastMeterFrame=t;
channels.forEach((ch,i)=>{const wave=(Math.sin(t*.0022+i*1.92)+Math.sin(t*.0043+i*.6))*.5;
let v=clamp(45+wave*24+ch.fader*.48,4,98);if(ch.mute)v=2;updateMeterVisual(String(i),v,t)});
Expand Down
34 changes: 21 additions & 13 deletions CMakeLists.txt
Original file line number Diff line number Diff line change
@@ -1,44 +1,52 @@
cmake_minimum_required(VERSION 3.22)
project(ARMixConsole VERSION 0.3.0 LANGUAGES CXX)
project(ARMixConsole VERSION 0.5.0 LANGUAGES C CXX)
set(CMAKE_CXX_STANDARD 20)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

# Set JUCE_ROOT to the path of a local JUCE checkout. No downloads occur at runtime.
if (NOT DEFINED JUCE_ROOT)
message(FATAL_ERROR "Pass -DJUCE_ROOT=C:/path/to/JUCE (JUCE 8/9 checkout)")
message(FATAL_ERROR "Pass -DJUCE_ROOT=C:/path/to/JUCE (8.0.15+ required)")
endif()
add_subdirectory("${JUCE_ROOT}" "${CMAKE_BINARY_DIR}/juce")

juce_add_gui_app(ARMixConsole
PRODUCT_NAME "AR MIX Console"
PRODUCT_NAME "AR MIX Studio"
COMPANY_NAME "AR MIX Open Source"
BUNDLE_ID "org.armix.studio"
NEEDS_WEB_BROWSER TRUE
NEEDS_WEBVIEW2 TRUE
NEEDS_CURL FALSE)

juce_add_binary_data(ARMixAssets
SOURCES
web/index.html
web/styles.css
web/app.js)
juce_add_binary_data(ARMixAssets SOURCES
web/index.html web/styles.css web/app.js web/bridge.js web/monitor.js)

target_sources(ARMixConsole PRIVATE src/Main.cpp)
target_sources(ARMixConsole PRIVATE src/Main.cpp src/LiveAudioEngine.h src/PluginCatalog.h src/DiagnosticsRecorder.h src/StereoPan.h src/NativePresetArchive.h src/VstBusLayout.h src/LiveGraphHandoff.h)
target_compile_definitions(ARMixConsole PRIVATE
JUCE_WEB_BROWSER=1
JUCE_USE_WIN_WEBVIEW2=1
JUCE_USE_CURL=0
JUCE_APPLICATION_NAME_STRING="AR MIX Console"
JUCE_APPLICATION_VERSION_STRING="0.3.0")
JUCE_ASIO=1
JUCE_PLUGINHOST_VST3=1
JUCE_APPLICATION_NAME_STRING="AR MIX Studio"
JUCE_APPLICATION_VERSION_STRING="0.5.0-p2")
target_link_libraries(ARMixConsole PRIVATE
ARMixAssets
juce::juce_gui_extra
juce::juce_audio_utils
juce::juce_audio_processors
juce::juce_cryptography
juce::juce_audio_devices
juce::juce_recommended_config_flags
juce::juce_recommended_warning_flags)

# Independent of JUCE; tests lock-free event and coalesced scalar contracts.
include(CTest)
if(BUILD_TESTING)
add_executable(ARMixRTTests tests/realtime_control_test.cpp)
target_compile_features(ARMixRTTests PRIVATE cxx_std_20)
add_test(NAME RealtimeControlPrimitives COMMAND ARMixRTTests)
juce_add_console_app(ARMixPresetTests PRODUCT_NAME "ArSonMix Native Preset Tests")
target_sources(ARMixPresetTests PRIVATE tests/native_preset_roundtrip_test.cpp src/NativePresetArchive.h)
target_link_libraries(ARMixPresetTests PRIVATE juce::juce_core juce::juce_cryptography
juce::juce_recommended_config_flags)
target_compile_features(ARMixPresetTests PRIVATE cxx_std_20)
add_test(NAME NativePresetZipRoundTrip COMMAND ARMixPresetTests)
endif()
8 changes: 4 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# ArSonMix — Live Mixer & VST3 Host

**Project status (25 October 2026):** the premium **GUI v0.8** has been visually approved and merged into `main`. The browser preview remains a **UI prototype with simulated audio/meters**. The native Windows/JUCE/VST3 engine is progressing separately through stacked draft PRs; those builds and hardware paths are **not** certified by the GUI merge.
**Project status (25 October 2026):** premium **GUI v0.8** is approved and locked in `main`. The P2.5 JUCE Windows/VST3 code is now integrated as an **experimental native-development baseline** via PR #13; this is not a hardware-qualified or stable audio release. The browser preview remains visual-only, with intentionally simulated meters.

> **GUI SOURCE OF TRUTH — LOCKED:** [GUI v0.8 baseline](docs/GUI_BASELINE_LOCK_2026-10-25.md) · approved commit `343692fc9b702661a8455cca30f0ffd108907324` · merged in [PR #2](https://github.com/masarray/arsonmix/pull/2) · preserved as `checkpoint/gui-v0.8-approved-20261025`. **Do not restore the previous GUI from native-engine branches.**

Expand Down Expand Up @@ -32,7 +32,7 @@ ArSonMix is a Windows-first digital mixer and low-latency live VST3 host project

**Start by reading [AGENTS.md](AGENTS.md) and [docs/GUI_BASELINE_LOCK_2026-10-25.md](docs/GUI_BASELINE_LOCK_2026-10-25.md).** The approved GUI is in `main`; do not use the historical GUI branch as the source for new designs. If working on native VST3, apply the engine to the new GUI contract rather than replacing `web/app.js`, `web/styles.css` or the standalone HTML with a stale copy.

The native PR chain [#1](https://github.com/masarray/arsonmix/pull/1), [#3–#10](https://github.com/masarray/arsonmix/pulls) and reconciliation PR [#11](https://github.com/masarray/arsonmix/pull/11) represent **separate in-progress engineering work**. Merge only after native build/test qualification, user hardware FAT and UI baseline parity; do not close these unfinished PRs just to tidy the issue list.
Native changes from the stacked PRs [#1](https://github.com/masarray/arsonmix/pull/1) and [#3–#10](https://github.com/masarray/arsonmix/pulls) are now incorporated into `main` through the reconciled integration [PR #13](https://github.com/masarray/arsonmix/pull/13). The earlier PRs remain as historical/review references; their code integration does **not** certify third-party VST3 stability or real-device audio. PR #11 contains older v0.5 visuals and must never override approved v0.8.

## Local preview and tests

Expand All @@ -52,9 +52,9 @@ The Chromium smoke test needs Playwright Chromium installed. `.github/workflows/

## Windows native host

`src/`, `engine/`, `CMakeLists.txt`, and `build_windows.ps1` in `main` are the original scaffold and reusable real-time primitives; evolving native versions are held in separate PR branches. Use Visual Studio 2022/CMake/JUCE and suitable ASIO/WASAPI drivers for native development. Browser-only UI acceptance is **not** proof of native VST3 load, FabFilter/RX compatibility, audio callback reliability, interop or full-fidelity plugin state.
`main` contains experimental JUCE C++20 ASIO/WASAPI **Channel 1** realtime audio, VST3 scanning/import/catalog, editor, FX bypass, FabFilter/RX-compatible layout, diagnostics, native `.armix` preset saving and P2.5 prepared-graph recall. It preserves GUI v0.8, while Channels 2–12 and Master FX/PAN remain non-native previews. The display does **not** claim measured BS.1770 LUFS-I or dBTP. Live recall uses a de-click fade (not seamless DSP crossfade), and ADD/REMOVE/REORDER still detach callback. FabFilter, iZotope RX, and other third-party plugins require Windows hardware FAT before a stable release. [Experimental Windows CI builds](https://github.com/masarray/arsonmix/actions/workflows/p1-windows.yml) provide artifacts from passing runs.

See the historical [architecture & roadmap](docs/ARD_AR_MIX_LIVE_FX_HOST_v0.3.md) and [GUI checkpoint](docs/GUI_BASELINE_LOCK_2026-10-25.md) for current precedence.
See the [architecture & roadmap](docs/ARD_AR_MIX_LIVE_FX_HOST_v0.3.md), [approved GUI v0.8 checkpoint](docs/GUI_BASELINE_LOCK_2026-10-25.md), and [cross-thread engine reconciliation](docs/PROGRESS_RECONCILIATION_2026-10-25.md). Native code follows GUI v0.8, not the opposite.

## License and assets

Expand Down
3 changes: 3 additions & 0 deletions docs/GUI_BASELINE_LOCK_2026-10-25.md
Original file line number Diff line number Diff line change
Expand Up @@ -50,3 +50,6 @@ Native stack PRs [#1](https://github.com/masarray/arsonmix/pull/1), [#3](https:/
4. Publish Pages from main and verify that deployed `build.json.sha` matches the **tested** commit (not a stale branch).

**Acceptance statement:** the owner said the GUI was already "rapi dan bagus" and requested this progress be locked and merged. These exact visuals and interactions are the default for every subsequent thread.

## Post-checkpoint native integration annotation
The approved visual checkpoint above is unchanged. After this lock, [PR #13](https://github.com/masarray/arsonmix/pull/13) integrates experimental P2.5 native JUCE audio into current `main` by preserving the exact v0.8 CSS/layout and only adding the native bridge, a browser-preview meter guard, and backend sources. This is **not** physical hardware FAT or a stable release. Older references to PR #11 being unfinished describe the prior pre-integration state. Future work starts from `main`; the historical `checkpoint/gui-v0.8-approved-20261025` branch remains recoverable.
Loading
Loading