build

iPlug2's avatarfrom iPlug2

Build an iPlug2 plugin project for different formats and platforms (macOS, iOS, Windows)

⭐127stars🔀30forks📁View on GitHub🕐Updated Dec 20, 2025

When & Why to Use This Skill

This Claude skill automates the build process for iPlug2 audio plugin projects across multiple platforms, including macOS, iOS, and Windows. It streamlines the compilation of various industry-standard formats such as VST3, AU, AAX, and CLAP by handling workspace identification, scheme selection, and environment-specific build commands, significantly reducing the manual overhead for audio software developers.

Use Cases

  • Cross-Platform Plugin Compilation: Automatically build and package VST3, AU, and CLAP formats on macOS using xcodebuild for streamlined distribution.
  • iOS Audio App Development: Compile 'iOS-APP with AUv3' schemes and prepare projects for testing within the iOS Simulator environment.
  • Windows Build Automation: Execute msbuild commands to generate 64-bit Windows plugin binaries directly from project solution files.
  • Continuous Development Workflow: Quickly verify code changes by triggering automated builds and monitoring build logs for errors without leaving the agent interface.
namebuild
descriptionBuild an iPlug2 plugin project for different formats and platforms (macOS, iOS, Windows)

Build iPlug2 Plugin (iPlug2OOS)

Use this skill when the user wants to build their plugin project.

Workflow

  1. Identify the project:

    • If not specified, look for .xcworkspace files in the repo root (excluding TemplateProject)
    • Ask user to choose if multiple projects exist
  2. Build using the appropriate method below

macOS Build (xcodebuild)

xcodebuild -workspace [Project]/[Project].xcworkspace -scheme "[SCHEME]" -configuration [CONFIG] build 2>&1 | tee build.log

Schemes: macOS-APP, macOS-AU, macOS-VST2, macOS-VST3, macOS-CLAP, macOS-AAX, macOS-AUv3 Configurations: Debug, Release, Tracer

Build Locations

  • APP: ~/Applications/[PluginName].app
  • VST3: ~/Library/Audio/Plug-Ins/VST3/
  • AU: ~/Library/Audio/Plug-Ins/Components/
  • CLAP: ~/Library/Audio/Plug-Ins/CLAP/
open [Project]/[Project].xcworkspace

iOS Build

xcodebuild -workspace [Project]/[Project].xcworkspace -scheme "iOS-APP with AUv3" -configuration Debug -destination 'platform=iOS Simulator,name=iPhone 16 Pro' build

For running in Simulator, use the run-ios-simulator skill.

Windows Build

Open the .sln file in Visual Studio:

[Project]/[Project].sln

Build from IDE or command line:

msbuild [Project]/[Project].sln /p:Configuration=Release /p:Platform=x64

Tips

  • Build one scheme at a time; building all may fail if SDKs are missing
  • Check build.log for issues
  • If Skia backend is configured, run iPlug2/Dependencies/download-prebuilt-libs.sh mac first
  • AUv3 requires code signing; use macOS-AU (AUv2) for simpler local testing
  • Use xcodebuild -workspace [Project]/[Project].xcworkspace -list to see all available schemes

Example

# Build standalone app (Debug)
xcodebuild -workspace MySynth/MySynth.xcworkspace -scheme "macOS-APP" -configuration Debug build

# Open the built app
open ~/Applications/MySynth.app

# Build AU plugin (Release)
xcodebuild -workspace MySynth/MySynth.xcworkspace -scheme "macOS-AU" -configuration Release build