djay Pro supports a wide range of DJ MIDI controllers natively (plug & play) out of the box. Please see our list of natively supported MIDI controllers to check if your controller is already supported in djay.
If you have a MIDI controller that is currently not natively supported by djay Pro AI, you can still use it with djay's easy-to-use MIDI Learn feature. The same feature also allows you to alter the mapping for a natively supported MIDI controller.
Please note, to use djay’s MIDI mapping functionality, an active PRO subscription is required.
Getting started with MIDI mapping
- Launch djay Pro AI.
- Connect the MIDI controller to your Mac.
- An automatic pop-up message will appear in djay alerting you that the device has been found, and asking if you'd like to configure the device now. Click "OK". If you'd like to create a mapping later, you can also access the mapping window by selecting the controller from the "MIDI" menu in the top menu bar.
- The MIDI configuration window for the controller will open, displaying a blank mapping screen.
- To start mapping your first MIDI command, press or move a control (e.g., button, slider, or knob) on your MIDI controller. djay Pro will automatically add the correct note or CC to the list in the mapping table.
Example: Add a mapping entry for the play button on your MIDI controller by pressing the play button on your controller. Or, you can create an entry by moving the crossfader on your controller.
- Select the target for the mapping from the drop-down menu in the "Target" column.
Example: If you are configuring the play button for the left turntable in djay, select "Deck 1" from the menu in the "Target" column.
- Now select the action that should be performed when using the control from the drop-down menu in the "Action" column.
Example: Select "Play/Pause" from the menu in the "Action" column if you are configuring the play button.
Testing a new mapping
You can immediately test a new mapping by using it on your MIDI controller. No saving is required to test a new mapping.
Adding multiple actions for a control
You can also make a single control perform multiple actions when activated: simply control-click (right-click) the mapping entry and select "Duplicate Mapping for Control" from the menu to create another mapping entry for the same control, which you can again map to the desired target/action.
Saving or reverting the configuration
Select the Done button to save your custom MIDI configuration in djay Pro AI. Select the Revert button to revert back to the last saved configuration, or to an empty list of mappings if the configuration was not saved before.
Using multiple configurations
djay Pro supports having multiple alternate MIDI configurations for a controller. For example, if you have a MIDI controller with multiple "trigger" buttons, you could have one configuration where the buttons are mapped to trigger samples, and another configuration mapped to control audio FX or loops.
To create an alternate configuration:
- Select "Edit Configurations..." from the "MIDI Configuration" menu at the top of the MIDI configuration window.
- Select your current configuration from the list.
- Select "Duplicate" from the "Options" menu.
- Rename the new configuration by double-clicking the name in the list (optionally).
To use multiple available configurations:
Simply select the desired configuration from the "MIDI Configuration" menu at the top of the MIDI configuration window, and djay Pro will allow you to easily switch between these as needed.
Sharing MIDI mappings
Use the macOS Share Menu icon in the MIDI configuration window to share your mappings via the available options, such as directly from the folder where they are saved, or via AirDrop.
From the drop-down menu, select "Show in Finder" to quickly open the folder where the mappings are saved.
Note: You can also access the "Show in Finder" option when you select "Edit Configurations..." -> select the name of the mapping you'd like to find -> select "Options" -> select "Show in Finder".
From the MIDI Mappings folder, you can, for example, send the mapping file via email or save it on a USB drive.
To install a MIDI mapping file for use in djay, simply double-click the file in the Finder folder.
Advanced Control Options
Advanced options for each mapping are available by clicking "Show Advanced Control Options" below the mapping list.
From here you can set various options for the mapping:
Control type: while the control type is usually auto-detected, you can also select the control type manually. The following control types are available:
- Fader / Knob
- Rotary (01h/7Fh)
- Rotary (3Fh/41h)
- Rotary (Absolute)
The different "Rotary" control types are for "endless" rotary controls (called "encoders") like jog wheels or music library controls. The easiest way to find the right option is to test the control with each option.
- Invert: For sliders and knobs, different MIDI controllers sometimes send inverted signals, which make the controls in djay Pro move in the opposite direction than on the controller. Select this option to invert the control.
- Pickup Mode: with this option enabled, djay Pro will detect when the on-screen control is no longer in sync with the control on your MIDI controller, and wait until you re-align the control to make it have an effect. This is especially useful for tempo sliders, as using the "sync" option will alter the on-screen slider.
- Speed: for rotary-type controls (incl. jog wheels), change this slider to determine how much effect a given movement of the control will have (i.e. "how far" it goes).
- Reaction: for jog wheel controls, change this slider to determine how smooth vs. responsive a movement of the jog wheel should be. A "smooth" setting will make slow movements of the jog wheel sound more clean, but with a lower reaction, whereas a "responsive" setting will make movements of the jog wheel have a more immediate effect in djay Pro. Try to find a setting that matches your desired behavior of the jog wheels.
MIDI Out: this allows to have djay Pro send a MIDI signal back to the MIDI controller, e.g. to enable button LEDs. For buttons on most controllers, simply enabling the "MIDI Out" checkbox will make the button’s LED work correctly. However, for some controllers it will be necessary to manually select the MIDI channel, message type ("CC" or "Note on/off"), and control number that corresponds to the button you are mapping.
Consult your controller’s manual, or try out different settings "by hand", e.g., by slowly moving the "Control" slider (this will send a MIDI signal for each subsequent control number, allowing you to observe your MIDI controller while moving the slider to find the right setting). At any time you can use the "Test" button to send a MIDI signal with the new settings.