Repository files navigation

JUCE is an open-source cross-platform C++ application framework for creatingdesktop and mobile applications, including VST, VST3, AU, AUv3, AAX and LV2audio plug-ins and plug-in hosts. JUCE can be easily integrated with existingprojects via CMake, or can be used as a project generation tool via theProjucer, which supports exporting projects for Xcode (macOSand iOS), Visual Studio, Android Studio, and Linux Makefiles as well ascontaining a source code editor.

The JUCE repository contains amaster anddevelop branch. Thedevelop branch contains the latest bug fixes and features and is periodicallymerged into the master branch in stabletaggedreleases (the latest releasecontaining pre-built binaries can be also downloaded from theJUCEwebsite).

JUCE projects can be managed with either the Projucer (JUCE's ownproject-configuration tool) or with CMake.

The repository doesn't contain a pre-built Projucer so you will need to build itfor your platform - Xcode, Visual Studio and Linux Makefile projects are locatedinextras/Projucer/Builds (the minimum systemrequirements are listed in theminimum systemrequirements section below). The Projucer canthen be used to create new JUCE projects, view tutorials and run examples. It isalso possible to include the JUCE modules source code in an existing projectdirectly, or build them into a static or dynamic library which can be linkedinto a project.

For further help getting started, please refer to the JUCEdocumentation andtutorials.

Version 3.22 or higher is required. To use CMake, you will need to install it,either from your system package manager or from theofficial downloadpage. For comprehensive documentation on JUCE'sCMake API, see theJUCE CMake documentation. Forexamples which may be useful as starting points for new CMake projects, see theCMake examples directory.

To use CMake to build the examples and extras bundled with JUCE, simply cloneJUCE and then run the following commands, replacing "DemoRunner" with the nameof the target you wish to build.

cd /path/to/JUCEcmake . -B cmake-build -DJUCE_BUILD_EXAMPLES=ON -DJUCE_BUILD_EXTRAS=ONcmake --build cmake-build --target DemoRunner

• C++ Standard: 17
• macOS/iOS: Xcode 12.4 (Intel macOS 10.15.4, Apple Silicon macOS 11.0)
• Windows: Visual Studio 2019 (Windows 10)
• Linux: g++ 7.0 or Clang 6.0 (for a full list of dependencies, seehere).
• Android: Android Studio (NDK 26) on Windows, macOS or Linux

• macOS: macOS 10.11 (x86_64, Arm64)
• Windows: Windows 10 (x86_64, x86, Arm64, Arm64EC)
• Linux: Mainstream Linux distributions (x86_64, Arm64/aarch64, (32 bit Arm systems like armv7 should work but are not regularly tested))
• iOS: iOS 12 (Arm64, Arm64e, x86_64 (Simulator))
• Android: Android 7 - Nougat (API Level 24) (arm64-v8a, armeabi-v7a, x86_64, x86)

Please see ourcontribution guidelines.

SeeLICENSE.md for licensing and dependency information.

AAX plug-ins need to be digitally signed using PACE Anti-Piracy's signing toolsbefore they will run in commercially available versions of Pro Tools. Thesetools are provided free of charge by Avid. Before obtaining the signing tools,you will need to use a special build of Pro Tools, called Pro Tools Developer,to test your unsigned plug-ins. The steps to obtain Pro Tools Developer are:

1. Sign up as an AAX Developerhere.
2. Request a Pro Tools Developer Bundle activation code by sending an email todevauth@avid.com.
3. Download the latest Pro Tools Developer build from your Avid Developeraccount.

When your plug-ins have been tested and debugged in Pro Tools Developer, and youare ready to digitally sign them, please send an email toaudiosdk@avid.com with the subject "PACE EdenSigning Tools Request". You need to include an overview of each plug-in alongwith a screen recording showing the plug-in running in Pro Tools Developer, withaudio if possible.

Please also include the following information:

• Company name
• Admin full name
• Telephone number

Once the request is submitted, PACE Anti-Piracy will contact you directly withinformation about signing your plug-ins. When the plug-ins have been signed, youare free to sell and distribute them. If you are interested in selling yourplug-ins on the Avid Marketplace, please send an email toaudiosdk@avid.com.