BrightSign Registry Keys
Registry key settings may be removed without notice.
See also:
roRegistry, roRegistrySection (BrightScript)
registry (JavaScript)
Registry Section | Registry Key | Description | Software that Uses/Writes this Key |
|---|---|---|---|
boot | splash | Controls whether the splash screen is shown. If set to zero, the splash screen is not displayed. If not present, or set to any other value, the spash screen is shown. | OS |
brightscript | debug | Setting this value to 1 turns on BrightScript debugging. You can also enable this at the Brightsign> prompt by typing "script debug on" | OS |
customer | obfuscation_key | Allows you to use an alternative obfuscation key. | OS |
html | disable-hw-accelerated-video-decode | Set to "1" to disable support for hardware accelerated video decode in Chromium when "use-brightsign-media-player = 0". Series 4 and older players do not support hardware accelerated decode. | OS |
html | disable-web-security | With BOS 8.2 and later (Chromium69 and later), several new CORS checks have been added. Setting this value to | OS |
html | enable_web_inspector | Allows the roHtmlWidget web Inspector to be enabled. On BOS 8.5.31 and newer, you must enable the inspector via this key and the roHtmlWidget config. Possible values are "1" or "0" | Written by the supervisor or customer, read by the OS |
html | js-trace-gc | Pass --trace-gc in --js-flags | OS |
html | js-trace-fragmentation | Pass --trace-fragmentation in --js-flags | OS |
html | js-trace-gc-ignore-scavenger | Pass --trace-gc-ignore-scavenfer in --js-flags | OS |
html | js-trace-gc-verbose | Pass --trace-gc-verbose in --js-flags | OS |
html | mse-support | Setting this value to 1 turns on MSE support on Series 3 players. Series 4 players will enable it by default when running BOS 8.3+ | OS |
html | mpm | Enable or disable the Memory Pressure Monitor | OS |
html | overlay-scrollbar | Set scrollbar style. Set to "1" for touch-friendly mode, otherwise as desktop | OS |
html | process-per-tab | If set to 1, sets --process-per-tab rather than --process-per-site-instance which is the default | OS |
html | tracecategories | Chromium trace control | OS |
html | traceduration | Chromium trace capture time in seconds | OS |
html | tracemaxsnapshots | Chromium trace maximum snapshots | OS |
html | tracememorymaps | Set to "1" to enable memory bench marking | OS |
html | tracemonitorinterval | Chromium trace monitor interval in seconds. Must be > 30, or zero/missing to disable. | OS |
html | webaudio-support | Report web audio as enabled by default. When present, this parameter must be 1 for web audio to be reported as enabled. (Note that web audio support is incomplete; this option allows an appropriate report to be made depending on the application.) | OS |
html | webgl_antialiasing_enabled | Set to "1" to enable WebGL anti-aliasing | OS |
html | use-brightsign-media-player | When "use-brightsign-media-player = 0", mpv is disabled. The Chromium media player will be used instead and players will have hardware accelerated video decode inside HTML. Series 4 and earlier players do not support hardware accelerated decode. | OS |
html | widget_type | Changes the browser engine used for roHtmlWidget. Currently only valid for Series 5. Versions from v9.0.126 up to 9.0.145.1 allows values of "electron" or "qtwebengine". In version 9.0.145.1 and later, "electron" is deprecated and replaced with "chromium110" in order to select the electron/chromium engine. |
|
networking | cdr | A boolean value as to whether the content downloads should be restricted. | setup script and presentation autorun |
networking | cdrl | The length of time for the content download (this key and cdrs, below, create a window of time) | setup script and presentation autorun |
networking | cdrs | The start time for the content download (this key and cdrl, above, create a window of time) | setup script and presentation autorun |
networking | curl_debug | Setting this value to 1 turns on debug output whenever the OS uses curl. It can be very verbose and fill up logs quickly. | OS |
networking | dwse | Enables the local DWS if set to 'yes'; the local DWS is disabled if set to 'no' | Supervisor, setup script |
networking | ele | A boolean value denoting if event logging should be enabled | Supervisor, setup script, presentation autorun |
networking | enableremotesnapshot | A boolean value denoting if remote snapshot is enabled | setup script, presentation autorun |
networking | force_igmp_version | Allows customization of the player response to the IGMP network environment. See IGMP Behavior |
|
networking | http_server | Lets you run the DWS on the standard port. See Diagnostic Web Server#SerialPrompt | OS and supervisor |
networking | isc | Set the color for the splash screen | Setup script, presentation autorun |
networking | ple | A boolean value denoting if playback logging should be enabled or not | Supervisor, setup script, presentation autorun |
networking | prometheus-node-exporter-port | By default, node_exporter will bind to localhost:9100 only to enable metrics collection – this will happen if the key is unset or with any setting other than an explicit disable (by setting the key value to "-"). Otherwise the key value should be set to an integer usable as a port number – from 1025 to 65535, with 9100 being the conventional port for node_exporter. Metrics from node_exporter will be available on all external interfaces on this port number. The service will be bound to localhost on 9100. Port numbers < 1025 will prevent the binding of node_exporter to external adapters and an error message will be logged. However, the service will be bound to localhost:9100. This setting is available in BOS 9.0.144 and above. | Supervisor, monitoring |
networking | ptp_domain | PTP clocks are turned off by default. Use this command to turn them on:
| OS |
networking | rdwse | A boolean flag which tells you if rDWS is enabled. Set to “true” by default | Supervisor |
networking | recurl | URL to which "/Recovery.ashx" is appended if the previous registry entry is not present. If the registry key ''[networking]recover'' or ''[networking]ru'' exists then the recovery URL is the contents of that registry key. Otherwise if the registry key ''[networking]recurl'' exists then the recovery URL is the contents of that registry key with ''"/Recovery.ashx"'' appended. |
|
networking | remotesnapshotinterval | If remoteshapshot is enabled, use this to set the interval at which the remote snapshot should be taken | Setup script, presentation autorun |
networking | remotesnapshotjpegqualitylevel | If remoteshapshot is enabled, use this to set the quality level at which the remote snapshot should be taken. The quality level is a number. | Setup script, presentation autorun |
networking | remotesnapshotmaximages | If remoteshapshot is enabled, use this to set the maximum number of images that should be taken. Older images will be deleted. | Setup script, presentation autorun |
networking | remotesnapshotorientation | If remoteshapshot is enabled, use this to set portrait or landscape orientation. | Setup script, presentation autorun |
networking | rollback_enabled | A boolean value indicating if the rollback feature should be enabled or not. Rollback is enabled by default - disable it by setting it to “False”. | Supervisor |
networking | rs | After the OS calls the recovery handler, one of recovery_reinstall_noreformat.bas and recovery_reinstall.bas will be returned. This is used in both files as a URL to download the recovery script. | Recovery BrightScript |
networking | rtl8821_disable_ht | Set this value to “1” to disable HT on realtek wifi (WS103); other values means enabled. It requires BOS 8.1.70 or higher. | OS |
networking | rtl8821_disable_vht | Set this value to “1” to disable VHT on realtek wifi (WS103); other values mean enabled. It requires BOS 8.1.70 or higher. | OS |
networking | ru | A URL used by system software to download a script to be executed in the event of recovery. If the registry key ''[networking]ru'' exists then the recovery URL is the contents of that registry key. | OS |
networking | serial_with_telnet | Enables serial over telnet. By default, enabling BrightSign-level telnet or ssh will disable the serial console. The first serial port can still be used by scripts for communication with other devices; it just stops being usable as a console but if kernel console output is enabled then that will still be visible on the first serial port. It is possible to enable serial console at the same time as telnet by setting the ''[networking]serial_with_telnet'' registry key to ''1'', but serial communication via roSerialPort in scripts will be highly unreliable. To set the password:
| OS |
networking | sip | The static IP address for either the ethernet or WiFi interface | Supervisor, setup script, presentation autorun |
networking | sip2 | The static IP address for either the ethernet or WiFi interface (sip2 denotes the interface with the lower priority) | Supervisor, setup script, presentation autorun |
networking | status_handler_duration | The interval to report status | Supervisor |
networking | ssh | To enable ssh access set the ''[networking]ssh'' registry key to the port you wish to run ssh on (the default ssh port is 22): A reboot is required for it to take effect but DO NOT DO THIS UNTIL YOU HAVE SET A PASSWORD! To disable ssh access again delete the registry key (the player must reboot for this to take effect): | OS |
networking | subnetmask_vlan_'+id | The subnet mask for the static configuration of the VLAN interface. Id suffix refers to VLAN id. | Supervisor |
networking | syslog | Configures remote logging. See roSystemLog#WritingtoaRemoteSyslogServer | OS |
networking | telnet | To enable telnet access set the ''[networking]telnet'' registry key to the port you wish to run telnet on (the default telnet port is 23). Delete the key to disable telnet access. | OS |
networking | telnet_server | This method enables telnet access to the Linux shell prompt. As such it is only available on players that have had secure boot disabled or are otherwise booting without verification. Set the ''[networking]telnet_server'' registry key to the port you wish to run telnet on: It is possible to enabled this feature along with BrightSign-level telnet provided they run on different ports. | OS |
networking | twf | A boolean value that tells you if text feeds data type is enabled over the WiFi interface |
|
networking | twr | A boolean value that tells you if text feeds data type is enabled over the ethernet interface |
|
networking/private | tz | The device time zone |
|
networking | ub | A URL prefix. This is applied to all URLs that follow if they do not contain a colon. |
|
networking | vu | Events are reported to this URL | OS |
networking | wifi | A boolean value which indicates if WiFi is enabled on the player or not | Supervisor, setup script, presentation autorun |
networking | wired_debug | Enable verbose diagnostics on the ethernet interface | OS |
serial | usb_first | LS3 and LS4 players don't have a dedicated serial port, but have several ways to send and receive serial data depending on the cable in use. Two types of cable can be used: a "passive serial splitter" or a "genuine USB serial adapter". Using one or the other requires setting a registry entry ([usb]type_c_serial or [serial]usb_first), and using the right port number. usb_first only affects serial ports opened by BrightScript and JavaScript, not the console. | OS |
usb | hotplug_tty:106c:3718:1.0 | Supports Pantech UML290 modems (the appended numbers are specific keys for those modems, where the numbers reflect product ID, vendor ID, and interface number). The correct interface number and other settings for a given modem will be visible in /sys/bus/usb/devices (when the modem is plugged in). Note that there is a generic "hotplug_tty" mechanism, this is just an example. | OS |
usb | hotplug_tty:12d1:155e:1.0 | Supports Huawei E3531 / E3372 modems (the appended numbers are specific keys for those modems, where the numbers reflect product ID, vendor ID, and interface number). The correct interface number and other settings for a given modem will be visible in /sys/bus/usb/devices (when the modem is plugged in). | OS |
usb | type_c_serial | LS3 and LS4 players don't have a dedicated serial port, but have several ways to send and receive serial data, depending on the cable in use. Two types of cable can be used: a "passive serial splitter" or a "genuine USB serial adapter". This registry setting is only required when using a passive serial cable (like the ones that BrightSign makes with a USB type A socket and a 3.5mm socket) and not when using a USB serial adapter. | OS |
video | auto_mode_vms_override | This registry setting overrides the “Auto” video mode. When a video mode is set to “Auto”, or not specified by a script, the player should see if a specific mode is set in the public registry. If it finds a valid video mode stored there, it should apply that instead of negotiating a mode using the EDID provided by the sync. This feature allows multi-output or other video modes to be configured for the player outside a CMS application. |
|