Screenshot

Screenshot Plugin UI

Use this skill to capture screenshots of the plugin UI. This is useful for:

• Debugging UI design - Quickly verify control layouts, colors, and positioning without launching a DAW
• Documentation - Generate consistent screenshots for README files and wikis
• CI/CD pipelines - Automated visual regression testing or asset generation

Prerequisites

Build the standalone app (APP target) first:

cd [ProjectFolder]
xcodebuild -project "./projects/[ProjectName]-macOS.xcodeproj" -target APP -configuration Debug

The app will be built to ~/Applications/[PluginName].app

Take Screenshot

macOS

~/Applications/[PluginName].app/Contents/MacOS/[PluginName] --screenshot /path/to/output.png

Example

# Take screenshot of IPlugEffect
~/Applications/IPlugEffect.app/Contents/MacOS/IPlugEffect --screenshot ./screenshot.png

The app will:

1. Launch and display the UI (audio/MIDI I/O is automatically disabled)
2. Wait ~500ms for the UI to fully render
3. Capture the window to a PNG file
4. Exit automatically

Options

• --screenshot <path> - Path to save the PNG screenshot (required)
• --no-io - Explicitly disable audio/MIDI (implicit when using --screenshot)

Tips

• Screenshots are high-DPI (Retina) resolution on supported displays
• The screenshot captures the plugin content area
• For iterative UI debugging, rebuild the APP target and re-run the screenshot command
• Combine with the build skill: build first, then screenshot