Docs

Installation

Get HISE

If you havent installed HISE already, grab the latest stable release and get on board!

While Windows and MacOS installers should work right out of the box, a Linux build requires some additional configurations. If you're into that please take a look at the install instructions in the github readme

System Requirements

Recommended:

After installing you should be able to start HISE either as a Standalone or as plugin inside your DAW. With the stable release you should be ready to go and be able to prototype your first instrument and check out HISE. A crucial part is still missing, though:

If you want to compile and export your VSTis and plugins with HISE you'll have to take a few extra steps and install some required software:

Setting up VSTi/plugin compilation

HISE itself does not compile anything by itself, but congregates your HISE-project's scripts and files and outsources the heavy lifting to your system compilers. Thats why you have to install a suitable IDE (Integrated Development Environment) for your OS environment and a some SDKs (Software Development Kits).

Let's get it on: Below is a list of every application required for compiling & exporting virtual instruments with HISE . They are all free, but some require that you register an account at their company's website.

Tool Type Link Explanation
HISE Source Code Github The source code that contains the HISE engine. It's important that the source code version and the HISE version are matching. Clone or download , extract the .zip and put it wherever you want.
IDE Application Visual Studio 2017 for Windows / XCode for macOS
The main application for compiling native applications for each platform. They come shipped with command-line compilers, so if everything runs smooth you don't need to touch the IDE once.
VST SDK Source Code Steinberg Website If you want to compile VST plugins, you'll need to download the VST SDK from Steinberg yourself (for licensing reasons it can't be distributed with HISE ). Grab the VST 3 Audio Plug-Ins SDK from their website and extract it. In the extracted folder you'll find a .bat file that you have to execute. The folder VST3_SDK has to be renamed to VST3 SDK (get rid of that pesky underscore) and be put in your HISE source code folder under HISE > tools > SDK > .
ASIO SDK Source Code Steinberg Website If you are building a standalone application on Windows, you might want to support the low latency ASIO driver. Get ASIO SDK from their website and put the extracted ASIOSDK2.3 in HISE > tools > SDK > , too.
Intel IPP Application Intel Website It's strongly recommended to use this library because it will improve the performance drastically and it's obligatory for the convolution reverb. The community edition is free but you'll have to register at Intel to get the download file.

After installing these programs we're almost ready for compiling plugins with HISE . In a last step we have to point your HISE instance to the HISE source-code via the HISE Path Setting.

Configure the Settings

To access the Settings dialog, choose File -> Settings or click the little gear symbol on the right of the tool-bar. Let's set the HISE Path , which has to point to the root HISE -source-code folder that you downloaded or cloned earlier.

Go to the Compiler Settings section in the HISE Settings Menu. You can insert your path by hand or select the HISE source code folder location with the Browse button.

In the Settings you will encounter many other options to adjust your project. Have a look at HISE Settings to learn more about them.

BTW: There you'll also find the Audio & MIDI Settings to adjust and connect your sound-card, drivers and MIDI Equipment.

Compile the latest HISE

A nice side effect of having installed these tools is that you are now able to compile HISE yourself! In this way you can work with the bleeding edge master or development branch (right now everyone is on scriptnode ) and don't have to wait for upcoming stable build releases. Simply grab the latest version via download or cloning and proceed with the next steps.

HISE ships with an adapted version of the JUCE Projucer that can be found @ HISE/tools/projucer/Projucer . The Projucer is a practical application that allows you to deploy HISE on different platforms in conjunction with your preferred IDE.

Open the Projucer and select (File > Open ) the 'HISE Standalone.jucer' file that you can find in the HISE/projects/standalone/ folder. It will present you with compile (debug/release) options for MacOS, Windows and Linux.

Select the Release Version for your applicable IDE and select File > Save Project and Open in IDE . This will open the latest HISE source code in your IDE (VS, XCode etc..). Hit the Compile -Button (something with a play-arrow) and let the compiler proceed.

A few seconds (and compiler warnings) later a brand-new version of HISE should jump up. You can find the newly compiled executable in HISE\projects\standalone\Builds\VisualStudio2017\x64\Release\App\ .

For Linux systems please take a look at the github readme for further instructions how to build and compile the latest release/development version of HISE .

Installation FAQ