Clone an iPlug2 Example

Use this skill when the user wants to create a new plugin project from an iPlug2 example.

Workflow

1. Ask for project details:

   • Plugin name (required): No spaces or special characters
   • Manufacturer name (required): Default to "AcmeInc" if not provided
   • Base template: Which example to clone from

2. Available templates: | Template | Description | |----------|-------------| | IPlugEffect | Basic audio effect (volume control) - recommended for effects | | IPlugInstrument | MPE-capable polyphonic synth - recommended for instruments | | IPlugControls | Widget demonstration | | IPlugWebUI | HTML/CSS/JS UI via WebView | | IPlugSwiftUI | SwiftUI for macOS/iOS | | IPlugSvelteUI | Svelte-based UI |

3. Run the duplicate script:

   cd Examples
   ./duplicate.py [SourceExample] [NewPluginName] [ManufacturerName]
   

4. Customize config.h (offer to user):

   • PLUG_UNIQUE_ID - Auto-generated 4-char ID (verify it's unique)
   • PLUG_MFR_ID - 4-char manufacturer ID
   • Copyright, email, URLs - prompt but allow skipping

5. Warn about sensitive settings:

   • Don't change BUNDLE_NAME without updating plist files
   • Keep config.h free of #include statements

Example

cd Examples
./duplicate.py IPlugEffect MyGainPlugin MyCompany

Creates Examples/MyGainPlugin/ with all project files renamed and configured.