======MacOSX Building Howto======

**NOTE: OSX only currently compiles on the develop branch!**

Clone the project in read-only mode:
<code>
git clone --branch develop --recursive git://git.drumgizmo.org/drumgizmo.git
</code>

Make sure autotools are installed and up-to-date. The simplest way to do this is using Homebrew:
<code>
brew install autoconf automake libtool
</code>

Now install the dependencies:
<code>
brew install pkg-config libsndfile jack lv2
</code>

=====Download VST sources=====
You need to download the VST sources yourself from the Steinberg website,
since we are not allowed to redistribute them through our git repo.
[[https://www.steinberg.net/en/company/developers.html]]

It is needed to rename the "VST SDK" folder so it doesn't contain a space otherwise the build-system will complain.

IMPORTANT: The sources supplied by Steinberg has been reported to no longer contain the VST2 SDK sources, so an older version must be obtained from another source in order to be able to compile DrumGizmo with VST support!

Archive.org has a copy here: https://archive.org/download/VST2SDK/vst_sdk2_4_rev2.zip
=====Compiling=====
Run autogen:
<code>
./autogen.sh
</code>

Set paths:
<code>
export PKG_CONFIG_PATH=/opt/homebrew/Cellar/libsndfile/1.0.31/lib/pkgconfig
</code>

Configure with cli enabled:
<code>
./configure \
  --enable-input-jackmidi \
  --enable-output-jackaudio \
  --disable-output-alsa \
  --disable-input-midifile \
  --enable-cli \
  --without-debug \
  --without-test \
  --enable-vst \
  --with-vst-sources=/path/to/vstsdk2.4 \
  --enable-lv2 \
  --prefix="$PWD/sysinstall"
</code>

Or configure with just the vst and lv2 plugins:
<code>
./configure \
  --disable-cli \
  --without-debug \
  --without-test \
  --enable-vst \
  --with-vst-sources=/path/to/vstsdk2.4 \
  --enable-lv2 \
  --prefix="$PWD/sysinstall"
</code>

Build it:
<code>
make
make install
</code>

=====Making VST discoverable by hosts=====
To make use of the VST plugin, the ''drumgizmo_vst.so'' file inside ''$PWD/sysinstall'' must be symlinked to the folder containing VST plugins under the name ''drumgizmo.vst.dylib''.