By using e.g. TouchOSC you might now turn your iPhone or iPad into a fully customizable remote controller.
OSC allows you to send and receive any OSC message from and to a remote OSC client - this enables full bi-directional communication.
Using OSC with your iPad:
By using the 'TouchOSC' app for iPhone/iPad you might now turn your iPad into a fully customizable remote controller.
Please download this ZIP-File: ProppFrexx_ONAIR_TouchOSCiPad.zip
This zip file contains all neccessary files to setup your iPad into a full remote controller using 'TouchOSC'.
Contained Files are:
- "ProppFrexx ONAIR iPad.touchosc" : this file contains the TouchOSC layout definition
- "ProppFrexx ONAIR iPad.osc" : this file contains the ProppFrexx OSC event mappings
- "ProppFrexx ONAIR iPad.events" : this file contains the global events to be imported
1) Download and install the 'TouchOSC' app from the iTunes store on your iPad (cost is around 3.99 Euro)!
2) Go to the TouchOSC web-site (http://hexler.net/software/touchosc)
Download and install the TouchOSC Editor software for Windows on your machine running ProppFrexx ONAIR.
This software is free, but required in order to upload the TouchOSC layout definition file to your iPad
3) Copy all files contained in the above zip file to your ProppFrexx ONAIR AppUserData directory.
E.g. "C:\Users\yourname\AppData\Roaming\radio42\ProppFrexx ONAIR\4.0"
4) Now launch the 'TouchOSC' app on your iPad:
Select 'Network' and setup your internet connection (a wireless LAN connection is required!)
a) Host: Type in the IP-Address of your machine running ProppFrexx ONAIR
b) Port (outgoing): Type in the port number of your ProppFrexx ONAIR OSC server (e.g. 9000)
c) Port (incoming): Type in the port number of your iPad client (e.g. 9001)
d) Local IP address: this is the IP-Address of your iPad!
5) Start the TouchOSC Editor (TouchOSCEditor.exe, see 2) on your ProppFrexx ONAIR machine.
Select 'Open' and navigate to your ProppFrexx ONAIR UserData directory (see 3).
Now open the file "ProppFrexx ONAIR iPad.touchosc".
The layout file will be loaded to the editor.
Now press the 'Sync' button and wait...
6) Switch to your iPad (the TouchOSC app) and go back to the main menu.
Select 'Layout' within the TouchOSC app and click on 'Add'.
Under 'Found Hosts' your machine name will appear - click on it.
The layout will now be synced from your local machine to your iPad.
When done press OK.
The iPad should now have the "ProppFrexx ONAIR iPad" layout selected and loaded.
Click on the layout and you should be back in the main menu of TouchOSC.
Click on the 'Done' button to display the layout on your iPad.
You can now also close the TouchOSC Editor on your machine (see 5).
The layout is now transfered to your iPad you don't need the TouchOSC Editor anymore.
7) Finally it is time to start and configure ProppFrexx ONAIR.
Make sure you are running at least version 18.104.22.168 or above.
If note, "Check for Updates..."
8) After ProppFrexx ONAIR has been started go to the global settings dialog (eg. press F3).
Select the 'GPIO/Remoting' section and scroll down to the 'Open Sound Control (OSC)' group.
- Input: Type in the IP-Address of your machine and specifiy the same port number you have selected under 4b)
- Output: Type in the IP-Address of your iPad and specifiy the same port number you have selected under 4c)
- Tick the 'OSC Enabled' checkbox
- Transport: select 'UDP Unicast'
- Mapping: select "ProppFrexx ONAIR iPad" from the combobox (this will reference the file "ProppFrexx ONAIR iPad.osc")
9) Now select the 'Events/Commands' section and click on 'Import Events...'.
Navigate to your ProppFrexx ONAIR UserData directory (see 3) and open the file "ProppFrexx ONAIR iPad.events".
When done click 'OK' to close and save all global setting.
10) That's it.
You have now:
- transfered the TouchOSC layout from your machine to the iPad
- configured the iPad and ProppFrexx ONAIR to communicate via the specified IP addresses and port numbers
- enabled the OSC remote server within ProppFrexx ONAIR
- loaded/selected the OSC mapping file ("ProppFrexx ONAIR iPad.osc") which translates all incomming OSC messages from the iPad into appropriate control-commands
- imported various global events ("ProppFrexx ONAIR iPad.events") which sends OSC messages back to the iPad to updates the TouchOSC user interface
After launching 'TouchOSC' on your iPad make your your Network and Layout settings are set as described above.
Also make sure to enable the following options:
- Stay connected: ON
- Double-tap lock: ON
Click the 'Done' button to switch to the ProppFrexx ONAIR iPad layout and start the remote controller.
The interface offers 5 different tabs:
3. CARDWALL 1
4. CARDWALL 2
When launching for the first time you might need to click on the 'Sync' button in order to synchronize the display with the currently running ProppFrexx ONAIR instance.
The MAIN page contains all major controls to remotely operate your playlist, players, main fader as well as two input channels.
Therefore the MAIN page might be used during live operations (live assist).
The buttons reflect the same functionality as provided by the regular ProppFrexx ONAIR user interface.
This page allows you to control up to 6 output mixer channels as well as up to 4 input mixer channels.
This page reflects your Cardwall I. You can switch between 4 shortcuts (cardwall libraries) as setup in ProppFrexx ONAIR.
The PFL, SELECT and LOOP buttons serve as multi-touch buttons.
In order to toggle the loop flag or to select individual cards press and hold the SELECT or LOOP button while clicking on the individual card(s).
Same with PFL: press and hold the PFL button while clicking in the card you want to pre-listen to.
All other buttons are single-touch buttons.
Each card provides 3 leds: Yellow=Selected, Green=Playing, Purple=Looped.
This page was left blank by intention. It offers you space for any additional controls you might want to add using the TouchOSC Editor.
TouchOSC sends OSC messages to ProppFrexx ONAIR (to the OSC remote server within ProppFrexx ONAIR).
ProppFrexx ONAIR might now evaluate these incoming messages via the standard message mapping logic in order to translate those incoming OSC messages into control-commands.
On the other side ProppFrexx ONAIR might send OSC messages back to TouchOSC by using the EXEC_SEND_OSC control-command (see the user manual for more info).
This allows full bi-directional communication.
You might use the global event system of ProppFrexx ONAIR to trigger the sending of OSC messages to TouchOSC.