Skip to content

Latest commit

 

History

History
101 lines (78 loc) · 4.64 KB

README.md

File metadata and controls

101 lines (78 loc) · 4.64 KB
Raw

Mixxx-Pioneer-DDJ-SB3

Mixxx controller mappings for the Pioneer DDJ SB3

IMPORTANT!!!

This mapping has been merged into the official Mixxx repository. No more development for this controller mapping will occur in this repository.

These files are based on the DDJ-SB2 files that are part of the Mixxx distribution: https://github.com/mixxxdj/mixxx/tree/master/res/controllers, however they were adjusted to work fine with DDJ-SB3

Known Issues

Decks 3 and 4 will NOT work unless you set the output of Mixxx to use DDJ-SB3. The controller requires that the on-board sound card be activated before it sends out the correct messages. It seems that is a bug (feature?) in the controller firmware. If pressing the deck 3 or deck 4 button does not light the button up, make sure you are using the controller sound card as output in Mixxx (Options -> Preferences -> Sound Hardware).

Other branches

You may want to check the branch 8-hotcues. The difference is the HOT CUE pads: Use the pads as hotcues, and pressing shift:

  • The 4 pads on top will delete hotcues 1-4
  • The 4 pads in bottom will be start, rewind, forward and censor.

The behavior on master branch is different:

  • The 4 pads on top are hotcues 1-4, pressing with shift will delete.
  • The 4 pads on bottom are start, rew, forward, censor. Pressing shift will give you hotcues 5-8

Installing / Updating

  • First option: Execute one of the scripts:

    Windows

    Just double-click the bat file, it will copy files for you (this is not a virus, it will just copy the files for you, if are feeling unsafe, copy files manualy)

    install-win.bat

    Linux

    1. Open a terminal
    2. cd to the directory where you downloaded / clonned this project
    3. Run ./install-linux.sh

    MacOS

    1. Open a terminal
    2. cd to the directory where you downloaded / clonned this project
    3. Run ./install-osx.sh

  • Second option: You can just copy the files

Pioneer-DDJ-SB3-scripts.js
Pioneer-DDJ-SB3.midi.xml

to the Mixxx controllers folder.

Beware: If you are updating, I would recommend that you delete any XML files that contains DDJ-SB3 and activate your controller again in Mixxx

Using Effects

  • The 1, 2, 3 will always turn on/off the effect

  • The Level knob will change the effect unit Master, IF NONE EFFECT IS SELECTED.

  • Pressing SHIFT + 1, 2 or 3 will SELECT the effect. When there is a selected effect:

    • The Level now will change the META of the selected effect.

    • Holding SHIFT while changing GAIN, one of EQ or FILTER will change the selected effect params.

    • You can DELESECT it pressing SHIFT and the lighted effect button. After that no buttons will be lighted meaning that no effect if selected

Midi Message Lists

Running the Tests

  1. Install Node
  2. Install Yarn
  3. Install Jest
  4. run yarn test

Linting

The mapping js file must not generate any eslint warnings in order to be merged into the mixxx project.

yarn run eslint Pioneer-DDJ-SB3-scripts.js

Contributing

Please: do not change the file Pioneer-DDJ-SB3.midi.xml manually. Instead, modify first the files inside the xmls folder and after run node ./compile-xml.js. The script will merge recusively all xmls inside the xmls folder and compile it in the final xml.

Feature Matrix

Feature Deck 1 Deck 2 Deck 3 Deck 4
Play / Pause Yes Yes Yes Yes
Cue Yes Yes Yes Yes
Key Lock Yes Yes Yes Yes
Sync Yes Yes Yes Yes
Tempo Range Yes Yes Yes Yes
Fx Yes Yes Yes Yes
Auto Loop Yes Yes Yes Yes
Vynil / Slip Yes Yes Yes Yes
Hotcue Yes Yes Yes Yes
Sampler Yes Yes Yes Yes
Beat jump Yes Yes Yes Yes
Roll Yes Yes Yes Yes
Slicer!!! Yes Yes Yes Yes
Eq Yes Yes Yes Yes

In fact, I think all features are working. Let me know, or open a issue if you experience some problem.