Using TouchOSC

Updated 10/10/2019

"Open Sound Control (OSC) is a protocol for communication among computers, sound synthesizers, and other multimedia devices that is optimized for modern networking technology. Bringing the benefits of modern networking technology to the world of electronic musical instruments, OSC's advantages include interoperability, accuracy, flexibility, and enhanced organization and documentation." Read more here.

You can communicate with the Lightform device using OSC messages. Each effect has various exposed parameters that you can adjust (e.g., color and size). If an effect is selected to run as Live (Labs feature), it will be computed in real-time during project playback by the Lightform device. Thus, you can adjust the effect's parameters using OSC messages simultaneously during playback.


Learn more about Editing OSC Mappings in Lightform Creator

Using the TouchOSC Mobile App

I. Download the TouchOSC Mobile App 

To control your LF1 via a mobile device, you can use the TouchOSC app available for both iOS and Android.

IIa. Download and apply our custom layout

Once you have the app, you can download our "layout," which is a custom UI for controlling the device.

The layout file can be downloaded here (LightformBeta).

On Android, you can install this file directly by downloading it on your phone. On iOS, you will need to download the file to your computer, then use iTunes to copy the file to your phone — see this article: . Once the file is on your device, you need to set it as the current layout.

IMG_8575.png IMG_8577.png

IMG_8573.png IMG_8574.png

Turn off "Touch Messages (/z)" in TouchOSC→Options 


IIb. Creating your own TouchOSC layout

When creating your own TouchOSC layout, if using buttons (e.g., for play/stop/next slide/etc), you must turn off "Send on Release" — see this article: If you don't do this, pressing and then releasing a button will generate 2 events (e.g., pressing a button for "next slide" would actually advance you 2 slides instead of 1).

III. Using the OSC app

The current version of our OSC layout is useful for modifying effects which have been uploaded to an LF1. After finishing the setup steps above and publishing a project with at least one Live Effect, follow these steps:

  1. Connect your phone to the same WiFi network that your Lightform device and computer are connected to
  2. Open the TouchOSC App
  3. Tap the OSC line under CONNECTIONS and select your Lightform device from the list of FOUND HOSTS
  4. Press < TouchOSC in the upper left to go back to the main settings page, then Done in the upper right to go to the Lightform layout. You can press the gray circle in the upper right of the layout to get back to the settings page
  5. In Lightform Creator, switch to the Control Page and open the OSC Mappings Window
  6. Click Learn next to the parameter that you’d like to connect to a control in the OSC app
  7. Touch one of the buttons in the app or move one of the sliders to associate that control with the parameter that your Lightform device is learning
  8. Now when you use that control, the parameter will change in real time on your Lightform device
Was this article helpful?
4 out of 5 found this helpful

Sign in to make a suggestion to improve this article

  • Comment actions Permalink
    Jimmy Gillies Gillies


    Can you advise if there is a way of integrating audio, into a effect, or any suggestions on how to apply audio in general, to a timeline.., thanks much ..,Much Appreciated :) ?



  • Comment actions Permalink
    Brittany at Lightform

    Hey Jimmy, 

    We do not support audio with Lightform Creator but one of our favorite things to do is to publish Live Effects and modify their parameters via OSC based on a soundtrack using either Vezer or Abelton

    You can read a bit more on how to set this up in these articles:

    We plan to publish more tutorials on these kinds of audio-based workflows soon!

  • Comment actions Permalink
    Enrico Corelli

    Is possible to connect physical button to move between transiction or recognize the moving of one hand in some specific are of projection to choose some others slide? 

  • Comment actions Permalink
    Brittany at Lightform

    Hi Enrico!

    As long as the button can send OSC messages, it should be able to communicate with the LF1. 

    You can find the editable OSC mappings in the Control Page. Click the Edit OSC Mappings button to map controls to OSC. For example, advancing to the next slide or going back to the previous slide are available OSC Mappings. If you press the Learn button, the LF1 will accept the next incoming OSC message and that will be used to control the function. You can read more about the OSC mappings here:

    The LF1 cannot detect hand gestures or hand movement to interact with slides or control any function.

  • Comment actions Permalink
    Marc Syp

    Do you have any plans to provide timeline shuttle control to the live effects, which then could be controlled via OSC?  In architectural visualization, this would let us do a sun path study, for instance, which represents time of day.  Having a shuttle would essentially let us "move the sun".




  • Comment actions Permalink
    Brittany at Lightform

    Hey Marc!

    That sounds like an awesome addition. Could you elaborate a little more on what you'd want out of the feature and the use case you're envisioning? We'd love to learn more to add this onto our product's list of potential feature requests.

  • Comment actions Permalink
    Ellen Byrne

    Hi there, is it possible to trigger a particular slide with OSC? 

  • Comment actions Permalink

    Hi Ellen- Yes, this is possible. In the Control Page of Lightform Creator, after you publish a project to your device, open up the "Edit OSC Mappings" dialog. From there, you can set the mappings for "next slide" and "previous slide", as well as "slide index" where you can send the slide number directly.