A simple but functional sampler plugin built with JUCE 8.0.8, featuring chromatic sampling across multiple octaves with decay and reverb controls.

• 8 chromatic samples (C5 through C6) mapped across the full MIDI range
• Adjustable decay envelope
• Built-in reverb effect
• Custom GUI with filmstrip knobs
• VST3, AU, and Standalone formats

• sources/ - Source files (.h and .cpp)
• assets/ - WAV samples, PNG images, and TTF fonts
• build/ - Generated build files (not in git)

• CMake 3.22 or higher
• C++20 compatible compiler
• Xcode (macOS) or Visual Studio 2022 (Windows)

# Debug build (native architecture only)
cmake -B build -G Xcode

# Release build (universal binary: Intel + Apple Silicon)
cmake -B build -G Xcode -D"CMAKE_OSX_ARCHITECTURES=arm64;x86_64"

# Build from command line
cmake --build build --config Release

After building, plugins will be automatically copied to:

• AU: ~/Library/Audio/Plug-Ins/Components/
• VST3: ~/Library/Audio/Plug-Ins/VST3/
• Standalone: build/Sampler_artefacts/

# Generate Visual Studio project
cmake -B build -G "Visual Studio 17 2022"

# Build from command line
cmake --build build --config Release

Open build/Sampler.sln in Visual Studio to build and debug.

• After running CMake for the first time, generated files like JuceHeader.h and BinaryData.h may appear in red in your IDE
• These files are created during the build process
• After the first successful build, they will be accessible
• If you add/remove/rename source files, you need to re-run CMake

Controls the envelope decay time of the sampler voices.

• Range: 0% to 100%
• Default: 0%
• Behavior: Uses a non-linear (squared) curve to provide finer control at lower values
  • 0% = 0.05s decay time (very short)
  • 100% = 1.0s decay time (sustained)
• Attack: Fixed at 0.0s (instant)
• Release: Fixed at 0.05s

Controls the reverb room size.

• Range: 0% to 100%
• Default: 50%
• Behavior:
  • Room size scales linearly with percentage
  • Damping: Fixed at 0.5
  • Wet level: Fixed at 0.33
  • Dry level: Fixed at 0.4
• Note: Reverb is always active in the signal chain

The plugin uses 8 chromatic samples (C5-C6) distributed across the full MIDI range. Each sample covers multiple keys to create a chromatic scale:

Note: JUCE's sampler engine automatically pitch-shifts each sample to match the played note, using the root note as the reference pitch.

• Polyphony: 8 voices
• Voice Management: Standard JUCE voice stealing when polyphony limit is reached
• Stereo Processing: Stereo output only (mono not currently supported)
• Sample Format: 16-bit WAV files included as binary data

This project uses CMake instead of Projucer:

• CPM: Downloads JUCE automatically (no submodules needed)
• JUCE Version: 8.0.8
• Important flags in CMakeLists.txt:
  • IS_SYNTH TRUE - Marks plugin as an instrument
  • NEEDS_MIDI_INPUT TRUE - Enables MIDI input
  • CMAKE_MSVC_RUNTIME_LIBRARY - Links with static C++ library on Windows
  • PDB/dSYM generation enabled for release builds (allows crash log symbolication)
• Binary Data: WAV files, PNG images, and TTF fonts are embedded in the plugin binary via juce_add_binary_data()

Samples:

• WAV files are embedded as binary data in the plugin executable
• For projects with many or very large samples, on-demand loading would be required (more complex)
• Current samples have no silence at start/end and are normalized to similar loudness
• Single velocity layer (no velocity sensitivity)
• Note: Finder/Explorer may sort a5.wav before c5.wav (alphabetical, not musical order)

Images and Fonts:

• Background image and Inter fonts are embedded as binary data
• Plugin is fully self-contained with no external file dependencies at runtime
• All artwork is rendered at 2x resolution:
  • Background: 1376×1032 pixels (displayed at 688×516)
  • Knob filmstrip: 152×132 pixels per frame, 129 frames total
  • 2x assets ensure sharpness on Retina/HiDPI displays
• Inter font family is licensed under SIL Open Font License (royalty-free distribution)

• Simplified PluginProcessor implementation (not using standard JUCE/Projucer template)
• Stereo-only output (see isBusesLayoutSupported())
• Mono support could be added as juce::Synthesiser already supports it

• The **/build folder is in .gitignore and won't be committed
• When adding/removing/renaming source files, update target_sources in CMakeLists.txt and re-run CMake
• Explicit file listing (vs. automatic discovery) provides better control and clarity

Check individual asset licenses:

• Inter fonts: SIL Open Font License
• JUCE: GPL/Commercial (see JUCE licensing for distribution)