After you’ve created a new repo from the template, here’s a checklist of things to do to customize for your project.
git clone
your new repo (if you’ve made it private, read the warning about GitHub Actions minutes, as they can add up on Mac.)- Download CMAKE if you aren’t already using it (Clion and VS2022 both have it bundled, so you can skip this step in those cases).
- Populate JUCE by running
git submodule update --init
in your repository directory. By default, this track JUCE’sdevelop
branch. This is a good default practice to get into until you are at the point of releasing a plugin. It will also pull in the CMake and an example module, my JUCE component inspector. - Replace
Pamplejuce
with the name of your project inCMakeLists.txt
where thePROJECT_NAME
variable is first set. Make this all one word, no spaces. - Adjust which plugin formats you want built (VST3, AU, etc).
- Set the correct flags for your plugin
juce_add_plugin
. Check out the official API and be sure to change things likePLUGIN_CODE
andPLUGIN_MANUFACTURER_CODE
— everything that saysChange me!
. - Build n’ Run! If you want to generate an Xcode project, run
cmake -B Builds -G Xcode
. Or just open the project’s folder in CLion or VS2022. Running the standalone is always easiest, but you can also build theAudioPluginHost
that comes with JUCE. Out of the box, Pamplejuce’s VST3/AU targets should already be pointing to it’s built location. - If you want to package and code sign, you’ll want to take a look at the packaging/ directory add assets and config that match your product.
This is what you will see when it’s built: An empty plugin displaying its version number with a button that opens up the Melatonin Inspector:
Leave a Reply