Q Light Controller Plus - User Documentation

Index page

Web Interface

By default, QLC+ includes a native web server to expose on traditional web browsers some of the software features.
It comes very handy when you need to run QLC+ on a device without a display (headless system) either to work standalone or for remote controlling.
The web interface is not enabled by default but can be easily activated by running QLC+ with "-w" or "--web" option. Please refer to the command line parameters page of this documentation to learn how to do it.

The web interface can be accessed from any modern web browser running on any device, such as a computer, a tablet or a smartphone. Your browser needs to support the web sockets technology to communicate with QLC+, and it is recommended to use Google Chrome.
It is also possible to design custom web pages and access QLC+ functionalities via web API which are basically strings formatted in a specific way and sent to QLC+ via websocket.
A test page with the available APIs can be found here.

To access the QLC+ web interface simply connect to this address:
http://[IP address]:9999

Where [IP address] is the IP address of the device you want to access via web. For example: http://192.168.0.100:9999
The web interface consists in three pages:

Virtual Console page

This page is displayed by default when accessing the web interface address and it represents the QLC+ Virtual Console.
If a project is loaded, this page will display the widgets previously created with QLC+, otherwise it will just show an empty page.
It is possible to load a project with the Load project button placed on the top left corner of the page. A window will show up, allowing you to choose a file from the device you're using to control the device where QLC+ is running.
The project file will be transferred via web and loaded by QLC+.
To access the QLC+ configuration page, just click on the Configuration button.

Simple Desk page

This page is a simplified version of the Simple Desk that you can find in the QLC+ desktop version. It displays DMX universes divided by pages, where each page shows 32 channels. You can switch between pages with the left/right arrow buttons and select the current displayed universe with the drop down menu on the top right of the page.
It is also possible to reset a universe at once by pressing the reset button (gray X)

DMX Keypad

When clicking on the "DMX Keypad" button in the Simple Desk top bar, you can jump to a new page where a traditional DMX keypad is displayed.
The keypad is useful to set a batch of channel values with a single command. Following a table explaining the key commands that you can find on the right side of the pad.

KeyDescription
AT sets a value for a specified DMX channel or group of channels (range).
Example: 13 AT 148 (sets channel 13 to value 148)
THRU selects a range of DMX channels
Example: 3 THRU 15 AT 133 (sets channels 3 to 15 to value 133)
FULL sets the maximum value (255) to the selected DMX channels or group of channels
Example: 18 FULL (sets channel 18 to 255)
1 THRU 10 FULL (sets channels 1 to 10 to 255)
ZERO sets the minimum value (0) to the selected DMX channels or group of channels
Example: 4 ZERO (sets channel 4 to 0)
BY sets a channels gap within a range
Example: 1 THRU 10 BY 2 AT 100 (sets channels 1, 3, 5, 7, and 9 to value 100)

Please keep in mind that:

Configuration page

This page allows to remotely set the QLC+ configuration, divided in three areas:

Once the configuration has been set, it is possible to go back to the web interface main page by clicking on the Back button, placed at the top left corner of the page.

Known limitations

The QLC+ web interface is still a work in progress feature and it has some known limitations you should be aware of if you intend to use it.


Version: 4.10.5 Last update: 2016-12-03 18:23:38 +0100