docs/oscplugin.html

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML>
<HEAD>
<TITLE>Q Light Controller Plus - OSC Plugin</TITLE>
<SCRIPT SRC="utility.js" TYPE="text/javascript"></SCRIPT>
<link href="style.css" rel="stylesheet" type="text/css" />
</HEAD>
<BODY onLoad="replaceqrc()">

<H1>OSC input/output plugin</H1>

<H1>Introduction</H1>
<P>
QLC+ supports the <a href="http://en.wikipedia.org/wiki/Open_Sound_Control">OSC protocol</a> through an input plugin 
that receives packets from the network.
</P>

<H1>Requirements</H1>

<P>
The OSC protocol is available thanks to the <a href="http://liblo.sourceforge.net/">liblo library</a>, which is linked 
dynamically on Linux systems and statically on Windows and OSX.<br>
In other words, Windows and OSX don't need any extra software, while Linux systems need the liblo library installed.
</P>

<H1>Configuration</H1>

<P>
The OSC plugin supports up to 4 inputs, one for each QLC+ universe. Each input has to listen to a unique port and this can
be configured from the plugin configuration panel.<br>
For each OSC network the following parameters can be set:
<ul>
 <li> 
  <b>Port:</b> The port QLC+ will listen to in order to receive OSC data from your external controller. 
  (Just enter the same port that your external OSC controller is using.) 
 </li>
 <li> 
  <b>Output address:</b> If you need to output DMX data through the OSC plugin,
  enter the address to send it to here (the address will also be used to send feedback). This must be specified in the form: <i>IPAddress:port</i>
 </li>
</ul>
</P>

<H1>Controllers</H1>

<P>
QLC+ has been tested with the following OSC controllers:
<ul>
 <li><a href="http://hexler.net/software/touchosc">TouchOSC</a>. A pre-defined input profile is ready to use for the Mix16 layout.</li>
</ul>
</P>

</BODY>
</HTML>