User Manual



VirtualDJ comes with predefined mappings for most of the MIDI/HID DJ Controllers on the market. Mappings can be easily changed and tweaked to preference. Controllers are available only if a Pro Full Infinity, Pro Monthly subscription, or a controller specific license is available (See Licenses), otherwise the controller will work only for the first 10 minutes of use when the software is initially launched.

To check if your controller is natively supported please see Supported MIDI and HID Controllers in VirtualDJ

  1. KEYBOARD - By default, the computer keyboard is already mapped. It is displayed with all the key functions. In 2 Deck mode blue keys control the left deck, while red keys control the right deck. If in 4 deck mode the addition of green and orange are added to differentiate the difference between decks. Keys that have no color code are global and control universal functions such as the crossfader.

    Clicking on a key will bring up the simple mapping editor which provides the ability to change the function of that specific key.

    The Editor displays the Key combination at the top, current mapping (Action), as well as displays a list of categories and actions that can be clicked on for quick mapping. Clicking on the Save button will save any changes to the mapping. A Documentation Button is also included to learn more about script actions.

  2. EXTERNAL CONTROLLER(S) - Each external controller connected to the computer will have it's own tab which provides quick setup and documentation links.

    Clicking on Setup & Drivers will open a browser tab to the online manual setup page for that particular device.

    Clicking on Controls will open a browser tab to the online manual controls page for that particular device.

    Displays the current EQ setting for the device. Clicking on the EQ mode will open the Hardware EQ Mode in the software.

    Clicking on Edit Mapping will open the advanced editor for the selected device.

    Clicking on the gear icon will open the Options menu with specific settings for the selected device.

    The connection icon provides the status of the device. When the controller is fully connected the icon will display in green. Clicking on the icon will provide options to reconnect devices, rescan for devices, and offer the ability for Midi Clock Output and/or Midi to VST.

  3. PHONE/TABLET - Used to connect the VirtualDJ Remote Application to the software.

  4. MISSING CONTROLLER? - This section is used to rescan for devices, list all compatible devices, and displays advanced features with connected devices. Clicking on a listed device in the menu will provide setup and documentation (if available), as well as the ability to edit the mapping of the device.

  5. KEYBOARD MAPPER OPTIONS - The dropdown menu provides the ability to change the keyboard mapper. There are 4 included mappers to chose from: Default, Default (Legacy), Default (Rekordbox compatible), and Default (Serato compatible). An Ignore option is also provided in order to disable the keyboard from using shortcuts if desired.

  6. ADVANCED EDITOR - Opens the keyboard's advanced mapping editor. This is identical to the Edit Mapping feature for controllers with the exception of Deck Assignment and MIDI Activity.


  1. DEVICE TAB - Displays the name and thumbnail of the current selected device.

  2. DEVICE NAME - Provides the name of the current selected device.

  3. MAPPING LIST - Each connected device offers Factory default mapping and Ignore in the Mapping Dropdown. Set a device to Ignore in order to use it with a different application while running VirtualDJ at the same time. If a Custom Mapping is available, it can also be selected.

  4. DECK ASSIGNMENT - Assigns the decks to be controlled by the connected device. Automatic is the default which allows VirtualDJ to assign the decks automatically as it is the most common.

  5. SAVE/DELETE - Save and Delete buttons are available to the left of the Mapping dropdown to save and delete altered or custom mappings.

  6. KEY LIST - All mapped keys and their assigned actions are displayed. Clicking on a key in the list will populate the KEY field and show it's mapped action in the ACTION field.

  7. KEY - Displays the current selected key from the KEY LIST or can be selected from the dropdown menu.

  8. MIDI ACTIVITY - Any button, dial or slider touched on the controller will appear in this window. Clicking on it will populate the KEY field.

  9. ACTION - Displays the current action mapped to the key and can be edited.

  10. CATEGORY SELECT - Displays commonly used categories to assist with scripts and populates the ACTION SELECT window based on the category selected.

  11. ACTION SELECT - Displays commonly used scripts based on the category selected. Clicking on a script will add it to the KEY chosen for easy custom mapping.

  12. DESCRIPTION - Provides a description of the current script. Additionally, there is a mapping tool (eye dropper) to the lower left of the box to easily pick out skin elements that a button could be mapped to, and automatically mapping the button with a few mouse clicks. To the lower right is a Documentation... button that will open a web browser and provide more details about VirtualDJ script actions and syntax.


1. Select Edit Mapping from the device window.

2. In the Mapping list, make sure the Default (factory) mapping is selected.

3. Select a Key from the list or use the Key learn feature. Press a button or move a slider on the controller. The name of that Key will display in the Key Learn List to the right. Select the Key you need to customize.

4. Edit or type a VirtualDJ script action in the Action field. Actions are grouped into categories and each action provides a short description and some syntax examples.
Clicking on the action will automatically add it to the script to make the mapping process more convenient.

5. Alternatively, once the key is selected you can click on the eyedropper tool to the left. This will open the user interface.

6. Click on the part of the skin (play button, sync button, etc) that you wish to assign to the selected key. The skin element will be automatically mapped to the button.

Once a key is modified, a custom mapping will be auto-created, leaving the default (factory) mapping unaltered in order to use and modify again if needed. Once complete, it can be kept either using the auto-generated name or renamed when saving the
mapping file.


VirtualDJ's Master Tempo can be sent to other applications such as Lighting or Digital Audio Workstations that accept a Midi Clock Input. Right-click any connected controller in the device window to assign it as the Midi Clock Output.

Any defined Midi device can be used and will send VirtualDJ's current master tempo to the other application.

The other application will need to be configured to accept a Midi Clock Input in order for the information to be passed through to it. Please consult the documentation of the software that you wish to send VirtualDJ's Midi Clock to in order to configure it properly.


MIDI devices such as MIDI Keyboards can be set up to control VSTs through a deck. Right clicking the device in the Controller settings will bring up an option for MIDI to VST. You can then select which deck the VST will be controlled by the device when it is activated.

This setup is pass through. Mapping for the device is handled by the selected VST (if offered).

map, mapping, mapper, remap, controller, keyboard, midi, hid Options