Command Line Parameters

QLC+ supports a number of command line parameters to automate/extend some functionalities on startup.
Using command line parameters can be tricky depending on the operating system you're using:

Linux: just open a terminal and type "qlcplus" followed by the parameters you need
Windows: create a shortcut of qlcplus.exe (usually located in C:\QLC+) on your desktop. Right click on the shortcut and select "Properties". In the "Target" field you will see something like C:\\QLC+\\qlcplus.exe. There you can add command line parameters. When done click OK.
For example, to force the German language at startup, modify your shortcut command line like this:

OSX: This is the most difficult case since QLC+ on OSX is bundled into a DMG package. You need to open a terminal and "cd" into the QLC+ DMG like this: cd QLC+.app\\Contents\\MacOS
When done, type "qlcplus" followed by the parameters you need

-c or --closebutton

Description: Define a position for a close button in the virtual console. The button can be used to close QLC+. Only has an effect in kiosk mode (see -k) and is most useful when in fullscreen mode without a window manager.

Parameters: x,y,w,h

Examples:
Create a button at (x400, y500) whose size is (w70, h50):
qlcplus -c 400,500,70,50
qlcplus --closebutton 400,500,70,50
-d or --debug

Description: Enable debug mode and optionally set the output level. Note that since 4.8.0 messages for level DEBUG (0) are not included in released binaries.

Parameters: Level (see QtMsgType)

Examples:
Enable debug mode and set debug level to 0:
qlcplus -d
qlcplus --debug

Enable debug mode and set debug level to 3:
qlcplus -d 3
-f or --fullscreen

Description: Start the application in fullscreen mode

Parameters: Method (either 'normal' or 'resize')

Examples:
Tell the window manager to give the whole screen space to QLC+:
qlcplus -f
qlcplus --fullscreen
qlcplus -f normal
qlcplus --fullscreen normal

Resize QLC+ to take up the whole screen space (useful in custom X11 sessions without a window manager):
qlcplus -f resize
qlcplus --fullscreen resize
-g or --log

Description: Log debug messages to a file ($HOME/QLC+.log)

Parameters: None

Examples:
Enable debug messages and store them to log
qlcplus -d 0 -g
qlcplus --debug 0 --log
-h or --help

Description: Display command-line help (only in Linux & OS X)

Parameters: None

Examples:
Display the command-line help:
qlcplus -h
qlcplus --help
-k or --kiosk

Description: Enable kiosk-mode (only virtual console is visible and the application is locked in operate mode)

Parameters: None

Examples:
Start the application in kiosk mode:
qlcplus -k
qlcplus --kiosk
-l or --locale

Description: Use the given language for translation

Parameters: Language code (currently supported: ca_ES, cz_CZ, de_DE, en_GB, es_ES, fi_FI, fr_FR, it_IT, ja_JP, nl_NL, pt_BR)

Examples:
Use finnish language:
qlcplus -l fi_FI
qlcplus --locale fi_FI
-m or --nowm

Description: Inform the application that the system doesn't provide a window manager. QLC+ will therefore add some extra controls to close the windows.

Parameters: None

Examples:
Start QLC+ with no window manager:
qlcplus -m
qlcplus --nowm
-n or --nogui

Description: Start the application with the GUI hidden (Raspberry Pi only)

Parameters: None

Examples:
Start QLC+ with no visible GUI:
qlcplus -n
qlcplus --nogui
-o or --open

Description: Open the given workspace file

Parameters: File name

Examples:
Open sample.qxw:
qlcplus -o sample.qxw
qlcplus --open sample.qxw
-p or --operate

Description: Start the application in Operate mode.

Parameters: None

Examples:
Start QLC+ in operate mode:
qlcplus -p
qlcplus --operate
-v or --version

Description: Display the current application version number

Parameters: None

Examples:
qlcplus -v
qlcplus --version
-w or --web

Description: Enable remote web access on port 9999

Parameters: None

Examples:
qlcplus -w
qlcplus --web
-wp or --web-port

Description: Use a specific port for web access

Parameters: Port number

Examples:
qlcplus -wp 12345
qlcplus --web-port 12345
-wa or --web-auth

Description: Enable remote web access with users authentication

Parameters: None

Examples:
qlcplus -wa
qlcplus --web-auth
-a or --web-auth-file

Description: Specify a file where to store web access basic authentication credentials

Parameters: File name

Examples:
qlcplus -wa qlcplus_password
qlcplus --web-auth-file qlcplus_password