Tutorial Controlling MXWendler via TouchOSC

From MXWendler Wiki
Jump to: navigation, search

Version 5 and higher on OSX and Windows.
In this tutorial, we will connect TouchOSC to a computer running MXWendler Stage Designer. We will be able to control the software via OSC protocol.
TouchOSC is an app available for IOS and Android devices and is fully adaptable to the user’s specific needs.
With this tutorial, we offer a touch interface designed for fast and intuitive use of our software but we obviously encourage the MXWendler users to change, improve, customize or even design their own template.

This Tutorial Requires:

1. TouchOSC App

Playstore | Appstore

2. TouchOSC MidiBridge and TouchOSC Editor

hexler.net

3. MXWendler TouchController.touchosc and TouchOSC_Keystone_Mappings.midimappings

Download from MXWendler.net

TouchOSC on Your Touch Device

1. Download the TouchOSC app from Google Play Store or Apple App Store and install it on your device.
2. Connect the device to the same wireless network of the computer you want to control.
3. Open TouchOSC and click on the first item of the menu: 'OSC' (A)
4. Once inside the submenu configure as follows:

HOST: IP address of the computer running MXWendler
Port (Outgoing): - 7000

5. Then click on the 'MIDI Bridge'. (B)
6. And configure as follows:

HOST: IP address of the computer running MXWendler

TouchOSC 01.png

Configuring the Computer

1. Download the template and the midi mappings from: MXWendler.net

2. Download the TouchOSC Editor and the Midi Bridge from: hexler.net

3. Launch the Midi Bridge.

4. Open the MXWendler template with the editor and press 'Sync'.

5. Now, on the mobile device, open the third item of the TouchOSC menu to download the template:

Layout → Add From Editor → Download

TouchOSC 04.PNG


Setting up Stage Designer

1. Start MXWendler StageDesigner and go to:

Menu → Settings → IO → OSC

2. Check 'Receive OSC' (C)

3. Set port to 7000

'Log Received Data' can be checked during the setup but, due to performance reasons, it must be unchecked during the usage. (D)

Menu → Settings → Stability and set the Log Level to 'Show Nothing' (E)

TouchOSC 02.PNG


4. Configure the Midi input:

Menu → Settings → IO → Midi Generators

5. Select TouchOSC Midi Bridge input and output and click ok.

TouchOSC 05.PNG


6. Load the Midi mappings:

Menu → Settings → IO → DMX/MIDI/Keyboard Events → Midi (F)

7. And click the 'Load' button at the left bottom of the page to load the keystone Midi mappings linked in this page. Once the mappings are loaded click 'Apply'. (G)

8. Restart MXWendler, load some videos in Preload and make a basic playlist…

You can now start to control Stage Designer through your touch device!

TouchOSC 03.PNG