new-plugin

iPlug2's avatarfrom iPlug2

Create a new iPlug2 plugin project by duplicating TemplateProject in the iPlug2OOS repository

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

When & Why to Use This Skill

This Claude skill automates the initialization of audio plugin projects using the iPlug2 framework. It streamlines the process of duplicating templates, configuring unique identifiers (PLUG_UNIQUE_ID), and setting up the initial development environment, allowing developers to transition from concept to DSP coding instantly.

Use Cases

  • Rapid Audio Plugin Scaffolding: Quickly bootstrap new VST, AU, or AAX plugin projects by duplicating the iPlug2OOS template without manual file copying.
  • Automated Project Configuration: Ensure consistent setup of manufacturer names, plugin IDs, and copyright headers through a guided conversational interface.
  • Development Workflow Integration: Automatically initialize Git repositories and prepare IDE workspaces (Xcode/VS Code) to jumpstart the development lifecycle.
namenew-plugin
descriptionCreate a new iPlug2 plugin project by duplicating TemplateProject in the iPlug2OOS repository

Create New Plugin (iPlug2OOS)

Use this skill when the user wants to create a new plugin project in this out-of-source repository.

Workflow

  1. Gather project details:

    • Plugin name (required): No spaces or special characters
    • Manufacturer name (required): No spaces
  2. Check for existing projects:

    • If other project folders exist besides TemplateProject, ask if user wants to continue with existing work or create new
  3. Run duplicate script:

    ./duplicate.py TemplateProject [PluginName] [ManufacturerName]
    
  4. Offer config.h customization:

    • PLUG_UNIQUE_ID - Verify the auto-generated 4-char ID
    • PLUG_MFR_ID - Set manufacturer's 4-char ID
    • Copyright, URLs - allow skipping for later
  5. Ask about committing:

    git add [PluginName]/*
    git add .vscode/*
    git add .github/*
    git add bump_version.py
    git commit -m "created [PluginName] based on TemplateProject"
    
  6. Next steps:

    • Open in Xcode: open [PluginName]/[PluginName].xcworkspace
    • Build: Use the build skill from iPlug2
    • Setup SDKs: Use the setup-deps skill if needed

Example

./duplicate.py TemplateProject MySynth MyBrand

Creates MySynth/ with all project files configured and ready to build.