MOD Plugin Builder
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
docker
global-packages
lv2-data @ bc731ed
patches
plugins-dep
plugins/package
toolchain
.clean-install.sh
.common
.gitignore
.gitmodules
README.md
bootstrap.sh
build
local.env

README.md

mod-plugin-builder

This repository contains the toolchain and libraries used in MOD Devices.

It allows developers to locally build plugins for MOD Duo and also prepare for Cloud builds.
Currently this builder only supports Linux hosts.
If you're not running Linux see this HowTo.

There are several dependencies:

  • gcc & g++
  • git
  • subversion
  • hg/mercurial
  • autoconf
  • automake
  • bzip2
  • lzma
  • binutils
  • libtool
  • ncurses
  • rsync
  • wget
  • bc
  • bison
  • flex
  • help2man
  • gawk
  • gperf
  • texinfo

If you're running a debian based system you can install all dependencies by running:

sudo apt-get install acl bc curl cvs git mercurial rsync subversion wget \
bison bzip2 flex gawk gperf gzip help2man nano perl patch tar texinfo unzip \
automake binutils build-essential cpio libtool libncurses-dev pkg-config

To begin simply run the bootstrap.sh script.
The bootstrap.sh script will build the toolchain (ct-ng) and buildroot.
Depending on your machine it can take more than 1 hour.

All files will be installed in ~/mod-workdir.
Set the 'WORKDIR' environment variable if you wish to change that.

After the bootstrap process is complete, you can start building plugins.
See the 'plugins' folder in this repository for some examples.

To build a plugin, run:
./build <plugin-package>

If everything goes well, you will have the final plugin bundle in ~/workdir/plugins.
You can use MOD-SDK's 'publish' tab to push those into a MOD Duo.

NOTE: If you want to build the provided plugins in this repository you'll need to enable git submodules, like this:

git submodule init
git submodule update

To cleanup the build of a plugin, run:
./build <plugin-package>-dirclean

If you get an issue under Debian or Ubuntu about missing libtool, like this:

checking for GNU libtool >= 1.5.26... no
configure: error: could not find GNU libtool >= 1.5.26

Please install libtool-bin and re-run bootstrap.sh.

There's a more detailed HowTo explaining how to compile an LV2 Plugin using mod-plugin-builder.

Note about Camomile

The Camomile integration is under testing phase. Check the PR notes for more details.