How to add or tweak a controller mapping

XML preset files and script files (.js) for MIDI and other controllers.

Moderators: garth, User Customization Moderators

How to add or tweak a controller mapping

Postby Pegasus » Wed Dec 09, 2009 9:02 am

Here is the recommended order of things to do to add support for a new MIDI controller to Mixxx. To tweak an existing one, you'll want to skip step 1 and just start editing the mapping and/or script file(s).

  1. Use the MIDI Learn Wizard available on the MIDI controller pane (except in v1.11.x) to map essential controls quickly. After you close Mixxx, find the XML file with your controller name in the controllers sub-directory (midi directory on Mixxx v1.10.x and below) where mixxx.log is located (depends on the OS and Mixxx version...search your computer.) Then copy/move that file to the controllers sub-directory under your Mixxx installation (midi directory on Mixxx v1.10.x and below.)
  2. To map additional controls, edit that XML file with your favorite text editor using the information on this wiki page. The page also contains information on how to read the data your controller sends so you know which values to use incase you can't find the controller's user guide.
  3. For more advanced behaviors, fine-tuning (like for jog wheels) and otherwise full control, use MIDI scripting. Don't be afraid! It uses an easy-to-learn Javascript-like language that gives you great power.
(Quick links to these pages are on our Wiki's main page.)

Once you have a mapping (and script file if you made one) that works 100%, please send it to the mixxx-devel mailing list and/or file it as a Wishlist bug so it can be included in a future Mixxx release!

EDIT: updated directory and listed version-specific caveat
"D.J. Pegasus"
Mixxx Developer - Controller Specialist
Mixxx Windows package maintainer
User avatar
Pegasus
Mixxx Developer
 
Posts: 1712
Joined: Thu Jan 29, 2009 7:48 pm
Location: Las Vegas, NV, USA

VIDEO: How to map jog wheels

Postby Pegasus » Fri May 25, 2012 3:51 pm

Finally, here is a video that walks you through mapping a jog wheel to scratching and pitch-bending from nothing: http://www.youtube.com/watch?v=QUT8tZmwM00

It's really not that bad. Let me know if you have questions!
"D.J. Pegasus"
Mixxx Developer - Controller Specialist
Mixxx Windows package maintainer
User avatar
Pegasus
Mixxx Developer
 
Posts: 1712
Joined: Thu Jan 29, 2009 7:48 pm
Location: Las Vegas, NV, USA

Re: How to add or tweak a MIDI controller mapping

Postby Coval_pl » Wed Dec 26, 2012 11:42 pm

Very usefull MIDI tool for everybody, who watns to make his own controller's mapping and script:

http://www.midiox.com/?http://www.midiox.com/moxdown.htm

Includes MIDI monitor to check controller's MIDI commands.
Last edited by Coval_pl on Wed May 22, 2013 1:15 pm, edited 1 time in total.
Coval_pl
 
Posts: 25
Joined: Sun Nov 25, 2012 12:10 pm
Location: Gdynia / Poland

Re: How to add or tweak a MIDI controller mapping

Postby DJ Tiger » Sun Jan 13, 2013 1:56 am

Coval_pl wrote:Very usefull MIDI tool fo everybody, who watns to make his own controller's mapping and script:

http://www.midiox.com/?http://www.midiox.com/moxdown.htm

Includes MIDI monitor to check controller's MIDI commands.


got anything to send or monitor LED signals as well?
Pioneer Product User
2xCDJ-350 1xDJM-250
User avatar
DJ Tiger
 
Posts: 4
Joined: Wed Jan 09, 2013 5:49 am
Location: Sweden

Re: How to add or tweak a MIDI controller mapping

Postby DJ Kytrooper » Thu Jan 31, 2013 9:11 pm

How can I apply scratching to a physical MIDI-knob? In your video you said it can be done, but it is more in depth than what you are covering... I'm not good with manuels so could you at least summarize how to do it?
DJ Kytrooper
 
Posts: 24
Joined: Wed Jan 30, 2013 1:59 am

Re: How to add or tweak a MIDI controller mapping

Postby Pegasus » Mon Mar 25, 2013 9:42 am

Kytrooper: You mean a knob like a volume knob? Something that has a hard top and bottom? If it's an endless knob, then you can use the exact procedure the video shows.
"D.J. Pegasus"
Mixxx Developer - Controller Specialist
Mixxx Windows package maintainer
User avatar
Pegasus
Mixxx Developer
 
Posts: 1712
Joined: Thu Jan 29, 2009 7:48 pm
Location: Las Vegas, NV, USA

Re: How to add or tweak a MIDI controller mapping

Postby martibs » Tue Mar 11, 2014 1:57 pm

Is there something like a API specification for MIDI scripting for Mixxx? It'd be interesting to see all the values you could get and set, for instance.
martibs
 
Posts: 22
Joined: Tue Feb 11, 2014 9:06 pm

Re: How to add or tweak a MIDI controller mapping

Postby bestdani » Wed Mar 19, 2014 9:05 pm

bestdani
 
Posts: 66
Joined: Fri Jul 02, 2010 9:38 am
Location: Germany

Re: How to add or tweak a MIDI controller mapping

Postby martibs » Thu Mar 20, 2014 12:27 pm

That page is far from complete.
martibs
 
Posts: 22
Joined: Tue Feb 11, 2014 9:06 pm

Re: How to add or tweak a MIDI controller mapping

Postby rryan » Tue Mar 25, 2014 8:14 pm

martibs wrote:That page is far from complete.


Do you mean it's missing controls? We try to add them as we update the code on GitHub. I'm about to go through and make sure that some brand new ones for Mixxx 1.12.0 (effects framework, harmonic mixing, master sync, beatjumps, loop move, and talkover ducking) are documented.

However, that page is just a list of the possible controls you can change. For more info about how to use them with mappings or how to write Javascript to control them then click the wiki links in point #2 and #4 of the first post in this thread.

Feel free to post in this forum if you need help. Many of us hang out on IRC if you want to chat :).

cheers,
RJ
The Mixxx Manual, Wiki and FAQ are the best place to start for documentation and support.
Please report any bugs you find to our Bug Tracker.
rryan
Mixxx Developer
 
Posts: 1335
Joined: Thu Mar 26, 2009 12:14 am
Location: California

Next

Return to Controller presets/mappings

Who is online

Users browsing this forum: No registered users and 13 guests