VDJPedia



 Developers

********************************

DEVELOPER SDK

********************************


VirtualDJ offers a high level of customization. In addition of a long list of internal options, you can create your own interface or add some new features to VirtualDJ thanks to a SDK (Software Development Kit) defined for the following part of the software:
  • Skins
  • Translations
  • Controllers
  • Effects / Plugins

/!\ All the XML files listed below use UTF-8 encoding

________________________________________________________________________________________________________________

SKINS

________________________________________________________________________________________________________________


This section is dedicated to the creation or modification of a skin. A skin is a .zip file containing mainly the following files:
  • the_name_of_your_skin.bmp (other picture formats are available)
  • the_name_of_your_skin.xml

Default Skin : VirtualDJ 8.zip
(for those who wish to get the skin without installing the application)



Please click on the links below for more details on the Skin SDK for each version:
The skin must be copied in the following folders:
[PC].\Documents\VirtualDJ\Skins\
[Mac]


Useful Tools:
Skin Creator Tool
Skin Resizer Tool

/!\ Because of the changes in the Skin SDK v8, the Skin Creator Tool and the Skin Resizer tool require updating in order to work with VirtualDJ 8. These will probably be updated in due course.

________________________________________________________________________________________________________________

TRANSLATIONS

________________________________________________________________________________________________________________


This section is dedicated to the creation or modification of a translation. Translations in VirtualDJ are composed of .xml files:
  • the_name_of_your_language.xml


The translation must be copied in the following folders:
[PC] .\Documents\VirtualDJ\Languages\
[Mac]

________________________________________________________________________________________________________________

CONTROLLERS

________________________________________________________________________________________________________________


A controller in VirtualDJ is defined by two XML files, a "definition" file and a "mapping" file.
The definition file gives a human-readable name to every MIDI code or HID zone.
The mapping file associates each name of the definition file with an action in VDJscript.

Many controllers already have a definition file embedded inside VirtualDJ.
If you have a controller that is not recognized natively by VirtualDJ, or if you are a manufacturer working on a new controller, it is very easy to create a new definition file for this controller.

Please click on the link below for more details on the Controller SDK:

Controller SDK

The definition file must be copied in the following folders:
[PC] .\Documents\VirtualDJ\Devices\
[Mac]

The mapping file must be copied in the following folders:
[PC] .\Documents\VirtualDJ\Mappers\
[Mac]

________________________________________________________________________________________________________________

EFFECTS / PLUGINS

________________________________________________________________________________________________________________


Plugins in VirtualDJ are .dll (or .bundle on Mac) files that extend the functions of the software.

In order to create a plugin, you will have to use a compiler that let you create .dll or .bundle files.
On Windows, you can use the free Microsoft Visual Studio Express. On Mac, you can use the free XCode.
Plugins in VirtualDJ look a lot like COM objects, so any languages that can create COM objects can create a plugin for VirtualDJ (Visual Basic, C#, etc).
Still, we highly recommend to use C++, since that's the native language of the header files, and that's also the language in which you'll find all the help on the forums here.

Once you are ready to start creating your plugins, you'll need to download and include the header files that define the basic plugin structure.

You have 4 main categories of plugins:
  • General plugins: Plugins that are loaded on startup and perform actions on their own.
  • Dsp plugins: Audio effects that interact with the sound.
  • VideoEffect plugins: Video effects that add some special effect to the video output.
  • VideoTransition plugins: Video effects that define a new way to crossfade from one video to another.

You need to make your own plugin derive from the interface class IVdjPluginXXXX.
Then you should implement the DllGetClassObject() function to return a new instance of your plugin's class (derived from the IVdjPluginXXXX class).

List of GUID used for VirtualDJ plugins

The plugin must be copied in the following folders:
[PC] .\Documents\VirtualDJ\Plugins\{Sub-Folder} for VirtualDJ - 32bit (dll in 32bit)
[Mac] ./Documents/VirtualDJ/Plugins64/{Sub-Folder} for VirtualDJ - 64bit (bundle in 64bit)

where {Sub-Folder} depends on the nature of your plugin

Plugin SDK v8 - VirtualDJ 8 What's new?


Examples of source code:



Plugin SDK v6 - VirtualDJ 6 & 7

  • vdjPlugin.h (basic common base-class for all plugins)
  • vdjDsp.h (base classes for all Dsp plugins)
  • vdjVideo.h (base classes for all Video plugins - DirectX (Windows) version)
  • vdjVideo_mac.h (base classes for all Video plugins - OpenGL (Mac) version)


Plugin SDK v5 - VirtualDJ 5


Plugin SDK v2 - VirtualDJ 2


Wiki HOME