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 a 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:

TouchOSC App

Playstore
Appstore


TouchOSC MidiBridge and TouchOSC Editor

hexler.net


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 second item:

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 (C)

2. Check Receive OSC

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.

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

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 → Keyboard (E)

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.

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