Launch DW Spectrum Desktop Client with CLI
-----------------------------------
Affected Roles: Owner, Administrator
Related Digital Watchdog VMS Apps: DW Spectrum IPVMS
Last Edit: April 25, 2022
-----------------------------------
Benefits of Launching with the CLI
Launching the Desktop client with the CLI gives you a lot more flexibility. The CLI allows you to launch it normally without any changes, but you can also change its behavior by utilizing specific parameters. It can facilitate many tasks such as server auto-login, disabling auto-updates, creating multiple instances of the client, restricting options, and more.
How to Launch with CLI
In Windows:
- Open Command Prompt and enter:
cd C:\Program Files\Digital Watchdog\DW Spectrum\Client
- Next, to view all installed versions enter:
dir
- Choose a version: [replace “VERSION” with your version number (e.g., 3.2.0.28738) in the command below]
cd VERSION
- Launch the Client (no parameter):
applauncher
Or launch the Client with a parameter:
applauncher --layout-name="Example"
In Linux:
- Open Terminal and enter:
cd /opt/digitalwatchdog/client/VERSION/bin
Example: cd /opt/digitalwatchdog/client/4.2.0.32842/bin
- View all installed versions with the command:
ls
- Choose a version. [replace “VERSION” with your version number (e.g., 3.2.0.28738) in the command below]
cd VERSION/bin
- Launch the client (no parameter):
./applauncher
Or launch the client with a parameter:
applauncher --layout-name="Example"
Command Line Parameters (v4.0 and newer):
Parameter |
Description |
Default implied value |
Examples |
--no-single-application |
Allows to have more than one instance of the client application running. (Also disables 'Beta version' warning message.) |
true |
--no-single-application |
--auth |
Auto-login to the target server |
- |
--auth=http://admin:123@localhost:7001 |
--screen |
Open client on the target screen |
- |
--screen=1 |
--window-geometry |
Place the client window to the target coordinates and resize it |
- |
--window-geometry=100,100,1024x768 |
--soft-yuv |
Enables video shader software emulation mode. May cause glitches. |
true |
--soft-yuv |
--local-settings |
Changes settings source from registry to file system (Windows only) |
true |
--local-settings |
--no-fullscreen |
Open client in the windowed mode. May cause glitches. |
true |
--no-fullscreen |
--skip-media-folder-scan |
Do not scan media folders. Local resources will not be displayed. |
true |
--skip-media-folder-scan |
--override-version |
Override software version of the client with the provided value. Will change auto-updates behavior. |
- |
--override-version=2.3.0.8574 |
--log-level |
Minimal level of the log messages that should be recorded to log-file. Allowed values: none - fully disable logging always error warning info debug verbose |
- |
--log-level=always |
--no-client-update |
Disable client auto-update and update notifications. |
true |
--no-client-update |
--acs |
ACS mode (for Paxton integrations and similar scenarios) |
true |
--acs |
--videowall |
Start client in the primary videowall mode. Must contain GUID of the existing Video Wall to work properly. Requires valid --auth key without specified credentials. |
- |
--videowall={72934575-ceb7-54bb-23a0-84b81cf1d3f1} |
|
Start client in the secondary videowall mode. Must contain the GUID of the existing Video Wall Item to work properly. Requires valid--videowall key. Requires valid --auth key without specified credentials. |
- |
--videowall-instance={8692e6e8-ceb7-54bb-23a0-84b81cf1d3f0} |
--light-mode |
Start client in the light mode. Can contain 'full' or a numeric value. |
full |
--light-mode=full --light-mode=7 |
--customization |
Start client with custom skin, loaded from the target folder. Works only if the client is built with ENABLE_DYNAMIC_CUSTOMIZATION define. |
- |
--customization=e:\my_skin |
--instant-drop |
Inner key to open files in the new window. |
- |
--instant-drop=<base64-serialized-value> |
--delayed-drop |
Inner key to open cameras in the new window. |
- |
--delayed-drop=<base64-serialized-value> |
--layout-name |
Name of layout which will be opened after connection to server. |
- |
--layout-name="Some layout name" |
--show-full-info |
Display full info on cameras instead of the minimal. |
true |
--show-full-info |
--no-hidpi |
Disable hidpi support |
true |
--no-hidpi |
Command Line Parameters for v3.2 and Older
--dev-mode-key |
Enables developer mode if the key is equal to “razrazraz” |
- |
--dev-mode-key=razrazraz |
--profiler |
Switch client to the profiler mode. |
true |
--profiler |
--no-version-mismatch-check |
Do not show a warning dialog if servers in the system have different versions. |
true |
--no-version-mismatch-check |
--no-vsync |
Disable VSync. (May cause glitches.) |
true |
--no-vsync |
--ec2-tran-log-level |
Minimal level of the transactions log messages that should be recorded to log-file. Allowed values are the same as in --log-level key. |
none |
--ec2-tran-log-level=info |
--exception-filters |
Prefixes, that will be logged as verbose. |
- |
--exception-filters=dw::dwsoectrum;dw::utils::Parser |
For More Information or Technical Support
DW Technical Support: 866.446.3595
https://www.digital-watchdog.com/contact-tech-support/
______________________________________________________________________________
DW Sales: 866.446.3595 [email protected] www.digital-watchdog.com