Build Status macOS / Windows (
The open source framework for sample based instruments.
HISE is a cross-platform open source audio application for building virtual instruments. It emphasizes on sampling, but includes some basic synthesis features for making hybrid instruments as well as audio effects. You can export the instruments as VST / AU / AAX plugins or as standalone application for Windows / macOS or iOS.
- Windows 7+
- OSX 10.7+
- iOS 8.0+
- Linux (experimental, tested on Ubuntu 16.04 LTS)
HISE is tested on Windows and OSX with the following hosts:
- Ableton Live
- REASON 10
- FL Studio
- Presonus Studio One
It supports x86 and x64 on Windows, altough the 64bit version is highly recommended (it uses memory mapping for accessing samples and because of the limitations of the 32bit memory address space it needs a slower fallback solution).
How to compile HISE
Windows / OSX
Clone this repository. It also includes the (slightly modified) JUCE source code, so it might take a while.
Get all necessary 3rd party code:
Open the Projucer (there are compiled versions for every supported OS in the
tools/projucersubdirectory) and load the HISE project (either
Make sure the VST / ASIO path settings is correct on your system. If you don't have IPP installed, set the USE_IPP flag in the hi_core module to 0.
Click on "Save Project and open in IDE" to load the project in XCode / Visual Studio.
Hit compile and wait...
Install xcpretty on OSX
xcpretty is a formatter for xcode. You can install it from the terminal using the command
sudo gem install xcpretty.
Compiling without IPP on OSX
If you don't have Intel Performance Primitives installed on your machine, you need to change the Projucer file. Open the
.jucer file in the Projucer (like in step 3 above), click on the Xcode (MacOSX) target and delete this from the Extra Linker Flags field:
/opt/intel/ipp/lib/libippi.a /opt/intel/ipp/lib/libipps.a /opt/intel/ipp/lib/libippvm.a /opt/intel/ipp/lib/libippcore.a
Then remove the include directories from the Debug and Release configurations (Remove everything in the Header Search Paths and Extra Library Search Paths. As last step, you'll need to change the
USE_IPP flag. Click on the
hi_core module and change the
USE_IPP field to disabled. Then proceed with step 5...
- Get these dependencies (taken from the JUCE forum):
sudo apt-get -y install llvm clang libfreetype6-dev libx11-dev libxinerama-dev libxrandr-dev libxcursor-dev mesa-common-dev libasound2-dev freeglut3-dev libxcomposite-dev libcurl4-gnutls-dev libwebkit2gtk-4.0 libgtk-3-dev libjack-jackd2-dev
Clone this repository.
Open the Projucer (a precompiled Linux binary can be found at
tools/projucer). Load the project
projects/standalone/HISE Standalone.jucerand resave the project (this will generate the Makefile with correct Linux paths).
Open the terminal and navigate to this subdirectory:
make CONFIG=Releaseand wait. If you need the debug version (that is slower but allows you to jump around in the source code, use
HISE is licensed under the GPL v3, but there will be a commercial license for closed source usage. Every instrument you'll build will inheritate this license so in order to release a closed source product you'll have to obtain a HISE commercial license as well as a JUCE commercial license. Please get in touch with me for further informations.
For FFT routines and some vector operations, it is recommended to build HISE against the Intel IPP library (not included).
Apart from the JUCE C++ library, there are some other 3rd party frameworks and libraries included in HISE, which are all non restrictively licenced (either BSD or MIT):
- ICSTDP DSP library: A pretty decent DSP library with some good and fast routines. Website
- Kiss FFT: A easy and C-only FFT library with a clean interface and acceptable performance. It is used as fallback FFT when the IPP library is not available.
- FFTConvolver: a library for fast, partitioned real time convolution: https://github.com/HiFi-LoFi/FFTConvolver
- MDA Plugins: a collection of audio effects recently published as open source project.
- some other public domain code taken from various sources (http://musicdsp.org, etc.).
The best place to get support for anything related to HISE is the user forum: https://forum.hise.audio/