Skip to content
Closed
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
14 changes: 9 additions & 5 deletions .github/workflows/p1-windows.yml
Original file line number Diff line number Diff line change
@@ -1,10 +1,14 @@
name: P1 Windows First Sound
name: Windows Native VST3 Host
on:
push:
branches: [ main, feature/p1-first-sound-windows ]
branches: [ main, feature/p1-first-sound-windows, feature/p2-native-vst-catalog-fx-rack ]
pull_request:
workflow_dispatch:

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

permissions:
contents: read

Expand Down Expand Up @@ -42,13 +46,13 @@ jobs:
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/AR-MIX-Studio-P1.exe"
Copy-Item $exe.FullName "dist/AR-MIX-Studio-P2.exe"
Copy-Item README.md "dist/README.md"
"P1 experimental: output muted until MONITOR ON; do not use during a public livestream without hardware tests." |
"P2 experimental: output muted until MONITOR ON; do not use during a public livestream without hardware tests." |
Out-File -FilePath dist/FIRST_SOUND_README.txt -Encoding utf8
- uses: actions/upload-artifact@v4
with:
name: AR-MIX-Studio-P1-Windows-x64
name: AR-MIX-Studio-P2-Windows-x64
path: dist/
if-no-files-found: error
retention-days: 14
6 changes: 3 additions & 3 deletions CMakeLists.txt
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
cmake_minimum_required(VERSION 3.22)
project(ARMixConsole VERSION 0.4.0 LANGUAGES C CXX)
project(ARMixConsole VERSION 0.5.0 LANGUAGES C CXX)
set(CMAKE_CXX_STANDARD 20)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

Expand All @@ -19,15 +19,15 @@ juce_add_gui_app(ARMixConsole
juce_add_binary_data(ARMixAssets SOURCES
web/index.html web/styles.css web/app.js web/bridge.js)

target_sources(ARMixConsole PRIVATE src/Main.cpp src/LiveAudioEngine.h)
target_sources(ARMixConsole PRIVATE src/Main.cpp src/LiveAudioEngine.h src/PluginCatalog.h)
target_compile_definitions(ARMixConsole PRIVATE
JUCE_WEB_BROWSER=1
JUCE_USE_WIN_WEBVIEW2=1
JUCE_USE_CURL=0
JUCE_ASIO=1
JUCE_PLUGINHOST_VST3=1
JUCE_APPLICATION_NAME_STRING="AR MIX Studio"
JUCE_APPLICATION_VERSION_STRING="0.4.0-p1")
JUCE_APPLICATION_VERSION_STRING="0.5.0-p2")
target_link_libraries(ARMixConsole PRIVATE
ARMixAssets
juce::juce_gui_extra
Expand Down
6 changes: 6 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -52,3 +52,9 @@ Code in this trial is authored for the project and provided under AGPL-3.0-only
The new P1 native EXE provides actual microphone passthrough through one VST3 effect, ASIO/WASAPI device selector, bypass, monitor arm/mute, master gain and real callback meter. The old FX rack and channels 2–12 are **still UI previews** (do not confuse demo plugin inserts with native VST3). Output starts muted for hearing/feedback safety. See [P1 trial instructions](docs/P1_FIRST_SOUND.md).

GitHub Actions: [Windows First Sound builds](https://github.com/masarray/arsonmix/actions/workflows/p1-windows.yml). Download the artifact only after the run is GREEN. JUCE 8.0.15 is pinned by CI and includes GPLv3 ASIO SDK sources; this repository uses AGPLv3. Plugin compatibility and low latency must still be verified with real hardware.

## P2 Native VST3 Catalog and FX Rack

The native Windows host supports **Scan VST3**, **Add Plugin Folder**, **Import VST3** and a persistent plugin catalog in user app-data. The FX Rack inside WebView2 now controls the **one native stereo audio path** with up to 8 real VST3 effects: add, bypass, reorder, remove and open plugin UI. The Windows audio setup dialog is also native, with saved device configuration.

All remaining UI preview channels and factory vocal presets are still visual; do not infer that they are running live audio. Legacy VST2 `.dll` is **not** supported or automatically treated as VST3. Plugin scanning uses a worker, but not yet a crash-isolated subprocess; avoid unknown plugins during a livestream. Read [P2 Hardware Trial](docs/P2_NATIVE_FX_RACK.md).
37 changes: 37 additions & 0 deletions docs/P2_NATIVE_FX_RACK.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,37 @@
# AR MIX Studio P2 — Native VST3 Catalog and FX Rack (Experimental)

## Try on Windows
1. Open the GitHub Actions build artifact `AR-MIX-Studio-P2-Windows-x64` from the successful workflow.
2. Unzip, open `AR-MIX-Studio-P2.exe`. Audio monitoring is OFF at startup.
3. In **SETUP**, choose **OPEN ASIO / WASAPI DEVICE SETTINGS**, select an input+output interface, 48 kHz, and 128/256 samples to start.
4. In **FX RACK**, click **RESCAN VST3** to search system VST3 locations, **ADD PLUGIN FOLDER** for an additional installation directory, or **IMPORT VST3 FILE** for an individual `.vst3` file/bundle.
5. Results appear in the persistent native catalog. Search by plugin name or vendor. Click **+ ADD** to insert the plugin into the actual audio chain. Repeat up to 8 plugins.
6. **EDIT** opens the plugin's native UI; **ON/OFF** bypasses; arrows change order; **×** removes. Changes pause the callback briefly, so do not perform them on-air.
7. With headphones and low hardware volume, click **MONITOR ON**. Confirm audible change between plugin ON/OFF and watch real input/master meters.

## What P2 actually implements
- Windows ASIO/WASAPI using JUCE AudioDeviceManager and native selector.
- Settings persisted to user app-data `AR-MIX-Studio/audio-devices.xml`.
- Native VST3 catalog persisted to `AR-MIX-Studio/plugin-catalog.json`.
- Recursive scan of default/custom folders, direct import of one `.vst3` file/bundle, cached display between sessions.
- Single live microphone/stereo audio path with maximum eight native VST3 inserts, native plugin UI, order, bypass, removal.
- Low-allocation host callback. UI and scanning are outside the callback.

## Explicit exclusions / safety
- **VST2 DLL** is not a VST3 module; raw DLL import is intentionally rejected. VST2 would require a separate, vetted SDK/licensing strategy.
- **Scanning is on a worker thread, not a crash-isolated subprocess**. Broken plugins may still crash or hang the host. This is experimental.
- The other 11 mixer channels and their visual presets are still a concept. Native FX chain applies only to channel 1.
- Real plugin state preset/save/restore, sidechain routing, bridge to OBS and round-trip measurement are not finished.
- VST3 processBlock code belongs to third-party plugins. Host-side callback design alone cannot guarantee zero allocations, x-runs or crashes.
- Plugins that do not support stereo effect layout may be rejected. Missing/invalid libraries are reported to the user.
- Do not infer audio reliability from successful GitHub Actions compilation. Validate with ASIO and WASAPI on physical hardware.

## Acceptance
- GitHub Actions release x64 build GREEN and artifact uploaded.
- Scan actual VST3 installation, catalog populated and survives restart.
- Add/remove/bypass/edit/reorder two real plugins and verify audible routing.
- Save/restart audio device settings and verify the same device is selected.
- Test repeatedly with headphones, 48 kHz / 128 samples then 64 only after stable result.

## Live-safe P2 operations
Bypass toggles are atomic and do not detach the audio callback. Scanning plugins and add/remove/reorder are refused when monitoring is enabled, so the singer cannot accidentally force an audio callback restart while live. Turn MONITOR OFF to edit chain structure, then arm monitoring again. The VST3 code itself is third-party; test carefully.
Loading
Loading