New in 1.5

Custom MIDI Mapping

One DJ supports natively an increasing number of controllers, which are premapped and do not necessarily need further adjustments. If however you are not satisfied with the bundled mapping or if your controller is not premapped, One DJ's MIDI mapping functionality makes creating controller configurations easy.

NOTE: Please use the Start Wizard in main options menu to choose your controller as the default control device before beginning to map it, making sure the right control method is chosen for all of the gear on your setup.

MIDI Learn button is located at the top menu bar, alongside the circular MIDI activity indicator, which flashes white when MIDI messages arrive from controller to One DJ.

Clicking the MIDI activity indicator displays a MIDI activity window with the latest MIDI messages received from your controller. This makes it easy to check incoming message types, which may help you tweak your control bindings.

Once the MIDI Learn is clicked on (appears red),

  1. Click the element (play button, a slider, a knob etc.) on the screen you want to map.
  2. Touch the button, knob or slider on your controller to bind it.
  3. Clicking a mapped control on your screen with the right mouse button shows the Current Assignments window. There you'll find the list of your controls (buttons etc.) mapped to that particular function making et easy to make tweaks and erase bindings, if needed. See the next chapter for further information.
  4. Repeat this until you have all your controls mapped the way you like.
  5. Click the MIDI Learn off from the menu bar and you're good to go.

The same physical control can be mapped simultaneously to different actions in the software creating macro controls. Also, different physical controls can be simultaneously mapped to the same action with different preferences.

Some of the more complex functions in The One have advanced mapping options. These functions include Scratch, Cue points and Loop selector. These are described in detail next.

Scratch wheel mapping

Because the MIDI controllers on the market send a wide array of different messages when using high presicion controls, especially wheels and platters, the scratch / pitch bend / seek functionality is a bit more complex compared to average mappable functions in One.

When mapping the scratch wheel, first turn the MIDI Learn mode on. Then click the "Scratch" button, displayed on the player deck waveform area. Then scratch on the correspondent plate on your controller. The "Scratch" button will turn green and your platter is mapped.

The mapper tries to independently figure out the right settings for your wheel and to detect a "scratch activator" functionality, which is often a touch surface button on top of the platter in most controllers. (Moving the scratch plate without the touch scratch activator pressed will result in pitch bend action.)

However you can also map the scratch activator by teaching the "Touch" button on your player deck.

In the most usual cases the "Bend" action (pitch bending done with the platter) is learned with the "Scratch", but in some cases pitch bend control sends different notes than the scratch control. In these cases it's necessary to learn the "Bend" action separately.

"Seek" is a quick way to hop around the clip when cueing, like fast forward and rewind. It can be mapped to a rotary of your choice.

You can view and edit the current assignments on each function by using the right mouse button.

Cue, Hot cue and timeline hot cue

The One allows mapping of up to 8 hot cue and 8 Timeline hot cue buttons in addition to main cue.

Timeline hot cue is a unique feature to One. You can place a Timeline hot cues to any position or clip placed on the timeline. This allows using the timeline similar to sample player.

An additional "cup" action can be mapped as well. Pressing "cup" skips the play position to the main cue point and immediately starts playing from there.

You can also map a relative "jump to previous/next hot cue" and "jump to previous/next clip" buttons, as well as clip/timeline hot cue toggle button.

First click "LEARN" on the screen and then the desired button on the controller to map. The correctly mapped control turns green on your screen.

You can view and edit the current assignments on each function by using the right mouse button.

Loop Control mapping

There are a couple of ways to control loops in One DJ. You can map a rotary encoder to change the loop length selection or map two buttons for increase (*2) and decrease (/2) length. You can also map different autoloop lengths to individual buttons.

When loop roll is turned on,  the audio playback starts from the position where it would be if the loop was never used after loop is turned off. Using loop roll prevents user from cutting the looping off in a position which would continue the track in a different part of the bar or phase than the original.

You can view and edit the current assignments on each function by using the right mouse button.

Effect rack mapping

Because of the layout of many controllers, effects are mapped to use controls to choose the active effect and then controls to operate the chosen effect.

Clicking "Select active effect" displays the selector mapping panel.

You can view and edit the current assignments on each function by using the right mouse button.

(NOTE: Mapping individual effects to fixed controls is at the moment possible, but unfortunately there is no GUI for it in this version.)


In case you encounter any bugs with The One software, please fill the Bug Report Form.

If you have ideas or wishes for new or better functionality and features, please fill out the Feature Request Form.

For any additional questions, please send us your message with the Contact Form.