Getting Started

To use JUCE, like any other C++ library, you'll need a decent grounding in the C++ language. If you're new to C++, click here for some handy links to learning resources.

First, get yourself a copy of the JUCE repository

Obviously you'll need the code first. Click here for download instructions.

Get Yourself a Compiler

  • If you're using Windows, you'll probably want to install Microsoft Visual Studio (The free "express" versions of VS2010/12/13 are recommended).
  • For Mac and iOS, you'll need to install Xcode.
  • For Linux, you'll need to install the standard dev tools.
  • For Android, you'll need the latest Android SDK and NDK from Google. (If possible, we'd recommend using OSX or Linux rather than Windows, as the Android tools are very Unix-oriented).

Building and running an example app

The repository contains a few example apps in the examples folder.

A good place to start is by building the demo app: you'll find projects for Visual Studio, Xcode, etc in the examples/JuceDemo/Builds folder, and these should open, compile and run without any trouble in your IDE.

Creating a new project

By far the easiest and quickest way to get a JUCE project up-and-running is by using the Introjucer's 'New Project' wizard.

If you download JUCE from this site the Introjucer will be in the root directory. If you download via Github you'll need to build yourself a copy. This is easy, as all the code is there in the JUCE repository. Just open the extras/Introjucer/Builds folder, where you'll find ready-made projects for Xcode, Visual Studio, Linux, etc. These should open and build without any fuss.

Once you're running the Introjucer, just select the "New Project" menu item. It'll walk you though a few basic options and will create a new project for you.

When your new project is open in the Introjucer, its config page lets you add or remove target compilers that you want to use (e.g. Visual Studio, Xcode, etc). On the same page there are buttons which will directly launch your native IDE with the auto-generated files ready to compile and run your app!


Visit the class API documentation and tutorial pages for help learning your way around the codebase!