Open Sound Control

OSC Mapping

Open Sound Control is a successor to the MIDI control protocol. It enables communication between computer software, sound synthesizers and other multimedia devices that support OSC. Its advantages over MIDI include: an open-ended and dynamic URL-style symbolic naming scheme, symbolic and high-resolution numeric argument data, pattern matching language to specify multiple recipients of a single message, high resolution time tags and "bundles" of messages whose effects must occur simultaneously.

OSC Setup

The OSC setup options panel can be opened by choosing "Edit -> Preferences" from the main menu and selecting the "OSC" tab.

• Enable Server: This starts the Renoise OSC server and the network port is changed to a listening state, so you may get a firewall warning the first time this is enabled.
• Incoming Messages: This panel simply displays messages relevant to the networking process.
• Protocol: Select the protocol which the Renoise server will use:
  • Udp: Provides a high transfer rate with lower reliability than Tcp.
  • Tcp: Provides a lower transfer rate than Udp with higher reliability.
• Port: Select the Port number for messages to be transferred over. Generally, a number greater than 1024 is used.
• Command List: Lists the various commands that it is possible to use to communicate with Renoise.
• Explanation Panel: When clicking on a command in the Command List, an explanation of what the command does is displayed here.

Duplex Tool: TouchOSC

The Duplex Tool comes with a Device preset for TouchOSC, an iPhone / iPod Touch / iPad app, that allows those devices to control Renoise via OSC. To use it, select "TouchOSC" from the "Device" pulldown menu in the Duplex Browser and adjust the configuration as needed within the "Settings" dialog box. Then within the TouchOSC app on the Apple device, you can change the values of the various knobs and sliders on the screen to control various features of Renoise.

Using Pure Data To Send OSC Commands

Pd (aka Pure Data) is a real-time graphical programming environment for audio, video, and graphical processing. Pd was created to explore ideas of how to further refine the Max paradigm with the core ideas of allowing data to be treated in a more open-ended way and opening it up to applications outside of audio and MIDI, such as graphics and video. There are different versions available to download for PC, Mac and Linux.

Using PD With Renoise Via OSC

• First install PD, then download, unzip and open the "test-renoise-osc.pd" file within PD.
• In the top left corner, you can set the port number to match the OSC port number you have chosen for Renoise [connect localhost XXXX]. With Edit Mode (Ctrl + E) you can edit the numbers.
• To the right, you can start and stop playing Renoise with the [send / renoise / transport / start] and [send / renoise / transport / stop] buttons.
• If you want to enter yourself into a new OSC message:
  • Menus "Put -> Message" out a message box. (Edit mode at this point)
  • Mark will appear and take a round mouse port connection to the message box on the bottom of the left and drag it into place [sendOSC] it connects the upper connection port.
  • In the message box [send / renoise /....] OSC Type your message begins.
  • Cancel edit mode (Ctrl + E) and click the box if the message is sent to OSC.