Controlling Proxima with a mobile or tablet via OSC

Créé par Waves System, Modifié le Jeu, 18 Sept. à 4:47 H par Waves System

This tutorial is intended to help you understand how to use the OSC protocol to control Proxima from a remote wireless device or app.

In this guide, we'll mostly focus on how to control Proxima from an iOS or Android app, with tools that allow for a quick and easy setup. OSC also allows you to use other applications like the timeline-based sequencer app Vezér or the modular machine Chataigne.

TABLE OF CONTENTS

What is OSC?
Finding a Layout
- Option 1: Build a Layout from Scratch
- Option 2: Configure an Existing Template
Connecting TouchOSC and Proxima
- In TouchOSC
- In Proxima
Managing Assignments

What is OSC?

OSC is the acronym for "Open Sound Control". It's a protocol used for communication between multimedia devices, similar to MIDI, but it allows the transfer of larger data, faster, and through networks like WiFi and Ethernet. This protocol will allow you to control some features in Proxima remotely. The great news is that there's no need to connect everything with cables: your devices just need to be on the same network.

Finding a Layout

You need to use an app with a special layout to have a functional user interface with sliders and buttons. There are many apps that let you build these control panels or have layout templates. Here's an example of a layout in TouchOSC:

TouchOSC Layout Example

You have two options to get a layout.

Option 1: Build a Layout from Scratch

We won't get into details about how to create a layout here, but you can find many resources online on the subject. If you have the skills and are courageous, you can code it, or you can use a WYSIWYG editor, like TouchOSC or the Lemur Editor. In these cases, the editors are free to install on a computer, but the layouts you create will only work with the associated applications you buy from the app store.

Note
Creating your own layout can be tedious, but you'll get more control over how each element works, what information it sends to Proxima, and when.

Option 2: Configure an Existing Template

Some apps provide you with layout templates. This means that the first step is done: buttons, sliders, or other interface elements are already organized in tabs, but you still have to configure them. These elements are "empty" and don't have any assignment, so they are not linked to Proxima features yet.

Using a pre-existing layout only requires assigning Proxima commands to the elements.

⚠️ If you're building your own template and messages, know that Proxima reacts to float arguments between 0.0 and 1.0 in OSC messages. For sliders, 0.0 represents the minimum value and 1.0 the maximum. For toggles, 0.0 means OFF and 1.0 means ON.

Connecting TouchOSC and Proxima

The next paragraphs will give specific instructions to help you get set up with the TouchOSC app and Proxima.

Your devices need to be connected to the same network to communicate, but it doesn't necessarily have to be a wireless connection: your smartphone can use WiFi and your computer can use Ethernet, for example.

In TouchOSC

Note: These instructions describe the procedure to follow with the iOS version of the app. The Android interface is slightly different but the actions are similar, unless specified.

First, open the Connections settings by pressing the button with the chain link icon in the editor toolbar, and go to the "OSC"tab.
There, in the "Host" input field of the first Connection, you need to enter your computer's IP address. You can usually find it under Settings or System Preferences, in the Network properties.
In the "Send Port" and "Receive Port" input fields, enter any number between 7000 and 10000. (But use different ones in both fields.)
Keep this tab open, as you'll need information from there, and head over to Proxima.

In Proxima

Open the Controls Settings window from Controls → Controls Settings... or and go to the "OSC" tab. Make sure that OSC Control is ONwith the toggle at the top.
Then, in "Incoming port", you need to put the number that you put in the "Send Port" field in TouchOSC. Inversely, in "Outgoing port", type in the number that is indicated in the "Receive Port" field in TouchOSC.
In "Output IP address", type in your phone or tablet's IP address. You can usually find it in the Network settings, or some OSC apps sometimes display it directly.

Now, go back to your layout and follow the next section of this tutorial to learn how to connect its elements to Proxima commands.

Note: If you are having trouble after having followed these instructions, you can consult the TouchOSC documentation on their website, which is quite thorough and describes procedures with iOS devices, as well as other advanced features in the app.

Managing Assignments

Enabling OSC Learning

Once your connection is set, you can start assigning buttons, faders, pads, and anything your layout contains to commands in Proxima. To do so, you have to make the elements in the software interface "learn" which item in your OSC layout they should react to.

For that, you need to toggle the OSC Learning interface from the Controls window ("OSC learning mode" button) or menu (Controls → Edit OSC Assignments). A colored overlay will appear over the elements you can map in the interface.

OSC Learning Mode

Adding Assignments

Select an overlay element with your mouse or trackpad (it will be circled in yellow) and just move or hit the control item on your OSC layout that you want to use with it. This will associate the OSC and interface controls together and you'll see it appear in the list in the Controls settings window.

Once you're done, you can simply toggle the learning mode off with the same button/menu or with [Esc].

Note: You can assign the same OSC layout element to multiple commands at the same time. For example, one single button on your device can be linked to multiple effect toggles, so that when you hit it, all these effects turn on at once!

Editing Assignments

To edit the assignments, just turn on the learning mode again. Then, simply select the desired assignment and trigger the new OSC control you want to use.

Deleting Assignments

There are 3 possibilities to delete assignments:

When the Learning mode is ON, select an overlay and hit [Delete/Backspace].
This will remove the selected assignment.
Right-click on a single assignment in the table in the Controls window and click on the "Delete assignment"option.
This will remove the selected assignment.
Use the "Delete all assignments" button above the table in the Controlswindow.
This will remove all OSC assignments in the project.

Saving Assignments

The OSC assignments you set are directly saved in your .pxm project file.

Assignment Settings

Each assignment you configure has a set of settings, as you can see in the assignments table of the Controls window.

OSC Settings

For OSC assignments, you can edit:

The Range: This setting appears on sliders or spinboxes. By setting a Min and a Max, you can override the range of the interface element in Proxima. For example, if you set the range to 1 - 15 for the Thickness of the Border effect, when you move the fader you have assigned to it, the values will only vary between 1 and 15 no matter how hard you move your fader!