port

Port JUCE Plugin Cross-Platform

Port an existing JUCE plugin project to another platform. Supports porting in any direction: macOS → Windows/Linux, or Windows → macOS/Linux. Scans for platform-specific code, generates a plan, applies changes, and optionally tests on a VM or via CI.

Arguments

Platform (required) — the target platform you're porting TO:

• windows — Port to Windows (MSVC + Ninja, D3D11)
• linux — Port to Linux (Clang + Ninja, Vulkan)
• macos — Port to macOS (Apple Clang + Xcode/Ninja, Metal)
• all — Port to all other platforms

Options:

• --audit-only — Just scan and report issues, don't make changes
• --vm <alias> — SSH alias for target platform VM (e.g., --vm win)
• --test-ci — After porting, trigger GitHub Actions CI to verify

Implementation

Stage 0: Detect Project and Source Platform

Verify this is a JUCE-Plugin-Starter project:

# Must have these files
test -f CMakeLists.txt || { echo "ERROR: No CMakeLists.txt — not a JUCE project"; exit 1; }
test -f .env || test -f .env.example || { echo "WARNING: No .env file found"; }
test -d scripts/ || { echo "WARNING: No scripts/ directory"; }
test -d Source/ || { echo "ERROR: No Source/ directory"; exit 1; }

Detect the source platform (what the project was built on):

# Check for macOS-origin indicators
has_mm_files=$(find Source/ -name "*.mm" 2>/dev/null | head -1)
has_xcode_script=$(test -f scripts/generate_and_open_xcode.sh && echo "yes")
has_build_sh=$(test -f scripts/build.sh && echo "yes")

# Check for Windows-origin indicators
has_ps1=$(test -f scripts/build.ps1 && echo "yes")
has_msvc_cmake=$(grep -l "if(MSVC)" CMakeLists.txt 2>/dev/null)
has_azure_signing=$(grep -l "AZURE_TENANT_ID" .env 2>/dev/null || grep -l "AZURE_TENANT_ID" .env.example 2>/dev/null)
has_inno_setup=$(grep -rl "Inno Setup\|\.iss" scripts/ 2>/dev/null | head -1)

# Check for Linux-origin indicators
has_linux_cmake=$(grep -l "UNIX AND NOT APPLE" CMakeLists.txt 2>/dev/null)
has_linux_deps=$(grep -l "libasound2-dev\|libwebkit2gtk" scripts/dependencies.sh 2>/dev/null)
has_linux_updater=$(test -f Source/AutoUpdater_Linux.cpp && echo "yes")