How to configure debug options on the Electron player (Windows)

Overview

On the Signagelive Electron player, it has been possible to enable/disable some debug options since version 1.0.43. This article will explain the debug options that are available and how they can be configured.

Which debugging options can be configured?

The table below shows the debugging options that can currently be configured:

Option Name	Description
devToolsEnabled	When set to true the Chrome developer tools will display in a separate window whilst the Signagelive media player is running. When the developer tools are enabled two developer tool windows will be displayed. The first one shows the developer tools for the main media player window. The other is for a hidden background window. Generally, when debugging the media player you will always be interested in window 1. If devToolsEnabled is false or not specified then developer tools will be disabled and will not be visible.
disableGlobalKeypress	The Signagelive media player will by default listen for and consume all key presses even when it is not the Window with focus. This is important to ensure features like keyboard interrupts work as expected. Setting disableGlobalKeypress to true will modify this behaviour so that the Signagelive media player will only listen for and consume key presses when it is the window that has focus.
alwaysOnTop	Since 1.0.45 the Signagelive media player window will always display in front of all other windows. This is preferable in general usage but for debugging this can make it difficult to view and access other windows such as the developer tools Windows. If you set alwaysOnTop to false, this will disable this functionality allowing other windows with focus to be viewed in front of the media player. If this setting is true or not specified the Signagelive media player will always display in front of all other windows.

How do I configure the debugging options?

The debugging options can be specified in a JSON file called debug.json that must be included in the application root directory.

The debug.json file should look like the example below:

{
"devToolsEnabled": true,
"disableGlobalKeypress": true,
"alwaysOnTop": false
}

This file should be located in the following directory:

• Windows:

%AppData%\Signagelive

Will this functionality be supported on macOS?

Currently, we have not publicly released an update for the OSX client that includes these capabilities. However, this functionality will be included in the next macOS media player release.

How can I find out more?

You can always search for answers with the Signagelive Help Centre, but rest assured we have a dedicated Support Team that is ready to assist you with any questions you may have. We are always here to help as best we can, so just contact us for any help you require.