Skip to content
Draft
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
126 changes: 124 additions & 2 deletions .github/workflows/build-and-release.yml
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
# Build and release AceForge-Suno AU + VST3 (macOS)
name: Build and release (macOS)
# Build and release AceForge-Suno for macOS, Windows, and Linux
name: Build and release

on:
push:
Expand Down Expand Up @@ -139,3 +139,125 @@ jobs:
with:
name: AceForgeSuno-macOS-plugins
path: release-artefacts/

build-windows:
runs-on: windows-latest
steps:
- name: Checkout
uses: actions/checkout@v4

- name: Configure CMake
run: |
cmake -B build -G "Visual Studio 17 2022" -A x64 -DCMAKE_BUILD_TYPE=Release

- name: Build
run: |
cmake --build build --config Release

- name: Locate plugin artefacts
id: artefacts
shell: bash
run: |
set -e
VST3=$(find build -name "AceForge-Suno.vst3" -type d 2>/dev/null | head -1)
[ -n "$VST3" ] || VST3=$(find build -name "*.vst3" -type d 2>/dev/null | head -1)
echo "vst3_path=$VST3" >> $GITHUB_OUTPUT
echo "Found VST3: $VST3"
if [ -z "$VST3" ]; then
echo "Plugin artefacts not found. Build tree:"
find build -type d -name "*.vst3" 2>/dev/null || true
exit 1
fi

- name: Create zip archive for release
shell: bash
run: |
mkdir -p release-artefacts
cp -R "${{ steps.artefacts.outputs.vst3_path }}" "release-artefacts/AceForge-Suno.vst3"
cd release-artefacts && 7z a -tzip "AceForgeSuno-Windows-VST3.zip" "AceForge-Suno.vst3" && cd ..
echo "zip_path=release-artefacts/AceForgeSuno-Windows-VST3.zip" >> $GITHUB_ENV

- name: Upload release assets
if: github.event_name == 'release' || (github.event_name == 'workflow_dispatch' && inputs.release_tag != '')
uses: softprops/action-gh-release@v2
with:
tag_name: ${{ (github.event_name == 'release' && github.event.release.tag_name) || inputs.release_tag }}
files: |
release-artefacts/AceForgeSuno-Windows-VST3.zip
env:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

- name: Upload artefacts (push / workflow_dispatch or no release)
if: github.event_name != 'release' || github.event.release == null
uses: actions/upload-artifact@v4
with:
name: AceForgeSuno-Windows-plugins
path: release-artefacts/

build-linux:
runs-on: ubuntu-latest
steps:
- name: Checkout
uses: actions/checkout@v4

- name: Install dependencies
run: |
sudo apt-get update
sudo apt-get install -y \
build-essential \
cmake \
libcurl4-openssl-dev \
libasound2-dev \
libfreetype6-dev \
libx11-dev \
libxcomposite-dev \
libxcursor-dev \
libxinerama-dev \
libxrandr-dev \
libgl1-mesa-dev

- name: Configure CMake
run: |
cmake -B build -DCMAKE_BUILD_TYPE=Release

- name: Build
run: |
cmake --build build --config Release

- name: Locate plugin artefacts
id: artefacts
run: |
set -e
VST3=$(find build -name "AceForge-Suno.vst3" -type d 2>/dev/null | head -1)
[ -n "$VST3" ] || VST3=$(find build -name "*.vst3" -type d 2>/dev/null | head -1)
echo "vst3_path=$VST3" >> $GITHUB_OUTPUT
echo "Found VST3: $VST3"
if [ -z "$VST3" ]; then
echo "Plugin artefacts not found. Build tree:"
find build -type d -name "*.vst3" 2>/dev/null || true
exit 1
fi

- name: Create tar.gz archive for release
run: |
mkdir -p release-artefacts
cp -R "${{ steps.artefacts.outputs.vst3_path }}" "release-artefacts/AceForge-Suno.vst3"
cd release-artefacts && tar -czf "AceForgeSuno-Linux-VST3.tar.gz" "AceForge-Suno.vst3" && cd ..
echo "archive_path=release-artefacts/AceForgeSuno-Linux-VST3.tar.gz" >> $GITHUB_ENV

- name: Upload release assets
if: github.event_name == 'release' || (github.event_name == 'workflow_dispatch' && inputs.release_tag != '')
uses: softprops/action-gh-release@v2
with:
tag_name: ${{ (github.event_name == 'release' && github.event.release.tag_name) || inputs.release_tag }}
files: |
release-artefacts/AceForgeSuno-Linux-VST3.tar.gz
env:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

- name: Upload artefacts (push / workflow_dispatch or no release)
if: github.event_name != 'release' || github.event.release == null
uses: actions/upload-artifact@v4
with:
name: AceForgeSuno-Linux-plugins
path: release-artefacts/
34 changes: 28 additions & 6 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,9 +11,10 @@ Control the **Suno API** from your DAW. Generate music, create covers, and add v

## Platform Support

**Currently supported:** macOS (Apple Silicon & Intel)

**Future support:** Windows and Linux are planned for future releases.
**Currently supported:**
- **macOS** — Apple Silicon (arm64) and Intel (x86_64) via AU and VST3 formats
- **Windows** — x64 via VST3 format
- **Linux** — x64 via VST3 format

## Features

Expand All @@ -27,14 +28,17 @@ Control the **Suno API** from your DAW. Generate music, create covers, and add v
### Pre-built Releases (Recommended)

Download the latest release from [GitHub Releases](https://github.com/audiohacking/suno-daw/releases):
- `.pkg` installer for easy installation
- `.zip` for manual installation
- **macOS:** `.pkg` installer or `.zip` for manual installation
- **Windows:** `.zip` containing VST3 plugin
- **Linux:** `.tar.gz` containing VST3 plugin

After installation, rescan plugins in your DAW.

### Requirements

- macOS (Apple Silicon or Intel)
- **macOS:** macOS 10.13 or later (Apple Silicon or Intel)
- **Windows:** Windows 10 or later (x64)
- **Linux:** Modern Linux distribution with X11 support
- A Suno API key from [Suno API](https://docs.sunoapi.org/)

## Quick Start
Expand All @@ -54,11 +58,29 @@ After installation, rescan plugins in your DAW.

For developers who want to build the plugin:

### macOS
```bash
cmake -B build -G Xcode -DCMAKE_OSX_ARCHITECTURES=arm64 -DCMAKE_BUILD_TYPE=Release
cmake --build build --config Release
```

### Windows
```bash
cmake -B build -G "Visual Studio 17 2022" -A x64 -DCMAKE_BUILD_TYPE=Release
cmake --build build --config Release
```

### Linux
```bash
# Install dependencies first
sudo apt-get install build-essential cmake libcurl4-openssl-dev libasound2-dev \
libfreetype6-dev libx11-dev libxcomposite-dev libxcursor-dev libxinerama-dev \
libxrandr-dev libgl1-mesa-dev

cmake -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build --config Release
```

Copy the built plugins to your system plugin folders and rescan in your DAW.

For detailed build instructions and architecture documentation, see [DESIGN.md](DESIGN.md).
Expand Down
Loading