A controller in VirtualDJ is defined by two 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 with an action in VDJscript.
Many controllers already have a definition 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.
The definition files are standard XML files, and must be installed in the MyDocuments/VirtualDJ/Devices/ folder on PC or /users/YOURNAME/Documents/VirtualDJ/Devices on Mac.
The syntax of the definition file depends on the interface used (HID or MIDI):
- Controller Definition syntax for MIDI in Version 7
- Controller Definition syntax for HID in Version 7
The mapping files are also standard XML files, and must be installed in the MyDocuments/VirtualDJ/Mappers/ folder on PC or /users/YOURNAME/Documents/VirtualDJ/Mappers/ on Mac.
Mapping files for the built-in (Native supported) controllers will only appear in this folder if they have been modified by the user via CONFIG -> Mappers in VirtualDJ.
- Differences between HID and MIDI protocols
- How to implement a HID firmware
Back to VirtualDJ Developer page