A comprehensive collection of extra modules for JUCE, providing professional-grade utilities, UI components, DSP processors, and more for audio plugin and application development.

• Prerequisites
• Installation
• Modules
• Features
• Examples
• Help & Documentation
• Breaking Changes
• Credits

• JUCE 7.0+ (included as submodule)
• CMake 3.15+
• C++20 compatible compiler
• Supported Platforms: Windows, macOS (10.13+), Linux

1. Add Gin as a submodule:

git submodule add https://github.com/FigBug/Gin.git modules/gin

2. In your CMakeLists.txt:

add_subdirectory(modules/gin/modules)

target_link_libraries(YourTarget PRIVATE
    gin
    gin_plugin      # For audio plugins
    gin_dsp         # For DSP components
    gin_gui         # For UI components
    # ... other gin modules as needed
)

3. Gin is automatically in the JUCE Header:

#include <JuceHeader.h>

Gin is organized into focused modules that can be included independently:

• DownloadManager - Asynchronous downloads with zero main thread delay
• FileSystemWatcher - Real-time notifications when files change
• SharedMemory - Inter-process memory sharing
• Ellipse - Geometric calculations for ellipses
• LeastSquaresRegression - Curve fitting to data points
• LinearRegression - Line fitting to data points
• Spline - Smooth cubic spline interpolation
• Integrator - Numerical integration

• ImageEffects - Sepia, vignette, soften, sharpen, invert, contrast, hue, saturation, stack blur
• ImageMetadata - Read/write JPEG and PNG metadata
• BMPImageFormat - Windows Bitmap support

• Oscillators - Wavetable oscillator with multiple waveforms
• Effects - Compressor, reverb, filters
• Envelopes - ADSR envelope generator
• PerlinNoise - Natural-sounding noise generation
• Modulation - LFO and modulation matrix

• Property Components - File chooser, color picker
• Layout System - JSON-based flexible layouts
• Synth UI - Ready-to-use synthesizer interface components
• Map Components - OpenStreetMap integration and tile rendering

• WebSocket - Full-featured WebSocket client
• SecureStreamingSocket - SSL/TLS socket support

• GameControllerManager - Cross-platform manager polling up to 8 controllers
• GameController - Unified button and axis state with listener callbacks
• Platform backends - XInput on Windows, GameController framework on macOS, joydev on Linux

• Processor - Extended audio processor with parameter management
• Parameter - Smart parameters with modulation support
• ModMatrix - Flexible modulation matrix system
• Plugin Components - Knobs, ADSR, LFO, and MSEG UI components
• Patch Browser - Preset management and browsing

• EXIF - Read EXIF metadata from images
• IPTC - Read IPTC metadata from images
• XMP - Read XMP metadata from images

• MIPP Integration - Cross-platform SIMD abstraction (SSE/NEON)
• Optimized Math - SIMD-accelerated math operations

• WebPImageFormat - Read and write WebP images
• Bundles its own libwebp, so JUCE's built-in WebP support must be disabled with JUCE_USE_WEBP=0. The CMake target sets this automatically; Projucer users need to add it to their preprocessor definitions.

• SVG parsing and rendering - Powered by NanoSVG

• Vec3/Mat4 - 3D vector and matrix math
• Camera3D - 3D camera with projection
• Scene3D - Scene graph for 3D objects
• Renderer3D - Wireframe rendering to 2D

• StandaloneApp - Application wrapper for running plugins standalone
• StandaloneFilterWindow - Window hosting the plugin UI
• SidebarComponent - Audio analysis display

The repository includes several complete example projects:

• Demo - Comprehensive demonstration of all Gin features
• Synth - Complete synthesizer plugin example
• Effect - Audio effect plugin example
• UnitTests - Test suite for Gin components

cd Gin
cmake -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build

The built applications will be in build/examples/.

#include <gin/gin.h>

// Use the download manager
gin::DownloadManager dm;
dm.downloadAsync(juce::URL("https://example.com/file.zip"),
                 [](juce::InputStream* stream) {
    // Process downloaded data
});

// Watch a directory for changes
gin::FileSystemWatcher watcher;
watcher.addFolder(juce::File::getSpecialLocation(
    juce::File::userDocumentsDirectory));
watcher.addListener(this);

// Use a spline for smooth interpolation
gin::Spline spline;
spline.addPoint({0.0f, 0.0f});
spline.addPoint({1.0f, 1.0f});
float interpolated = spline.get(0.5f);

• Discord Community - Get help and discuss Gin
• Developer Blog - Tutorials and articles
• Doxygen API Documentation - Complete API reference

Bug fixes occasionally change audible behavior or APIs. See BREAKING_CHANGES.md before updating Gin in an existing plugin.

Gin incorporates and builds upon several excellent open-source libraries and algorithms:

• JUCE by Roli - The foundational framework
• Stack Blur by Mario Klingemann - Fast blur algorithm
• muParser by Ingo Berg - Mathematical expression parser
• Spline by Devin Lane - Cubic spline interpolation
• AVIR by Aleksey Vaneev - Image resizing
• easywsclient - WebSocket client implementation
• mbed TLS - SSL/TLS library
• Least Squares Regression - Curve fitting algorithms

reFX Audio Software Inc. for supporting the development of Gin.