In HISE under File->Preferences set the HISE Path and JUCE Path for the export mechanism to work correctly. If you use Windows or want to use a different library location than the Faust compiler expects, you also have to tell HISE where your installation of Faust is. To do that set the Faust Path according to the config help text. Also (on Windows only) you need to copy the faust.dll from your Faust installation into the directory of your HISE executable.

With Faust integrated into HISE, you can now add Faust nodes into a ScriptFX network. At the time of writing Faust in HISE can only be used for (monophonic) effects. Sound generator support (monophonic and polyphonic) is planned to be added not too far in the future, though. In the Faust node you can add or import new Faust source files and libraries into the current HISE project. Their file names must be valid C++ class identifiers, i.e., they may only contain alpha-numeric characters and the underscore _ and may not start with a digit. After you added a file it will be copied to your project directory and appear as a choice in the node's drop-down menu for all Faust nodes in your current project. Once you select a file from the drop-down menu, HISE will try to compile it on-the-fly and start processing audio right away. It'll show an error in the log if there were any problems while compiling.

Parameters you define in your Faust code appear in the Faust node automatically if the compilation was successful. They can be modulated just like any other parameter in HISE.

While there is no integration into HISE's IDE features yet, there is a button to open the file in your text editor of choice and another one to recompile.

When the faust code is ready and you want to release the project or when you need a slight performance boost over the just-in-time compiled code, you can also export the node and network and compile it statically. HISE has had that feature already for SNEX code and I was able to extend it for Faust node as well. Allow compilation for your ScriptFX network by right-clicking its title bar and enabling the corresponding option, then save the network. Click Export->Compile DSP Networks as dll and confirm that the network is present. You can open the generated Projucer project file and compile the library with your native toolchain as usual. When you start HISE afterwards, it'll find the dll and allow you to use the network and faust nodes in HardcodedFX and as separate nodes in ScriptFX without having to just-in-time compile the code again.

The build process on Linux is quite straight-forward. You need GCC or Clang, the Projucer build tool, which comes with JUCE and Faust (Version 2.50.6 or later) installed. If available you should prefer the faust package that comes with your distributions package manager. You can also download it directly if you want to build it from source. If you want to use Intel's IPP library, that needs to be installed, too.

Open the project file projects/HISE Standalone.jucer with Projucer. Under Modules enable the config options HISE_INCLUDE_FAUST and HISE_INCLUDE_FAUST_JIT for the hi_faust module. It's also recommended to enable the LLVM backend for much better performance: HISE_FAUST_USE_LLVM_JIT. Depending on if you want to use Intel's IPP library, you can enable or disable its usage in HISE. Select Exporters->Linux Makefile on the left and check if USE_IPP is set to the correct value, 0 is disabled, 1 is enabled. If in doubt, disable it. On the same page you also need to add faust to External Link Libraries. Finally press CTRL-s to save.¹

You can now go to projects/standalone/Builds/LinuxMakefile/. If you have nproc installed run the following command to make a Release build if you just want to use HISE:

make CONFIG=Release -j$(nproc)

Otherwise just type in the number of cpu cores you have by hand, e.g., -j8. If you want to develop and/or debug HISE, a Debug build makes more sense:

make -j$(nproc)

There should now be a binary build/HISE Standalone. Start Jack and then HISE and have fun!

To build HISE with Faust under Windows you need Visual Studio 2017 installed as well as Faust 2.50.6 or later. JUCE already comes with HISE, so you don't need to download it separately. If you don't want to download everything by hand, I recommend you use chocolatey, a package manager for windows.

If you want a bit of UNIX and/or need git, you can also install

Faust is not yet available in chocolatey, so you have to download and install it manually.

You need to add some paths to the "VisualStudio 2017" exporter in Projucer. Open the project file projects/HISE Standalone.jucer with Projucer. Under Exporters->Visual Studio 2017 you need to add faust.lib to External Link Libraries. Add the path to the include directory inside your Faust installation (e.g., C:\Program Files\Faust\include) to the Header Search Path for both the Debug and the Release configuration for Visual Studio 2017. Similarly add the lib directory (e.g., C:\Program Files\Faust\lib) to the Extra Library Search Paths. Under Modules enable the config options HISE_INCLUDE_FAUST and HISE_INCLUDE_FAUST_JIT for the hi_faust module. It's also recommended to enable the LLVM backend for much better performance: HISE_FAUST_USE_LLVM_JIT. Finally press CTRL-s to save.

In Projucer click the Visual Studio symbol near the top of the window to open the project in Visual Studio. There you can make a Release build if you just want to use HISE or a Debug build if you want to debug and/or develop. Afterwards you need to copy the faust.dll from your Faust installation into the directory of your HISE executable.

HISE isn't natively compatible with Apple's ARM processors, yet, but it runs well with the compatibility translation layer. In order to build HISE with Faust on macOS you need Xcode and Faust (Intel x86_64) installed. If you want to use Intel's IPP library, that needs to be installed, too.

After downloading and extracting the Faust archive, open the Exporters pane. Under Exporters->Xcode you need to add faust to External Link Libraries. You need to add the paths to its include and lib directories to Projucer's Header Search Paths and Extra Library Paths respectively for both the Debug and Release configuration for Xcode. In addition you need to add the lib path with the -rpath option to the Extra Linker Flags:

-rpath /adjust/this/to/your/path/to/faust/lib

Also check if USE_IPP is set to the correct value, 0 is disabled, 1 is enabled. If in doubt, disable it. In the Modules pane enable the config options HISE_INCLUDE_FAUST and HISE_INCLUDE_FAUST_JIT for the hi_faust module. It's also recommended to enable the LLVM backend for much better performance: HISE_FAUST_USE_LLVM_JIT. Finally press CTRL-s to save.

In Projucer click the Xcode symbol near the top of the window to open the project in Xcode. There you can make a Release build if you just want to use HISE or a Debug build if you want to debug and/or develop.