xtouch-mini-processing

A Processing interface for the Behringer X-Touch Mini USB Controller.

This project makes it easy to interface with the X-Touch Mini in Processing. It's a thin wrapper around The MidiBus MIDI library that simplifies addressing and controlling the knobs and buttons on the X-Touch Mini.

Getting Started

Prerequisites

You will need three things to make this project work:

Processing 3 (of course)
Behringer X-Touch Mini USB Controller
The MidiBus MIDI library for Processing

Installing

Install The MidiBus Library
Install The MidiBus library in Processing via the Contribution Manager:
In the Processing IDE, choose Sketch > Import Library... > Add Library... Find The MidiBus and click Install.

Copy the XTouch Classes to Your Project
Copy the XTouch.pde from the dist folder into the folder for your Processing sketch.

Usage

First create an instance of the XTouchMini class:

XTouchMini xTouch = new XTouchMini();

Implement these functions in your sketch to intercept the various hardware events:

void knobDidChange(XTKnob knob, float oldValue, float newValue) {
	println("knobDidChange (" + knob.id + "): " + oldValue, newValue);
}

void knobDidPress(XTKnob knob) {
	println("knobDidPress: " + knob.id);
}

void knobDidRelease(XTKnob knob) {
	println("knobDidRelease: " + knob.id);
}

void faderDidChange(float oldValue, float newValue) {
	println("faderDidChange: " + oldValue, newValue);
}

void buttonDidChange(XTButton button, boolean value) {
	println("buttonDidChange: (" + button.id + "): " + value);
}

Knob ids are 1–8 for Layer A, and 9–16 for Layer B.
Button ids are 1–16 for Layer A, and 17–32 for Layer B.
There is only a single Fader shared across both layers.

Set values on the controller like so:

// set value 100 for knob #2
xTouch.setValueForKnob(100, 2);

// set value true (on) for button #3
xTouch.setValueForButton(true, 3);

Find more info in the examples folder, or in the docs.

Build from Source

The build script for this project (build.sh) simply copies all the classes into a single file in the dist folder.

cd [xtouch-mini-processing]
./build.sh

License

This project is licensed under the Unlicense - see the LICENSE file for details.

Error

I am a sound engineer work on the XR18 with PC running Windows Vista for XAIR Edit.
I have a X-Touch mini and would like to use it to control the XR18.

I am able to install the requirements.txt

C:\xAir>xair-remote.py -l
Connected MIDI Ports:
X-TOUCH MINI 0

However, when i run the air-remote.py. I got the following error.

C:\xAir>xair-remote.py "X-TOUCH MINI 0"
Found XR18 with firmware 1.17 on IP 192.168.1.1
Error: MIDI port X-TOUCH MINI 0 does not exist!

When I try to have launch the X-Touch Editor, I got another error message.
May I know if I miss anything? Any idea how I can fix it?

C:\xAir>xair-remote.py "X-TOUCH MINI 0"
Found XR18 with firmware 1.17 on IP 192.168.1.1
Traceback (most recent call last):
File "C:\xAir\xair-remote.py", line 30, in
midi = MidiController(args.midi_port, state)
File "C:\xAir\lib\midicontroller.py", line 71, in init
self.inport = open_input(devicename)
File "C:\Python27\lib\site-packages\mido\backends\backend.py", line 91, in ope
n_input
return self.module.Input(name, **self._add_api(kwargs))
File "C:\Python27\lib\site-packages\mido\ports.py", line 161, in init
BasePort.init(self, name, **kwargs)
File "C:\Python27\lib\site-packages\mido\ports.py", line 86, in init
self._open(**kwargs)
File "C:\Python27\lib\site-packages\mido\backends\rtmidi.py", line 125, in _op
en
virtual=virtual, api=self.api)
File "C:\Python27\lib\site-packages\mido\backends\rtmidi.py", line 96, in _ope
n_port
rt.open_port(port_id)
File "src/_rtmidi.pyx", line 588, in rtmidi._rtmidi.MidiBase.open_port
File "src/_rtmidi.pyx", line 223, in rtmidi._rtmidi._cb_error_func
File "src/_rtmidi.pyx", line 411, in rtmidi._rtmidi._default_error_handler
rtmidi._rtmidi.SystemError: MidiInWinMM::openPort: error creating Windows MM MID
I input port.

Thanks

cadin / xtouch-mini-processing Goto Github PK