Lua Protoplug

[home] [downloads] [API docs]


These are archives containing the compiled VST/AU, and a collection of scripts. The latest binary release is 1.1.0. These and older releases are hosted on Github.

Windows x32, 4.4 MB

Windows x64, 5 MB
OSX Intel x32
protoplug-1.1.0-osx.pkg, 3.8 MB

(x64, see below)
Linux i386
protoplug-1.1.0-linux-i386.tar.gz, 7.8 MB

Linux amd64
protoplug-1.1.0-linux-amd64.tar.gz, 7.7 MB
Source .zip, 5.5 MB

Source .tar.gz
protoplug-1.1.0.tar.gz, 4.5 MB

Installing - Making it Work

Here's an overview of what a protoplug install looks like :
  • My Plugins Folder
    • protoplug
      • effects
      • generators
      • include
      • lib
      • themes
    • Lua Protoplug Fx.dll
    • Lua Protoplug Gen.dll
  • -- this folder stays alongside the plugins
  • -- folder containing Lua effect scripts
  • -- folder containing instrument scripts
  • -- Lua includes
  • -- binary shared libraries (eg. fftw)
  • -- .dll, .so, or .component depending on platform
  • -- .dll, .so, or .component depending on platform

Windows : Extract the release zip to your VST folder (eg. C:\Program Files\Cubase\VSTPlugins). You can now load protoplug in your host.

Linux : protoplug is also a native Linux VST (.so). There is no standard install location for Linux VSTs, but you can copy the whole thing to /usr/lib/vst for example.

OSX : The OSX version is a polyglot AU/VST plugin. It's not available as 64-bit, as LuaJIT doesn't support it properly. However, any advanced 64-bit host should still load the plugin in bridged mode. Otherwise, try launching the host in 32-bit mode.

Note: If you wish to install the 32-bit and 64-bit versions on the same system, and want them to share the same script folders, you can create symbolic links to the canonical folders. However, don't forget that the lib folder contains architecture-specific files.

Compiling from Source

Get the development version from the repository.

The source is C++ and only requires system headers. In the source's MetaBuilds folder, there are various kinds of project files allowing you to build the effect and instrument in one shot. (The Introjucer is used to create the basic projects and makefiles.)

After compiling, you'll also need the LuaJIT shared library installed on your system or in the protoplug/lib folder. The same goes for FFTW if you want to load scripts that use that library.

Linux :
The easiest is to grab the binaries above, but you can also compile it :
tar zxf protoplug-1.1.0.tar.gz
cd protoplug-1.1.0/MetaBuilds/Linux
You might get some missing includes. The required headers should be easy to obtain, for example on Debian 7 :
sudo apt-get install libfreetype6-dev libx11-dev \
 libasound2-dev libxinerama-dev libxcursor-dev


A script repository is planned if there are ever enough contributed scripts. For now, all the scripts are in the standard distribution's effects and generators folders :

 Scripts on Github