Getting Started with JUCE: A Beginner’s Guide

How to Build Your First Audio Plugin Using JUCE Creating your own audio software used to mean writing complex code for multiple operating systems and complex plugin formats. The JUCE framework changed that by abstracting native audio APIs. It allows you to write C++ code once and deploy it as a VST3, AU, AAX, or Standalone plugin.

This guide walks you through building your very first volume-control utility plugin from scratch. Step 1: Set Up Your Environment

Before writing code, you need to install the framework and a code editor.

Download JUCE: Visit the JUCE website and download the free utilities tier for personal or educational use. Extract the folder to your home directory. Install an IDE: macOS: Download Xcode from the Mac App Store.

Windows: Download Visual Studio Community Edition (ensure you check the “Desktop development with C++” workload).

Launch the Projucer: Inside the main JUCE directory, look for and open the Projucer application, which serves as JUCE’s integrated project creator. Step 2: Create a New Project

The Projucer templates out your setup files so you can skip complex linker configurations. Open Projucer and select New Project → Audio Plug-In. Name your project (e.g., GainPlugin).

Under Exporters, select your target platform (Xcode for Mac or Visual Studio for Windows). Click Create Project and choose a save location.

JUCE automatically generates four core files visible in your project structure:

PluginProcessor.h & PluginProcessor.cpp: Handles the digital signal processing (DSP) math behind the scenes.

PluginEditor.h & PluginEditor.cpp: Handles the user interface (UI), graphics, and sliders. Step 3: Define the Audio Parameter

To let a user adjust the volume, we must declare a variable that binds the user interface to the underlying DSP processing code safely.

Open PluginProcessor.h. In the private section of your GainPluginAudioProcessor class (at the bottom of the file), add a pointer for a float parameter:

private: juce::AudioParameterFloatgainParameter; JUCE_DECLARE_NON_COPYABLE_WITH_LEAK_DETECTOR (GainPluginAudioProcessor) }; Use code with caution.

Next, open PluginProcessor.cpp. Initialize this parameter inside the class constructor method. This registers the parameter with the Digital Audio Workstation (DAW):

GainPluginAudioProcessor::GainPluginAudioProcessor() #ifndef JucePlugin_PreferredChannelConfigurations : AudioProcessor (BusesProperties() #if ! JucePlugin_IsMidiEffect #if ! JucePlugin_IsSynth .withInput (“Input”, juce::AudioChannelSet::stereo(), true) #endif .withOutput (“Output”, juce::AudioChannelSet::stereo(), true) #endif ) #endif { addParameter (gainParameter = new juce::AudioParameterFloat ( “gainID”, // Parameter ID “Gain”, // Parameter name shown in DAW 0.0f, // Minimum value 1.0f, // Maximum value 0.5f)); // Default value } Use code with caution. Step 4: Write the Audio DSP Logic

The core real-time processing loop happens inside the processBlock function of your processor file.

Scroll down to void GainPluginAudioProcessor::processBlock (juce::AudioBuffer& buffer, juce::MidiBuffer& midiMessages) inside PluginProcessor.cpp. Replace the default boilerplate loop with code that reads our gain parameter and multiplies it against the audio stream:

void GainPluginAudioProcessor::processBlock (juce::AudioBuffer& buffer, juce::MidiBuffer& midiMessages) { juce::ScopedNoDenormals noDenormals; auto totalNumInputChannels = getTotalNumInputChannels(); auto totalNumOutputChannels = getTotalNumOutputChannels(); // Clear unused output channels to prevent random feedback noise for (auto i = totalNumInputChannels; i < totalNumOutputChannels; ++i) buffer.clear (i, 0, buffer.getNumSamples()); // Fetch the current user value from our parameter float currentGain = gainParameter->get(); // Multiply the incoming audio samples by our slider gain value for (int channel = 0; channel < totalNumInputChannels; ++channel) { auto* channelData = buffer.getWritePointer (channel); for (int sample = 0; sample < buffer.getNumSamples(); ++sample) { channelData[sample] *= currentGain; } } } Use code with caution. Step 5: Design the User Interface

Now that the processor calculation is ready, we need a visual controller so users can turn the volume up and down.

Open PluginEditor.h. Add a slider control and an attachment wrapper that links the graphic slider straight to our processor parameter variables:

private: GainPluginAudioProcessor& audioProcessor; juce::Slider gainSlider; // std::unique_ptrjuce::AudioProcessorValueTreeState::SliderAttachment sliderAttachment; JUCE_DECLARE_NON_COPYABLE_WITH_LEAK_DETECTOR (GainPluginAudioProcessorEditor) }; Use code with caution.

Open PluginEditor.cpp. Configure the physical slider settings inside the constructor: Building an Audio Plugin with JUCE framework : r/cpp