Home

Awesome

Build Status

WHAT'S THERE ?

Opaz-PlugDK makes it easier/faster to create portable (Mac OS X, Windows, Linux) VST 2 plugins.

You can mix and match JRuby, Duby and Java to implement the plugins.

QUICK COURSE

AVAILABLE EXAMPLES

The examples are under the plugins folder:

DEPENDENCIES

Required:

Optional:

HOW TO BUILD A PLUGIN

See under plugins/ then use the available rake tasks to package one of them:

rake -f build.rakefile package plugin=DubyFreeComp

The package system will create ready-to-use VST for Windows, Mac OS X and Linux under the build subfolder of the plugin.

BUILD ORDER

Things are currently compiled in this order:

PLUGINS STATUS

All the plugins compile and are able to be loaded in Ableton Live, except the Ruby based ones (temporary issue).

GUI SUPPORT

Basic GUI support is included. Example:

class MyEditor
	def initialize(frame)
		frame.setTitle("Hello from DefaultEditor!")
		frame.setSize(400, 300)
	end
end

class MyPlugin < OpazPlug
	plugin "MyPlugin", "Opaz", "LoGeek"
	# ...
	
	editor MyEditor
end

You'll be passed the main container frame so that you can add stuff in it.

LIVE DEBUGGING

Thanks to Daniel309, it's possible to enable live plugin patching through an IRB session.

Tweak tasks/tools.rb around line 90 to enable the IRB debugging editor:

PluginUIClass=IRBPluginGUI

LOGGING

It's often useful to log some informations while creating plugins. You can achieve this by calling "log" from the plugin:

class MyPlugin < OpazPlug
	def some_stuff
		log("message!")
	end
end

The logs end up inside some txt file in the plugin folder.

NOTES

The libs and templates folders are generated using rake prepare:templates and rake prepare:libs. Have a look at the rake file to see more about available tasks (compile, package, deploy).

AUTHORS AND CONTRIBUTORS