Input Profiles Howto

This howto document tells you how to associate input profiles to input universes and how to edit these profiles. You should first read the howto on input/output mapping so that you can access the input/output manager and know how to edit input universes.

Input Profile Manager

To access the Input/Output Manager, just click on the tab with the icon placed on the bottom of the QLC+ main screen.
Select the desired universe on the left part of the screen and then click the Profile tab placed beside the Mapping tab on the top right part of the screen.

Profile assignment

You will see a list of available input profile definitions, with a check mark on None. This means that the current universe doesn't have a profile assigned yet. To assign a profile to the universe, simply place a check mark on one of the available profiles by clicking on the empty check box. Only one profile can be assigned to one universe at a time, so the check mark will actually move from its previous position to the item that you have just selected.

KORG nanoPAD: For unknown reasons, the nanoPAD factory defaults don't map the X Axis of the pad area. To have it fully working with QLC+, please download the KORG utility (Windows and OSX only) from here and set the X Axis to CC2 (Control Change #2).

Add/Edit a Profile

It is probable that your input profile is not on the list and you need to create one on your own.

Click the create new input profile button to start making a profile definition for your input profile. Alternatively, you can edit any existing profile by selecting the appropriate item and clicking the edit button. The procedure is exactly the same in both cases from now on.

Input Profile Editor

A dialog is opened with entry fields for Manufacturer, Model and Type.

First enter the profile's manufacturer and the model to these fields and select profile type.

Type is one of:

So far, the only difference is that MIDI profiles show MIDI message parameters in the channel editor.

Now click the Channels tab to edit the profile's channels. You have two choices for adding channel definitions: Manual and Automatic:


Manual mode

Click the add button to enter individual channel information by hand for each channel.
Click to remove an existing channel

Automatic mode

Click the automatic wizard button to attempt automatic channel detection. You'll receive further instructions from QLC+. You must have an input plugin assigned to the current universe for this feature to work. Also, you must first stop the wizard to be able to navigate away from this dialog page.


Channel properties

When you add or edit a channel, a small window will be displayed, asking you to fill or change some parameters:

For MIDI profiles the dialog contains additional fields:

where you can enter the channel specification (which translates to channel number) in a more intuitive way.


Note that you cannot add the same channel multiple times to one profile.


Sliders movement properties

If your input profile includes slider channels, when you click on them you'll notice some extra properties showing up at the bottom of the input profile editor main window. With those, you can set how values received from a slider should act within QLC+.

There are two behaviours: Absolute and Relative.

Absolute is the default setting and basically tells QLC+ to use the slider values exactly as they are received from an external controller.

Relative is a more advanced behaviour that comes handy when using a HID Joystick with a QLC+ XY Pad widget or a Slider widget. Values received from an external controller are treated as relative movement starting from the current position of a Virtual Console widget.
Let's make an example. Suppose you have a XY Pad in your Virtual Console, controlling and monitoring a group of moving heads. During your show you will have a number of scenes moving the heads pan and tilt. At some point you want to slightly adjust the position of the heads of just a few degrees. Here is when the relative movement kicks in. When you move your joystick (or external slider) QLC+ will adjust the heads from their current positions. The direction will depend directly from your external controller. The relative movement will stop when the external controller will return to its origin. Joysticks have a spring for that.
In addition to this, the Input Profile Editor Relative setting allows you to set a Sensitivity parameter that will instruct QLC+ about the strenght of your external controller movements. The higher this value is, the slower the movements will occur. The lower, the faster.


Encoder properties

An encoder is an endless rotary control and can be treated only as a relative control. Basically the encoder can start at any position and when turned clockwise or counter-clockwise it will generate positive or negative offset inside QLC+. When an Input Profile channel is set to the Encoder type, it is possible to specify a sensitivity value, which is nothing but the relative offset that will be added or subtracted by the current QLC+ value.


Button properties

Buttons have an option too, used only in quite specific cases like when using TouchOSC.
A TouchOSC toggle button sends a value to QLC+ only when it is pressed (either to turn it on or off) and this behaviour is not in line with the standard behaviour of MIDI controllers.
For this reason, an option saying "Generate an extra Press/Release when toggled" can be checked to turn the non-standard TouchOSC behaviour into a more standard one.


Back to the input profile definitions panel

When you're done with channels mapping, click the OK button to accept changes and save the input profile. If you didn't enter a manufacturer/model for the profile, you'll be prompted to enter them before you can continue.
Now you should see the profile you just defined in the list of available input profiles. Remember how to assign it to the current universe? Scroll up to Profile assignment if you don't.

To remove any existing input profiles, click the remove button. Note that some profiles are so-called system profiles and cannot be removed unless you're the administrator.

That's all !
Now you can start using your preferred profile. When assigining an input channel to a QLC+ element (like Virtual Console sliders, channel groups, etc..) you will see that your Input profile mapping will be used.


List of bundled input profiles

Device Type Comment
Akai APC20 MIDI use APC20 miditemplate
Akai APC40 MIDI use APC40 miditemplate
Akai APC Mini MIDI no miditemplate needed
Behringer BCF2000 in default mode MIDI
Behringer BCF2000 in Mackie Control mode MIDI has more controls than the default mode
Behringer LC2412 MIDI
Elation MIDIcon MIDI not tested
Enttec Playback Wing Enttec
Enttec Shortcut Wing Enttec
Generic MIDI MIDI
Korg nanoKONTROL MIDI
Korg nanoKONTROL 2 MIDI
Korg nanoPAD MIDI
Logitech Wingman Attack 2 HID
Novation Launchpad MIDI
Showtec Showmaster 24 MIDI should work with lot of similar devices: Elation Light Operator 24, Stairville LC24, and most probably also with their 48 channel variants
TouchOSC Automat5 OSC
TouchOSC Mix16 OSC