PIXILAB Wiki

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
blocks:player-setup [2025-03-28 16:13] – Added notre on updating the player adminblocks:player-setup [2025-10-16 12:33] (current) – [Troubleshooting Settings] admin
Line 1: Line 1:
 ====== PIXILAB Player ====== ====== PIXILAB Player ======
-PIXILAB Player is a free software for making a player or interactive kiosk out of a small form-factor PC (such as a "NUC computer"), for use with Blocks as a Display Spot. This article describes how to install PIXILAB Player.+PIXILAB Player is free software for making a player or interactive kiosk out of a small form-factor PC (such as a "NUC computer"), for use with Blocks as a Display Spot. This article describes how to install PIXILAB Player.
  
 :!: **NOTE**: This article describes the current version of the player, recommended for new installations. This player version requires Blocks version 7 or later. For systems based on previous Blocks versions, you may prefer to use the [[blocks:player-setup-pre-seven|legacy version]] of PIXILAB Player. That legacy version also supports network (PXE) booting which this newer version doesn't. :!: **NOTE**: This article describes the current version of the player, recommended for new installations. This player version requires Blocks version 7 or later. For systems based on previous Blocks versions, you may prefer to use the [[blocks:player-setup-pre-seven|legacy version]] of PIXILAB Player. That legacy version also supports network (PXE) booting which this newer version doesn't.
Line 101: Line 101:
 This string will be appended to the Spot page URL. It can be used to append query parameters to the URL. This string will be appended to the Spot page URL. It can be used to append query parameters to the URL.
  
-=====Configuration File=====+====Configuration File====
 The configuration set through the web-based user interface described above results in settings in the //playerconfig.txt// file. As an alternative to using the web-based user interface, you can set options directly in the playerconfig.txt file. This can also be used to change settings for a player later.  The configuration set through the web-based user interface described above results in settings in the //playerconfig.txt// file. As an alternative to using the web-based user interface, you can set options directly in the playerconfig.txt file. This can also be used to change settings for a player later. 
  
Line 112: Line 112:
 Valid keys are listed below in bold, with values described in the following text. Valid keys are listed below in bold, with values described in the following text.
  
-  * **disable_hardware_video_acceleration** When set to //yes//, disables hardware video acceleration in chromium. Hardware video acceleration is enabled by default.+  * **disable_hardware_video_acceleration** When set to //yes//, disables hardware video acceleration. Hardware video acceleration is enabled by default.
   * **dns** The address to the DNS server when using manual network configuration.   * **dns** The address to the DNS server when using manual network configuration.
   * **enable_mouse** When set to //yes//, shows the mouse cursor when a mouse device is connected. Mouse devices are disabled by default.   * **enable_mouse** When set to //yes//, shows the mouse cursor when a mouse device is connected. Mouse devices are disabled by default.
   * **enable_wifi** When set to //yes//, enables WiFi. WiFi is disabled by default. The SSID of the WiFi network must be specified using the ssid option.   * **enable_wifi** When set to //yes//, enables WiFi. WiFi is disabled by default. The SSID of the WiFi network must be specified using the ssid option.
   * **ssid** SSID (name) of WiFi network.    * **ssid** SSID (name) of WiFi network. 
 +  * **hidden_ssid** Set to //yes// when connecting to a network with a hidden SSID. Default is //no//. This option is available in PIXILAB Player 7.2 and later.
   * **wifi_encryption** Set to //wpa// to specify WPA encryption for the WiFi network. When set to wpa, wpa_password must also be set. Default is no encryption (open network).   * **wifi_encryption** Set to //wpa// to specify WPA encryption for the WiFi network. When set to wpa, wpa_password must also be set. Default is no encryption (open network).
   * **wpa_password** Password for connecting to a WPA encrypted WiFi network.   * **wpa_password** Password for connecting to a WPA encrypted WiFi network.
Line 128: Line 129:
   * **server_protocol** Set to //http// or https depending on the connection type to the Blocks server.   * **server_protocol** Set to //http// or https depending on the connection type to the Blocks server.
   * **timezone** Time zone used by the player's internal clock.   * **timezone** Time zone used by the player's internal clock.
 +  * **touchpad_tap** Set to //no// to disable tap-to-click. Tap-to-click is enabled by default. This option is available in PIXILAB Player 7.1 and later.
   * **url_append** String added to the end of the Spot url. Occasionally useful to apply extra query parameters.   * **url_append** String added to the end of the Spot url. Occasionally useful to apply extra query parameters.
   * **rgb_range** Can be set to //auto//, //full// or //limited//. The default is //auto//, where the range to be used is governed by the EDID data provided by the display. Set to //full// to force the full 0…255 range, which is occasionally useful for non-compliant display devices that fail to show full black/white levels. Applies to Intel graphics chipsets only.   * **rgb_range** Can be set to //auto//, //full// or //limited//. The default is //auto//, where the range to be used is governed by the EDID data provided by the display. Set to //full// to force the full 0…255 range, which is occasionally useful for non-compliant display devices that fail to show full black/white levels. Applies to Intel graphics chipsets only.
Line 133: Line 135:
   * **auto_install** Set this to //yes// to install the player on an internal SSD without prompting. This option is available in PIXILAB Player 7.1 and later.   * **auto_install** Set this to //yes// to install the player on an internal SSD without prompting. This option is available in PIXILAB Player 7.1 and later.
  
-:!: **CAUTION**: Make sure to mark any USB stick set to //auto_install// clearly, as inserting this into a random computer set to boot frmo USB may damage it.+:!: **CAUTION**: Make sure to mark any USB stick set to //auto_install// clearly, as inserting this into a random computer set to boot from USB may damage it.
  
-====Debugging options====+====Release notes====
  
-:!: Only ever use debugging settings temporary, **do not leave this options on permanent**. +[[blocks:player-setup:release_notes|PIXILAB Player release notes]]
  
-  * **debug_mode**  When set to yes access to browser web developer tools is enabled.+====Troubleshooting Settings====
  
-  * **ssh_password** When a password is set, ssh becomes enabled on the player. +:!: Use these troubleshooting and debugging settings only after consulting with PIXILAB. Do not leave these options on permanently. 
 + 
 +  * **debug_mode**  When set to //yes// access to browser developer tools is enabled. 
 + 
 +  * **ssh_password** When a password is set, ssh network access is enabled on the player with the user name //root// and the specified password.