tobiaskozel/guitard

Node based multi effects audio processor

GuitarD

It's a basic multi effects processor which follows a node based approach. It's fairly unstable and experimental but contains most of the important features. This whole thing started as my bachelors thesis, but I plan on developing it further to a point where it's usable.

Super rough demo of a few tones/effects that come with it

Builds

See here

I'm not responsible for any crashes or hearing loss. (Seriously, be careful)

The preset and cabinet library go online to fetch thier stuff.

So if a preset sounds different it might be because it couldn't fetch the IRs from the server. You can manually copy the IRs in the GuiutarD/ir_cache in your systems homefolder.

How to use

In progress. Have a look at ./manual/guitard manual.pdf

Compilation

The Plugin

To build a plugin you'll need this fork of iPlug2 and switch to the guitard branch there.

To get iPlug2 up and running, make sure all its dependencies are downloaded. Run both of these shell scripts (use git bash on windows):

iPlug2/Dependencies/download-prebuilt-libs.sh

iPlug2/Dependencies/IPlug/download-iplug-libs.sh

After that, simply clone this repository into the Examples folder of iPlug2 and open the IDE project for your platform.

You'll still have to generate the C++ code from FAUST as described below.

The VST/AU plugin works on Windows and Mac OS X. For 32 Bit support another renderer than SKIA has to be used. Head over to the iPlug2 Wiki for more info about the graphic backends.

Only the DSP

Make sure the FAUST compiler is installed and in your PATH environment variable (this should be the default case). Run python ./scripts/compile_faust.py to compile all the DSP code.

The DSP code can be compiled without iPlug and the GUI so it can be included in other projects easily. Just include ./src/headless/headless.h and you should be good to go. Everything is header only to make the code as portable as possible. The headless version was testet on Windows (MSVC, gcc), Mac OS X (clang) and Linux (gcc, clang).

A small demo using the systems default audio devices as in and output can be found here:

https://github.com/TobiasKozel/GuitarD/blob/master/src/headless/device.cpp

The readme besides it contains some info about compiling it.

There are currently some things that might need fixing, in order for the code to be as robust as a header only library should be, since I'm no C++ expert. Mainly #6 and #7

guitard's Issues

Multi channel in and ouptut

Deseralization seems to screw with the window size and scale

Custom allocator

When integrating the dsp into for example wwise, there should probably be a way to use their allocation functions.

In out nodes are deletable

Controls with no IParam behave wierd

• Reset to default value does not work
• Won't display typename like Hz or ms
• Nonlinear scaling does not work properly for all types

Local presets

Allow having presets on disk

Own knob control class

The class should wrap ParameterCouplings and also be able visualize the automation state.

Allow syncing the phase tool and delays to project bpm

Crash when splicing in a Node right before the output

Might be a threading issue

Deleting a LFO can crash the dsp

Be on the Powered by Faust page ?

Would you be interested to be on the Powered By Faust page ?. How stable is the project ?

Samplerates below 44100 seems to be causing issues with reverbs

Inline globals

There are a few global variables which might cause issues when using the dsp from different compilation units.

Volume Knobs for input and output nodes

Replace the eq

The current eq is hard to control, doesn't sound good and uses a good chunk of CPU.
Smaller nodes with only highpass, lowpass, peaks each might also be useful.

Bypass seems to be inverted when loading a preset

Make space when splicing in a node