Even though this is the first of the VanillaJuce “technical topics”, this one isn't entirely technical. It's a tour through the slightly-scary process you have to go through to get started doing anything technical with JUCE.

As you should understand, and as will become abundantly clear very soon, the good people at Roli Ltd. are in business after all, so the JUCE library is quite definitely not free. They do, however, offer two free options (“Personal” and “Education”) which allow people to get started with JUCE without having to pay for a commercial license, and these options involve certain conditions to which you'll have to agree, whether you like it or not. JUCE is their commercial product, and they make the rules—though if you investigate the details, you'll probably agree that their rules and conditions are quite reasonable.

If you haven't already installed JUCE, go to https://www.juce.com and hit the “Get JUCE” button at the top of the page. This will take you to an information page that explains Roli's licensing options, with “download” and “purchase plan” links for the various choices. If you're just beginning to explore JUCE, you can simply choose the “download” link at the bottom of the “Personal/Free” column, which takes you straight to the Downloads page. Click the appropriate button for the platform you'll be starting out on: Mac, Windows, or Linux. These instructions were prepared using Windows, but the other platforms will be very similar.

All three download buttons will put a .zip file into your Downloads directory, the contents of which differ only very slightly from one platform to the next. I did my downloading in August, 2017, shortly after the release of JUCE “Huckleberry” version 5.1; if you're reading this page much later, there might be a newer JUCE release with slight differences from what's shown below, but the basic structure is likely to be the same.

When I opened up the file juce-huckleberry-windows.zip (I used 7-Zip, but any other archive manager, including the default one built into Windows, will look about the same), I saw that the zip file contained exactly one folder, called JUCE, whose contents look like this:

You can unzip this JUCE folder wherever you wish; on my Windows PC, which has several drives, I put it in D:\Documents\VST Development\JUCE. As you'll see shortly, the Projucer allows you to specify wherever you decide to put it. However, your life will be

Wherever you decide to put the JUCE folder on your system, navigate to it and you'll see the icon for Projucer.exe (it will be called simply “Projucer” on Mac or Linux), which you double-click to open the Projucer application.

The very first time you run the Projucer, the first thing you'll see is this rather scary thing:

This makes it pretty obvious that you aren't going to get any further unless you sign up for a developer account with Roli, so if you haven't done so already, you can click on “I do not have an account” at the bottom, and you'll be presented with a form that looks like this:

After you fill in all the fields, scroll down, click the “I would like to receive the latest news from Roli” if you wish, and hit the big green Register button, you get this:

You have to check the “I agree to the privacy policy and JUCE 5 EULA” to go any further, so now would be a good time to review them by clicking on the links. Both are pretty reasonable. Once you do check the “I agree” box, the four license-option buttons appear—click on Personal, and then you'll be able to click on the “Continue” box at the bottom, wherupon you'll see this page:

Click the “START USING JUCE” button at the bottom, and you'll finally be able to get started… Whoops! Nope, one final hurdle:

Once again, you have no real choice, so click OK, and finally, finally, you can really get started using the Projucer. For the details, move on to this page.