Tutorial Controlling MXWendler via TouchOSC: Difference between revisions

From MXWendler Wiki
Jump to navigation Jump to search
No edit summary
(19 intermediate revisions by the same user not shown)
Line 1: Line 1:
Version 5 and higher on OSX and Windows.
This tutorial applies to all different OS version, and all MXWendler version 5.0 and above.


== Introduction==


In this tutorial we will connect TouchOSC to a computer running MXWendler Stage Designer.  
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.<br>
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.<br>
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.


TouchOSC is an app available for IOS and Android devices and
==== This Tutorial Requires: ====
is fully adaptable to the user’s specific needs.
1. TouchOSC App
 
:[https://play.google.com/store/apps/details?id=net.hexler.touchosc_a&hl=en Playstore] [https://itunes.apple.com/us/app/touchosc/id288120394?mt=8 Appstore]
With this tutorial we offer a touch interface designed for a fast and intuitive use of our
2. TouchOSC MidiBridge and TouchOSC Editor  
software but we obviously encourage the MXWendler users to change, improve,
customize or even design their own template.
 
 
{{#mpdftags: pagebreak}}
== This Tutorial Requires: ==
 
 
* TouchOSC App
:[https://play.google.com/store/apps/details?id=net.hexler.touchosc_a&hl=en Playstore]
:[https://itunes.apple.com/us/app/touchosc/id288120394?mt=8 Appstore]
 
* TouchOSC MidiBridge and TouchOSC Editor  
:[http://hexler.net/software/touchosc hexler.net]
:[http://hexler.net/software/touchosc hexler.net]
 
3. MXWendler TouchController.touchosc and TouchOSC_Keystone_Mappings.midimappings
 
* MXWendler TouchController.touchosc and TouchOSC_Keystone_Mappings.midimappings
:[https://www.mxwendler.net/product/downloads.html Download from MXWendler.net]
:[https://www.mxwendler.net/product/downloads.html Download from MXWendler.net]


{{#mpdftags: pagebreak}}


== TouchOSC on Your Touch Device ==
== TouchOSC on Your Touch Device ==


 
1. Download the TouchOSC app from Google Play Store or Apple App Store and install it on your device.<br>
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.<br>
 
3. Open TouchOSC and click on the first item of the menu: 'OSC' '''(A)'''<br>
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:
4. Once inside the submenu configure as follows:
:'''HOST''': IP address of the computer running MXWendler
:'''HOST''': IP address of the computer running MXWendler
:'''Port (outgoing)''': - 7000
:'''Port (Outgoing)''': - 7000
5. Then click on the second item:
5. Then click on the 'MIDI Bridge'. '''(B)''' <br>
:'''MIDI Bridge''' '''(B)'''  
6. And configure as follows:
6. And configure as follows:
:'''HOST''': IP address of the computer running MXWendler
:'''HOST''': IP address of the computer running MXWendler


 
[[File:TouchOSC 01.png|428px]]
[[File:TouchOSC 01.png|728px]]
 
 


{{#mpdftags: pagebreak}}
{{#mpdftags: pagebreak}}
==Configuring the Computer==
==Configuring the Computer==


1. Download the template and the midi mappings from: [http://www.mxwendler.net/fileadmin/user_upload/downloads/MXWendler_TouchOSC.zip MXWendler.net]
1. Download the template and the midi mappings from: [http://www.mxwendler.net/fileadmin/user_upload/downloads/MXWendler_TouchOSC.zip MXWendler.net]
Line 64: Line 39:
3. Launch the Midi Bridge.
3. Launch the Midi Bridge.


4. Open the MXWendler template with the editor and press '''Sync'''.  
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:
5. Now, on the mobile device, open the third item of the TouchOSC menu to download the template:
:'''Layout →  Add From Editor →  Download'''
:'''Layout →  Add From Editor →  Download'''


{{#mpdftags: pagebreak}}
[[File:TouchOSC 04.PNG|728px]]
[[File:TouchOSC 04.PNG|728px]]




{{#mpdftags: pagebreak}}
==Setting up Stage Designer==
==Setting up Stage Designer==


Line 81: Line 52:
1. Start MXWendler StageDesigner and go to:
1. Start MXWendler StageDesigner and go to:
:'''Menu →  Settings →  IO →  OSC '''   
:'''Menu →  Settings →  IO →  OSC '''   
2. Check ''Receive OSC'' '''(C)'''
2. Check 'Receive OSC' '''(C)'''


3. Set port to 7000  
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)'''
'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)'''
:'''Menu → Settings → Stability''' and set the Log Level to 'Show Nothing' '''(E)'''


[[File:TouchOSC 02.PNG|728px]]
[[File:TouchOSC 02.PNG|728px]]
Line 94: Line 65:
4. Configure the Midi input:
4. Configure the Midi input:
:'''Menu → Settings → IO → Midi Generators'''
:'''Menu → Settings → IO → Midi Generators'''
5.Select TouchOSC Midi Bridge input and output and click ok.
5. Select TouchOSC Midi Bridge input and output and click ok.


[[File:TouchOSC 05.PNG|728px]]
[[File:TouchOSC 05.PNG|728px]]
Line 102: Line 73:
6. Load the Midi mappings:
6. Load the Midi mappings:
:''' Menu → Settings → IO → DMX/MIDI/Keyboard Events → Midi (F)'''
:''' 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)'''
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…
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!
You can now start to control Stage Designer through your touch device!


[[File:TouchOSC 03.PNG|728px]]
[[File:TouchOSC 03.PNG|728px]]

Revision as of 13:24, 30 March 2020

This tutorial applies to all different OS version, and all MXWendler version 5.0 and above.

Introduction

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

File:TouchOSC 01.png

{{#mpdftags: pagebreak}}

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

File: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)


4. Configure the Midi input:

Menu → Settings → IO → Midi Generators

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


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!