From 9cfda7174c8e19f9adfd0da9dc8b2ce60fb3d320 Mon Sep 17 00:00:00 2001 From: Ari Sulistiono Date: Sun, 1 Nov 2026 11:07:34 +0700 Subject: [PATCH 01/12] release(windows): Inno installer with per-user/all-users VST3 paths and uninstall --- packaging/windows/ArSonComp.iss | 79 +++++++++++++++++++++++++++++++++ 1 file changed, 79 insertions(+) create mode 100644 packaging/windows/ArSonComp.iss diff --git a/packaging/windows/ArSonComp.iss b/packaging/windows/ArSonComp.iss new file mode 100644 index 0000000..34339d3 --- /dev/null +++ b/packaging/windows/ArSonComp.iss @@ -0,0 +1,79 @@ +; ArSonComp Windows x64 Inno Setup installer +; Build: ISCC.exe /DStageDir="C:\stage" /DAppVersion="0.2.0" packaging\windows\ArSonComp.iss +#ifndef StageDir + #error StageDir must point to the built stage (VST3, Standalone, LICENSE, START-HERE.md) +#endif +#ifndef AppVersion + #define AppVersion "0.2.0" +#endif +[Setup] +AppId=ArSonComp-ArSonAudio +AppName=ArSonComp +AppVersion={#AppVersion} +AppPublisher=ArSon Audio +AppPublisherURL=https://github.com/masarray/arson-comp +AppSupportURL=https://github.com/masarray/arson-comp/issues +AppUpdatesURL=https://github.com/masarray/arson-comp/releases +DefaultDirName={autopf}\ArSon Audio\ArSonComp +DefaultGroupName=ArSon Audio +OutputBaseFilename=ArSonComp-{#AppVersion}-Windows-x64-Setup +OutputDir=. +ArchitecturesAllowed=x64compatible +ArchitecturesInstallIn64BitMode=x64compatible +PrivilegesRequired=lowest +PrivilegesRequiredOverridesAllowed=dialog +UsePreviousPrivileges=yes +DisableDirPage=yes +DisableProgramGroupPage=yes +Compression=lzma2 +SolidCompression=yes +WizardStyle=modern +UninstallDisplayName=ArSonComp +CloseApplications=yes +RestartApplications=no +LicenseFile={#StageDir}\LICENSE +SetupLogging=yes +MinVersion=10.0 +[Types] +Name: "full"; Description: "Recommended: VST3 plug-in + Standalone" +Name: "plugin"; Description: "VST3 plug-in only" +Name: "custom"; Description: "Custom installation"; Flags: iscustom +[Components] +Name: "vst3"; Description: "VST3 plug-in for DAWs and mixers"; Types: full plugin custom +Name: "standalone"; Description: "Standalone audio application"; Types: full custom +[Tasks] +Name: "desktopicon"; Description: "Create desktop shortcut"; GroupDescription: "Shortcuts:"; Components: standalone; Flags: unchecked +[Files] +Source: "{#StageDir}\VST3\ArSonComp.vst3\*"; DestDir: "{code:GetPluginFolder}\ArSonComp.vst3"; Components: vst3; Flags: ignoreversion recursesubdirs createallsubdirs +Source: "{#StageDir}\Standalone\ArSonComp.exe"; DestDir: "{app}"; Components: standalone; Flags: ignoreversion +Source: "{#StageDir}\START-HERE.md"; DestDir: "{app}"; Flags: ignoreversion +Source: "{#StageDir}\LICENSE"; DestDir: "{app}"; Flags: ignoreversion +[Icons] +Name: "{autoprograms}\ArSonComp"; Filename: "{app}\ArSonComp.exe"; Components: standalone +Name: "{autodesktop}\ArSonComp"; Filename: "{app}\ArSonComp.exe"; Components: standalone; Tasks: desktopicon +[Run] +Filename: "{app}\ArSonComp.exe"; Description: "Launch ArSonComp"; Flags: postinstall nowait skipifsilent unchecked; Components: standalone +[Code] +function GetPluginFolder(Param: String): String; +begin + if IsAdminInstallMode then + Result := ExpandConstant('{commoncf}\VST3') + else + Result := ExpandConstant('{localappdata}\Programs\Common\VST3'); +end; +procedure CurStepChanged(CurStep: TSetupStep); +var + OtherPlugin: String; +begin + if (CurStep <> ssPostInstall) or not WizardIsComponentSelected('vst3') then + Exit; + if IsAdminInstallMode then + OtherPlugin := ExpandConstant('{localappdata}\Programs\Common\VST3\ArSonComp.vst3') + else + OtherPlugin := ExpandConstant('{commoncf}\VST3\ArSonComp.vst3'); + if DirExists(OtherPlugin) then + MsgBox('Another ArSonComp VST3 also exists in:' + #13#10 + OtherPlugin + + #13#10#13#10 + 'Some DAWs may load that copy first. Remove the older copy.' + + #13#10 + 'Restart or rescan your DAW after installing.', + mbInformation, MB_OK); +end; From 0fd1ed79d7fb7e9b5bc1f72785e23ba0305ff906 Mon Sep 17 00:00:00 2001 From: Ari Sulistiono Date: Sun, 1 Nov 2026 11:08:05 +0700 Subject: [PATCH 02/12] release: add packaging/linux/install.sh --- packaging/linux/install.sh | 30 ++++++++++++++++++++++++++++++ 1 file changed, 30 insertions(+) create mode 100644 packaging/linux/install.sh diff --git a/packaging/linux/install.sh b/packaging/linux/install.sh new file mode 100644 index 0000000..53b9144 --- /dev/null +++ b/packaging/linux/install.sh @@ -0,0 +1,30 @@ +#!/usr/bin/env bash +# Safe current-user installer. No sudo, no host-specific custom folder. +set -euo pipefail +ROOT="$(cd "$(dirname "$0")" && pwd)" +if [[ "$(uname -s)" != "Linux" ]]; then echo "Linux only" >&2; exit 2; fi +if [[ ! -d "$ROOT/VST3/ArSonComp.vst3" || ! -f "$ROOT/Standalone/ArSonComp" ]]; then + echo "Incomplete archive: missing VST3 or Standalone" >&2; exit 3 +fi +DEST="$HOME/.vst3/ArSonComp.vst3" +APPDIR="$HOME/.local/opt/arsoncomp" +BIN="$HOME/.local/bin/arsoncomp" +DESKTOP="$HOME/.local/share/applications/arsoncomp.desktop" +if [[ -L "$DEST" || -L "$APPDIR" ]]; then + echo "Refusing to overwrite a symlinked install path." >&2; exit 4 +fi +mkdir -p "$HOME/.vst3" "$APPDIR" "$(dirname "$BIN")" "$(dirname "$DESKTOP")" +if [[ -d "$DEST" ]]; then + mv "$DEST" "$DEST.backup.$(date +%s)" +fi +cp -a "$ROOT/VST3/ArSonComp.vst3" "$DEST" +install -m 755 "$ROOT/Standalone/ArSonComp" "$APPDIR/ArSonComp" +cat > "$BIN" <<'EOF' +#!/bin/sh +exec "$HOME/.local/opt/arsoncomp/ArSonComp" "$@" +EOF +chmod 755 "$BIN" +printf '[Desktop Entry]\nName=ArSonComp\nComment=Real-time dynamics compressor\nExec="%s"\nType=Application\nCategories=AudioVideo;Audio;\nTerminal=false\n' "$BIN" > "$DESKTOP" +echo "Installed VST3: $DEST" +echo "Installed Standalone: $APPDIR/ArSonComp" +echo "Launch via application menu or $BIN; rescan/restart your DAW." From b6da33e9aa41523a9d1e28a05e6776ef9486c86b Mon Sep 17 00:00:00 2001 From: Ari Sulistiono Date: Sun, 1 Nov 2026 11:08:10 +0700 Subject: [PATCH 03/12] release: add packaging/linux/uninstall.sh --- packaging/linux/uninstall.sh | 10 ++++++++++ 1 file changed, 10 insertions(+) create mode 100644 packaging/linux/uninstall.sh diff --git a/packaging/linux/uninstall.sh b/packaging/linux/uninstall.sh new file mode 100644 index 0000000..aac36d6 --- /dev/null +++ b/packaging/linux/uninstall.sh @@ -0,0 +1,10 @@ +#!/usr/bin/env bash +set -euo pipefail +DEST="$HOME/.vst3/ArSonComp.vst3" +APPDIR="$HOME/.local/opt/arsoncomp" +if [[ -L "$DEST" || -L "$APPDIR" ]]; then + echo "Refusing to follow symlinks." >&2; exit 2 +fi +rm -rf -- "$DEST" "$APPDIR" +rm -f -- "$HOME/.local/bin/arsoncomp" "$HOME/.local/share/applications/arsoncomp.desktop" +echo "Removed ArSonComp for the current user. Presets and backups preserved." From 406c043e26763551e7fc9d2f488847fe86f071da Mon Sep 17 00:00:00 2001 From: Ari Sulistiono Date: Sun, 1 Nov 2026 11:08:15 +0700 Subject: [PATCH 04/12] release: add packaging/linux/package.sh --- packaging/linux/package.sh | 52 ++++++++++++++++++++++++++++++++++++++ 1 file changed, 52 insertions(+) create mode 100644 packaging/linux/package.sh diff --git a/packaging/linux/package.sh b/packaging/linux/package.sh new file mode 100644 index 0000000..e8f5186 --- /dev/null +++ b/packaging/linux/package.sh @@ -0,0 +1,52 @@ +#!/usr/bin/env bash +set -euo pipefail +BUILD="$(cd "$1" && pwd)" +OUT="$(mkdir -p "$2" && cd "$2" && pwd)" +VER="$3" +VST="$BUILD/ArSonComp_artefacts/Release/VST3/ArSonComp.vst3" +APP="$BUILD/ArSonComp_artefacts/Release/Standalone/ArSonComp" +test -d "$VST" && test -f "$APP" +WORK="$(mktemp -d)" +trap 'rm -rf "$WORK"' EXIT +STAGE="$WORK/stage/ArSonComp" +mkdir -p "$STAGE/VST3" "$STAGE/Standalone" +cp -a "$VST" "$STAGE/VST3/" +install -m 755 "$APP" "$STAGE/Standalone/ArSonComp" +cp packaging/linux/install.sh packaging/linux/uninstall.sh "$STAGE/" +chmod 755 "$STAGE"/*.sh +cp LICENSE "$STAGE/LICENSE" +cp docs/INSTALL-PUBLIC.md "$STAGE/START-HERE.md" +tar -C "$WORK/stage" -czf "$OUT/ArSonComp-$VER-Linux-x86_64-Portable.tar.gz" ArSonComp +PKG="$WORK/deb" +mkdir -p "$PKG/DEBIAN" "$PKG/usr/lib/vst3" "$PKG/opt/arsoncomp" \ + "$PKG/usr/bin" "$PKG/usr/share/applications" "$PKG/usr/share/doc/arsoncomp" +cp -a "$VST" "$PKG/usr/lib/vst3/" +install -m 755 "$APP" "$PKG/opt/arsoncomp/ArSonComp" +cat > "$PKG/usr/bin/arsoncomp" <<'EOF' +#!/bin/sh +exec /opt/arsoncomp/ArSonComp "$@" +EOF +chmod 755 "$PKG/usr/bin/arsoncomp" +cat > "$PKG/usr/share/applications/arsoncomp.desktop" <<'EOF' +[Desktop Entry] +Name=ArSonComp +Comment=Real-time audio dynamics compressor +Exec=arsoncomp +Type=Application +Categories=AudioVideo;Audio; +Terminal=false +EOF +cp LICENSE "$PKG/usr/share/doc/arsoncomp/LICENSE" +cp docs/INSTALL-PUBLIC.md "$PKG/usr/share/doc/arsoncomp/START-HERE.md" +cat > "$PKG/DEBIAN/control" < +Description: ArSonComp real-time compressor VST3 and Standalone + Native x86_64 VST3 plug-in and desktop application. +EOF +dpkg-deb --root-owner-group --build "$PKG" "$OUT/ArSonComp-$VER-Ubuntu-Debian-amd64.deb" +echo "Linux packages ready: $OUT" From 996361ba2c2229cacae73d953cb98d90643bbb7f Mon Sep 17 00:00:00 2001 From: Ari Sulistiono Date: Sun, 1 Nov 2026 11:08:19 +0700 Subject: [PATCH 05/12] release: add packaging/macos/package.sh --- packaging/macos/package.sh | 36 ++++++++++++++++++++++++++++++++++++ 1 file changed, 36 insertions(+) create mode 100644 packaging/macos/package.sh diff --git a/packaging/macos/package.sh b/packaging/macos/package.sh new file mode 100644 index 0000000..fa7a4aa --- /dev/null +++ b/packaging/macos/package.sh @@ -0,0 +1,36 @@ +#!/usr/bin/env bash +set -euo pipefail +BUILD="$(cd "$1" && pwd)" +OUT="$(mkdir -p "$2" && cd "$2" && pwd)" +VER="$3" +VST="$BUILD/ArSonComp_artefacts/Release/VST3/ArSonComp.vst3" +APP="$BUILD/ArSonComp_artefacts/Release/Standalone/ArSonComp.app" +test -d "$VST" && test -d "$APP" +WORK="$(mktemp -d)" +trap 'rm -rf "$WORK"' EXIT +ROOT="$WORK/pkgroot" +mkdir -p "$ROOT/Library/Audio/Plug-Ins/VST3" "$ROOT/Applications" +ditto "$VST" "$ROOT/Library/Audio/Plug-Ins/VST3/ArSonComp.vst3" +ditto "$APP" "$ROOT/Applications/ArSonComp.app" +# Ad-hoc sign top-level bundles individually; no deep signing. +# Not Developer ID / notarized: Gatekeeper can still block public installs. +for bundle in "$ROOT/Library/Audio/Plug-Ins/VST3/ArSonComp.vst3" \ + "$ROOT/Applications/ArSonComp.app"; do + codesign --force --sign - --timestamp=none "$bundle" + codesign --verify --verbose=2 "$bundle" +done +BIN="$ROOT/Applications/ArSonComp.app/Contents/MacOS/ArSonComp" +test -f "$BIN" +ARCHS="$(lipo -archs "$BIN")" +echo "Mac architectures: $ARCHS" +case "$ARCHS" in + *arm64*x86_64*|*x86_64*arm64*) ;; + *) echo "Expected universal arm64 + x86_64 binary" >&2; exit 7 ;; +esac +pkgbuild --root "$ROOT" --install-location / \ + --identifier com.arsonaudio.comp.installer --version "$VER" \ + "$OUT/ArSonComp-$VER-macOS-Universal-AdHoc.pkg" +ditto -c -k --sequesterRsrc --keepParent \ + "$ROOT/Library/Audio/Plug-Ins/VST3/ArSonComp.vst3" \ + "$OUT/ArSonComp-$VER-macOS-VST3-Universal.zip" +echo "Unsigned installer / ad-hoc signed plugin and Standalone are packaged." From faa3b4d714920e09fc92ef2d375ed8a13c80d3c6 Mon Sep 17 00:00:00 2001 From: Ari Sulistiono Date: Sun, 1 Nov 2026 11:08:41 +0700 Subject: [PATCH 06/12] docs(release): platform installers and safe novice-facing instructions --- docs/INSTALL-PUBLIC.md | 59 ++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 59 insertions(+) create mode 100644 docs/INSTALL-PUBLIC.md diff --git a/docs/INSTALL-PUBLIC.md b/docs/INSTALL-PUBLIC.md new file mode 100644 index 0000000..d5355f8 --- /dev/null +++ b/docs/INSTALL-PUBLIC.md @@ -0,0 +1,59 @@ +# ArSonComp — simple public installers + +Choose the file matching your operating system on +https://github.com/masarray/arson-comp/releases. +You do NOT need to move individual VST3 DLLs or browse random plug-in paths. + +## Windows 10/11 x64 +Double-click **ArSonComp-...-Windows-x64-Setup.exe**. +Default: install VST3 + Standalone. Choose **current user** to avoid UAC +or **all users** if you want every Windows account to use ArSonComp. +The guided installer uses Steinberg's official Windows VST3 paths, +registers an uninstaller, and adds a Start Menu shortcut for Standalone. +Restart or rescan your DAW. If you installed ArSonComp in the *other* +scope previously, remove that duplicate; the installer warns about it. + +## Ubuntu/Debian x86_64 +Double-click **ArSonComp-...-Ubuntu-Debian-amd64.deb** and confirm in +Software Center / App Center. A terminal alternative is: + sudo apt install ./ArSonComp-*-Ubuntu-Debian-amd64.deb +This installs VST3 in /usr/lib/vst3 and the application in your launcher. +Uninstall using your software manager or: sudo apt remove arsoncomp. + +## Other x86_64 Linux +Extract **Linux-x86_64-Portable.tar.gz**. In its ArSonComp folder +run **bash install.sh**. No sudo is required; the VST3 is placed in ~/.vst3 +and the Standalone gets an application-menu entry. +Run **bash uninstall.sh** from the extracted folder to uninstall. +This targets modern glibc-based Linux distributions, not musl/Alpine. + +## macOS 11+ — Apple Silicon and Intel +Open **macOS-Universal-AdHoc.pkg**. The macOS Installer places VST3 in +/Library/Audio/Plug-Ins/VST3 and the Standalone in /Applications. +The VST3 and app use **ad-hoc signatures**, and this PKG is unsigned and +NOT Apple notarized. macOS Gatekeeper can warn or block installation. +For a trusted official download only, Finder > right click > Open or +System Settings > Privacy & Security > Open Anyway may allow it. +Do not disable Gatekeeper globally. A Developer ID certificate and Apple +notarization are needed for a truly frictionless public Mac installer. +A VST3-only universal ZIP is provided as a fallback for experienced users. + +## First use on any OS +Restart/rescan your VST3 host. Find ArSonComp under dynamics/compressor. +For Standalone, choose the actual audio input/output in Audio Settings. +Start at 48 kHz / 128 samples, low headphone volume, and use a +reasonable Clean vocal setting before lowering the buffer. +The plugin's zero *algorithmic* sample delay is not zero driver or +hardware-monitoring round-trip latency. + +## Reliability and distribution notes +Automated CI proves successful builds and in-process tests only, not +physical interface reliability, multi-host certification, or sonic +parity with commercial compressors. Use Windows START-HERE and the +M7 field-test checklist for the Maono PS22 / ASIO hardware gate. +For open-source distribution, keep AGPL source accessible and review +JUCE AGPL/commercial terms plus Steinberg ASIO SDK redistribution +requirements before labeling a distribution production-stable. + +Official VST3 standard installation locations: +https://steinbergmedia.github.io/vst3_dev_portal/pages/Technical%2BDocumentation/Locations%2BFormat/Plugin%2BLocations.html From c64a75a35a502ab4147003bb627d8f870ba861dd Mon Sep 17 00:00:00 2001 From: Ari Sulistiono Date: Sun, 1 Nov 2026 11:09:52 +0700 Subject: [PATCH 07/12] ci(release): verified Windows Inno, Linux DEB, macOS universal ad-hoc and gated GitHub Release --- .github/workflows/release-installers.yml | 162 +++++++++++++++++++++++ 1 file changed, 162 insertions(+) create mode 100644 .github/workflows/release-installers.yml diff --git a/.github/workflows/release-installers.yml b/.github/workflows/release-installers.yml new file mode 100644 index 0000000..190c56e --- /dev/null +++ b/.github/workflows/release-installers.yml @@ -0,0 +1,162 @@ +name: Build public installers +on: + pull_request: + paths: ['CMakeLists.txt', 'packaging/**', 'docs/INSTALL-PUBLIC.md', '.github/workflows/release-installers.yml'] + push: + branches: [main] + paths: ['CMakeLists.txt', 'packaging/**', 'docs/INSTALL-PUBLIC.md', '.github/workflows/release-installers.yml'] + workflow_dispatch: + inputs: + publish: + type: boolean + description: Publish checked installers to GitHub Releases + default: false + stable: + type: boolean + description: Stable requires ARSON_STABLE_APPROVED=yes repository variable + default: false +permissions: + contents: read +concurrency: + group: arsoncomp-packages-${{ github.ref }} + cancel-in-progress: true +env: + RELEASE_VERSION: 0.2.0 +jobs: + windows: + runs-on: windows-latest + steps: + - uses: actions/checkout@v4 + - uses: actions/cache@v4 + with: + path: build/_deps/juce-src + key: arson-juce-8.0.12-windows + - name: Build and run all Windows tests + shell: pwsh + run: | + cmake -S . -B build -A x64 -DCMAKE_BUILD_TYPE=Release + cmake --build build --config Release --parallel 4 + ctest --test-dir build -C Release --output-on-failure + - name: Compile Inno installer + shell: pwsh + run: | + $ErrorActionPreference = 'Stop' + $stage = Join-Path $pwd 'dist\stage' + $out = Join-Path $pwd 'dist\out' + New-Item -ItemType Directory -Force "$stage\VST3", "$stage\Standalone", $out | Out-Null + Copy-Item -Recurse 'build\ArSonComp_artefacts\Release\VST3\ArSonComp.vst3' "$stage\VST3\" + Copy-Item 'build\ArSonComp_artefacts\Release\Standalone\ArSonComp.exe' "$stage\Standalone\" + Copy-Item docs\INSTALL-PUBLIC.md "$stage\START-HERE.md" + Copy-Item LICENSE "$stage\LICENSE" + $iscc = Join-Path ([Environment]::GetFolderPath('ProgramFilesX86')) 'Inno Setup 6\ISCC.exe' + if (-not (Test-Path $iscc)) { choco install innosetup -y --no-progress } + if (-not (Test-Path $iscc)) { throw 'Inno Setup 6 was not found' } + & $iscc "/DStageDir=$stage" "/DAppVersion=$env:RELEASE_VERSION" "/O$out" "packaging\windows\ArSonComp.iss" + if ($LASTEXITCODE -ne 0) { throw "ISCC exit $LASTEXITCODE" } + if (@(Get-ChildItem "$out\*.exe").Count -ne 1) { throw 'Missing installer EXE' } + - uses: actions/upload-artifact@v4 + with: + name: ArSonComp-Windows-Installer + path: dist/out/*.exe + if-no-files-found: error + linux: + runs-on: ubuntu-24.04 + steps: + - uses: actions/checkout@v4 + - name: Install JUCE prerequisites + run: | + sudo apt-get update -qq + sudo apt-get install -y --no-install-recommends \ + libasound2-dev libjack-jackd2-dev ladspa-sdk libfreetype-dev \ + libfontconfig1-dev libx11-dev libxcomposite-dev libxcursor-dev \ + libxext-dev libxinerama-dev libxrandr-dev libxrender-dev \ + libxi-dev libglu1-mesa-dev libgtk-3-dev xvfb + - uses: actions/cache@v4 + with: + path: build/_deps/juce-src + key: arson-juce-8.0.12-ubuntu24 + - name: Build, smoke-test and package Linux + run: | + cmake -S . -B build -DCMAKE_BUILD_TYPE=Release + cmake --build build --parallel 2 + xvfb-run -a ctest --test-dir build --output-on-failure + bash packaging/linux/package.sh build dist/out "$RELEASE_VERSION" + dpkg-deb --info "dist/out/ArSonComp-$RELEASE_VERSION-Ubuntu-Debian-amd64.deb" + tar -tzf "dist/out/ArSonComp-$RELEASE_VERSION-Linux-x86_64-Portable.tar.gz" | grep -F install.sh + - uses: actions/upload-artifact@v4 + with: + name: ArSonComp-Linux-Installers + path: dist/out/* + if-no-files-found: error + macos: + runs-on: macos-15 + steps: + - uses: actions/checkout@v4 + - uses: actions/cache@v4 + with: + path: build/_deps/juce-src + key: arson-juce-8.0.12-macos + - name: Universal build, test and ad-hoc package + run: | + cmake -S . -B build -DCMAKE_BUILD_TYPE=Release \ + -DCMAKE_OSX_DEPLOYMENT_TARGET=11.0 \ + '-DCMAKE_OSX_ARCHITECTURES=arm64;x86_64' + cmake --build build --parallel 3 + ctest --test-dir build --output-on-failure + bash packaging/macos/package.sh build dist/out "$RELEASE_VERSION" + test -s "dist/out/ArSonComp-$RELEASE_VERSION-macOS-Universal-AdHoc.pkg" + - uses: actions/upload-artifact@v4 + with: + name: ArSonComp-macOS-Installers + path: dist/out/* + if-no-files-found: error + publish: + needs: [windows, linux, macos] + if: >- + github.event_name == 'push' || + (github.event_name == 'workflow_dispatch' && inputs.publish) + runs-on: ubuntu-latest + permissions: + contents: write + steps: + - uses: actions/download-artifact@v4 + with: + pattern: ArSonComp-*-Installer* + path: dist + merge-multiple: true + - name: Publish only after all OS gates pass + shell: bash + env: + GH_TOKEN: ${{ github.token }} + GH_REPO: ${{ github.repository }} + STABLE_APPROVAL: ${{ vars.ARSON_STABLE_APPROVED }} + STABLE_REQUEST: ${{ inputs.stable }} + run: | + set -euo pipefail + shopt -s nullglob + files=(dist/*.exe dist/*.deb dist/*.tar.gz dist/*.pkg dist/*.zip) + if (( ${#files[@]} < 5 )); then + echo "Missing one or more platform installers"; exit 7 + fi + ( cd dist && sha256sum ./* > SHA256SUMS.txt ) + tag="v${RELEASE_VERSION}-rc.1" + flag="--prerelease" + if [[ "$STABLE_REQUEST" == "true" ]]; then + if [[ "$STABLE_APPROVAL" != "yes" ]]; then + echo "Stable requires repository variable ARSON_STABLE_APPROVED=yes"; exit 8 + fi + tag="v${RELEASE_VERSION}" + flag="" + fi + if gh release view "$tag" >/dev/null 2>&1; then + echo "Release already exists: $tag. Refusing to overwrite artifacts."; exit 9 + fi + cat > notes.md < Date: Sun, 1 Nov 2026 11:10:27 +0700 Subject: [PATCH 08/12] release: align CMakeLists.txt with v0.2.0 cross-platform candidate and real quality gates --- CMakeLists.txt | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/CMakeLists.txt b/CMakeLists.txt index b1b475f..eac78a8 100644 --- a/CMakeLists.txt +++ b/CMakeLists.txt @@ -1,5 +1,5 @@ cmake_minimum_required(VERSION 3.22) -project(ArSonComp VERSION 0.1.0 LANGUAGES CXX) +project(ArSonComp VERSION 0.2.0 LANGUAGES CXX) set(CMAKE_CXX_STANDARD 17) set(CMAKE_CXX_STANDARD_REQUIRED ON) option(ARSON_BUILD_PLUGIN "Build VST3 and standalone" ON) From 871e7f3553e6fcd4f8e16fd8fed1507295a2e867 Mon Sep 17 00:00:00 2001 From: Ari Sulistiono Date: Sun, 1 Nov 2026 11:10:29 +0700 Subject: [PATCH 09/12] release: align AGENTS.md with v0.2.0 cross-platform candidate and real quality gates --- AGENTS.md | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/AGENTS.md b/AGENTS.md index 3ab92de..edad8ed 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -30,3 +30,10 @@ - Keep the user-approved separate transparent horizontal silver ruler and round thumb; avoid fake light waves or diagonal specular backgrounds. Cache matte brushed grain only on resize. - Retain visual/native slider hit separation, caption clearances, host automation and LCD meter isolation. - A shipped Windows test artifact needs the actual screenshot set, QA inventory helper and an explicit physical-test checklist; no CI result proves PS22 xruns or commercial sonic parity. + +## Public installer release gate (v0.2) +- Rebuild VST3/Standalone and run actual plugin smoke on all three supported OS runners. Publish only if Windows Inno, Linux DEB+portable and macOS universal ad-hoc packages all pass. +- Inno defaults to user install and supports optional all-users UAC; install to Steinberg-standard VST3 locations, with uninstall and duplicate-scope detection. +- Linux package must provide a user-mode no-sudo option. macOS ad-hoc is **not** Apple Developer ID signing or notarization. Do not instruct users to disable Gatekeeper globally. +- Do not describe a CI-only artifact as hardware-certified stable. Promote the public RC to stable only after license and DAW/interface tests are documented and ARSON_STABLE_APPROVED is explicitly enabled by repository owner. +- Do not remove bundled ASIO support without stating the user impact; check redistribution terms before public stable. From 86616f67e9b855d4d20438b8f2e3d3b1925ceaa6 Mon Sep 17 00:00:00 2001 From: Ari Sulistiono Date: Sun, 1 Nov 2026 11:10:31 +0700 Subject: [PATCH 10/12] release: align README.md with v0.2.0 cross-platform candidate and real quality gates --- README.md | 126 +++++++++++++++++++++++++++--------------------------- 1 file changed, 64 insertions(+), 62 deletions(-) diff --git a/README.md b/README.md index 5ee0f94..b7bdafc 100644 --- a/README.md +++ b/README.md @@ -1,70 +1,72 @@ # ArSonComp -A lightweight **real-time compressor** with a framework-independent C++17 DSP core, JUCE VST3 and Windows Standalone application. Designed for live vocal, karaoke, podcast, music and mix-bus use. This is an **engineering test baseline**, not a certified production release or a claimed FabFilter Pro-C clone. - -## Current verified milestone — 31 October 2026 - -| Area | Implemented and checked | -| --- | --- | -| DSP | Clean feed-forward, causal Feedback and Smooth dual-envelope models; Peak and 10 ms RMS detection; Attack, Release, Hold, Threshold, Ratio, Knee, Range and Auto Release | -| Signal path | Input/Makeup gain, wet/dry Mix, stereo Link, mono/stereo main buses, optional external sidechain, detector HP/LP, SC Listen, smoothed Bypass | -| Latency | **0 additional algorithmic samples** reported by the plugin; host buffer, driver and audio interface latency are separate | -| Host interoperability | Stable APVTS parameter IDs, project state restore, six factory starting presets, user `.arsoncomp` save/open through **FILE**, A/B snapshots, automation attachments | -| GUI | Grey brushed-metal chassis, recessed black LCD graph and IN/GR/OUT meters, photographic black rotary knobs, matched metal toggle PNGs, fixed gunmetal slider rails with moving PNG thumbs and red value fill | -| Value workflow | **No floating value popup/tooltip.** Hover/drag the knobs and sliders to read their value in the LCD's bottom-center footer; MINI uses a small right-side footer | -| Dimensions | Full **780×640** default, **740×585** minimum; MINI **330 px** tall. Resizable full layout and responsive SIDECHAIN row | -| Automated verification | Windows Release VST3 + Standalone, `engine_contract`, `plugin_state_editor`, Linux engine safety/sanitizers, renderer/asset/layout checks, benchmark and install-ready Windows artifact | - -**Latest code-tested revision:** `7b340eb2ee5740df13b52b5bfcf984a3b66d0dd3`. Both jobs passed in [GitHub Actions #41202549812](https://github.com/masarray/arson-comp/actions/runs/41202549812). The [Windows x64 artifact](https://github.com/masarray/arson-comp/actions/runs/41202549812/artifacts/13043510391) contains VST3, Standalone, four actual Windows screenshot captures, a benchmark, and SHA-256 manifests. Subsequent documentation-only reconciliation does not modify the compiled source. - -### What is *not* verified yet - -Real-device ASIO/WASAPI audio latency and stability; two independent DAW/VST3 hosts, external hardware/host sidechain, pluginval, multi-instance long sessions, 125–150% DPI scaling, and loudness-matched listening comparisons. No full Pro-C sonic, feature or production-readiness claim. The initial standalone uses standard JUCE audio device backends; **ASIO support is not claimed**. - -## Quick start — Windows - -1. Download the Windows artifact linked above and extract its contents. -2. Run `Standalone/ArSonComp.exe`, then choose audio input/output devices in its settings; **or** copy the entire `Plugin/ArSonComp.vst3` folder to `C:\Program Files\Common Files\VST3\`, then rescan your VST3 host. -3. Start with Clean and a moderate preset. Lower Threshold until the GR meter indicates the desired compression. Use Makeup to match audible loudness before A/B or model comparisons. -4. Open **SIDECHAIN** to configure Peak/RMS, HP/LP and optional EXT SC and LISTEN; use **DYNAMICS** for Range, Hold, Mix, Link, Auto Release. FILE provides Save/Open user presets. -5. Hover or move any knob/slider to see name, numerical value and unit in the graph LCD footer. Double-click to restore the parameter's default. Use MINI/FULL to switch form factor. - -A disconnected external sidechain may produce silence at the detector. Use LISTEN only to audit the detector and turn it off for normal use. This is a compressor—not a limiter; with no lookahead, transients may pass. - -## Build from source - -CMake 3.22+, C++17, JUCE 8.0.12 pinned to commit `29396c22c93392d6738e021b83196283d6e4d850`. On Windows, install Visual Studio 2022 or newer with C++ desktop tools. - -```sh -cmake -S . -B build -A x64 -DCMAKE_BUILD_TYPE=Release -cmake --build build --config Release --parallel 4 -ctest --test-dir build -C Release --output-on-failure -``` - -For engine-only verification on Linux/macOS, omit the Windows `-A x64` argument and use: +ArSonComp is a lightweight real-time dynamics compressor for vocals, +karaoke, streaming and music, written in C++17 with a reusable JUCE-free +audio engine and a JUCE 8 VST3/Standalone interface. + +## Download for Windows, Linux and macOS + +**[GitHub Releases](https://github.com/masarray/arson-comp/releases)** + +- **Windows 10/11 x64:** Inno Setup EXE. Choose *Just me* (no admin) or + *All users*. Installs VST3 and Standalone by default, Start Menu/uninstaller. +- **Ubuntu/Debian x86_64:** DEB installer with VST3 and Standalone. +- **Other desktop Linux x86_64:** portable archive with no-sudo + per-user install/uninstall scripts. +- **macOS Apple Silicon + Intel:** universal VST3 and Standalone in a PKG. + Ad-hoc code signed; unsigned/not-notarized PKG may trigger Gatekeeper. + +See [installer guide](docs/INSTALL-PUBLIC.md) for exact steps, install +locations, limitations and Mac security instructions. + +### Features + +Original Clean/Feedback/Smooth causal compressor styles; Peak/RMS detection; +external mono/stereo sidechain, adjustable detector HP/LP, wet/dry Mix, +Auto Release, adjustable Range, stereo Link and sidechain listen. +46 original factory presets, user preset Save/Open, A/B, APVTS automation +and project restore. The compact 612×580 full GUI has a tall black-glass +transfer/history/meter LCD, brushed graphite chassis and approved silver +hardware-style sliders. MINI and separate Dynamics/Sidechain panels are +available. The host reports **zero additional algorithmic samples**; +actual audio device/driver round-trip latency is separate. + +### Platform verification and releases + +The cross-platform release workflow builds VST3 and Standalone on Windows, +Linux and macOS, performs automated engine/editor smoke tests, creates +Inno Setup / DEB / portable archive / ad-hoc PKG, and publishes SHA-256 +manifests. The initial public tag is a **release candidate** until physical +DAW and audio-interface results, ASIO/JUCE licensing review and (for +frictionless Mac distribution) Developer ID notarization are complete. +A public CI artifact alone is not certified production-stable. + +See [Windows physical test quickstart](docs/WINDOWS-QUICKSTART.md), +[hardware readiness](docs/M7-PHYSICAL-READINESS.md), and +[validation](docs/VALIDATION.md). Real-device Maono PS22 crackles/underruns, +32/64/128 buffers, multiple hosts, pluginval, long-session memory and +loudness-matched quality are separate release gates. + +### Build locally + +CMake 3.22+, C++17, JUCE 8.0.12 pinned to a verified commit. +Visual Studio 2022 C++ Desktop on Windows; Xcode on macOS; JUCE Linux +dependencies from [JUCE official documentation](https://github.com/juce-framework/JUCE/blob/master/docs/Linux%20Dependencies.md). ```sh -cmake -S . -B build-core -DARSON_BUILD_PLUGIN=OFF -DCMAKE_BUILD_TYPE=Release -cmake --build build-core --parallel 2 -ctest --test-dir build-core --output-on-failure -./build-core/engine_bench +cmake -S . -B build -DCMAKE_BUILD_TYPE=Release +cmake --build build --parallel 2 +ctest --test-dir build --output-on-failure ``` -Linux plugin build dependencies depend on the desktop stack, commonly `pkg-config libasound2-dev libx11-dev libxext-dev libxinerama-dev libxrandr-dev libxcursor-dev libfreetype6-dev libfontconfig1-dev libgl1-mesa-dev`. Use `-DJUCE_SOURCE_DIR=/path/to/JUCE` to reuse a local checkout. ASan/UBSan engine testing: `-DARSON_SANITIZE=ON -DCMAKE_BUILD_TYPE=Debug` under GCC/Clang. **Do not enable fast-math**, because non-finite handling relies on IEEE floating-point semantics. - -## Engineering boundaries - -The independent DSP core is free of JUCE. The audio callback does not require a worker, mutex, heap allocation or file/network I/O; it has bounded telemetry. GUI paint is message-thread-only, with cached materials, gradient/grid geometry and 30 Hz display updates. The plugin adds no intentional lookahead, oversampling, linear-phase stage or audio delay line. A reported zero algorithmic samples does **not** mean the full monitoring system has zero latency. - -Presets and parameter updates are smoothed where appropriate, but are not promised sample-accurate atomic transactions. Host automation behavior, sidechain audibility, distortion and CPU load must be verified with actual devices. - -## Documentation and release gates +Windows Visual Studio uses `cmake -S . -B build -A x64` and +`cmake --build build --config Release`. The Windows Standalone enables +native ASIO by default; review the Steinberg SDK terms when redistributing. -- [PRD: scope and acceptance](docs/PRD.md) -- [ARD: DSP, scheduling and GUI ownership](docs/ARD.md) -- [VALIDATION: evidence and outstanding tests](docs/VALIDATION.md) -- [HANDOFF: current next steps and historical milestones](docs/HANDOFF.md) -- [WINDOWS-QUICKSTART: physical test checklist](docs/WINDOWS-QUICKSTART.md) -- [AGENTS: engineering guardrails](AGENTS.md) +### License and compliance -Repository license remains AGPL-3.0; JUCE has its own AGPL/commercial terms. FabFilter Pro-C is a third-party workflow and sound-quality reference; no FabFilter asset, code or proprietary algorithm is included. +ArSonComp is AGPL-3.0 licensed; JUCE has its own AGPL/commercial licensing +terms. The Windows Standalone includes Steinberg ASIO SDK-related code +when ARSON_WINDOWS_ASIO=ON. Review its SDK redistribution terms for any +public binary release. No FabFilter code/graphics/algorithms are copied, +and equal sound quality with commercial software is not claimed. From 93912740152a0d224d095cb4ec75746ec0752f99 Mon Sep 17 00:00:00 2001 From: Ari Sulistiono Date: Sun, 1 Nov 2026 11:12:49 +0700 Subject: [PATCH 11/12] fix(release): enable C language for JUCE platform-generated sources on Linux/macOS --- CMakeLists.txt | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/CMakeLists.txt b/CMakeLists.txt index eac78a8..47adb8a 100644 --- a/CMakeLists.txt +++ b/CMakeLists.txt @@ -1,5 +1,5 @@ cmake_minimum_required(VERSION 3.22) -project(ArSonComp VERSION 0.2.0 LANGUAGES CXX) +project(ArSonComp VERSION 0.2.0 LANGUAGES C CXX) set(CMAKE_CXX_STANDARD 17) set(CMAKE_CXX_STANDARD_REQUIRED ON) option(ARSON_BUILD_PLUGIN "Build VST3 and standalone" ON) From 694a1fa29df2b1274333243460db1680e0a92bd7 Mon Sep 17 00:00:00 2001 From: Ari Sulistiono Date: Sun, 1 Nov 2026 11:23:48 +0700 Subject: [PATCH 12/12] fix(release): Inno Pascal literal preprocessing and offscreen Linux Xvfb editor smoke --- packaging/windows/ArSonComp.iss | 4 ++-- tests/PluginSmoke.cpp | 9 ++++++++- 2 files changed, 10 insertions(+), 3 deletions(-) diff --git a/packaging/windows/ArSonComp.iss b/packaging/windows/ArSonComp.iss index 34339d3..648f226 100644 --- a/packaging/windows/ArSonComp.iss +++ b/packaging/windows/ArSonComp.iss @@ -73,7 +73,7 @@ begin OtherPlugin := ExpandConstant('{commoncf}\VST3\ArSonComp.vst3'); if DirExists(OtherPlugin) then MsgBox('Another ArSonComp VST3 also exists in:' + #13#10 + OtherPlugin + - #13#10#13#10 + 'Some DAWs may load that copy first. Remove the older copy.' + - #13#10 + 'Restart or rescan your DAW after installing.', + '' + #13#10#13#10 + 'Some DAWs may load that copy first. Remove the older copy.' + + '' + #13#10 + 'Restart or rescan your DAW after installing.', mbInformation, MB_OK); end; diff --git a/tests/PluginSmoke.cpp b/tests/PluginSmoke.cpp index 938e5a4..722b89b 100644 --- a/tests/PluginSmoke.cpp +++ b/tests/PluginSmoke.cpp @@ -734,7 +734,14 @@ static int runSmoke(int argc,char** argv) { if(!range->isVisible()||hp->isVisible()||!autoMode->isVisible()) return 32; } - editor->addToDesktop(0); editor->setVisible(true); + // Under Linux/Xvfb there may be no EWMH-compatible window manager. + // An X_ChangeProperty BadAtom can occur before the actual GUI smoke + // assertions. Paint/snapshot offscreen there; keep native window + // peer coverage on Windows and macOS. + #if !JUCE_LINUX + editor->addToDesktop(0); + #endif + editor->setVisible(true); for(int j=0;j<1500;++j) { for(int i=0;i<128;++i) { const float level=0.15f+0.6f*(0.5f+0.5f*std::sin(j*0.013f));