PIXILAB Wiki

Differences

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

Link to this comparison view

Both sides previous revision Previous revision
Next revision 		Previous revision
blocks:player-setup [2025-07-01 09:02]
mattias [Debugging options] 		blocks:player-setup [2025-07-16 13:21] (current)
mattias [Configuration File]
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 117: Line 117:
   * **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.
  
 ====Release notes==== ====Release notes====
Line 141: Line 143:
 ====Debugging options==== ====Debugging options====
  
-:!: Only ever use debugging settings temporary, **do not leave this options on permanent**. +:!: Use debugging settings only tmporarily when instructed by PIXILAB. Do not leave these options on permanently. 
  
   * **debug_mode**  When set to yes access to browser web developer tools is enabled.   * **debug_mode**  When set to yes access to browser web developer tools is enabled.
  
   * **ssh_password** When a password is set, ssh becomes enabled on the player.    * **ssh_password** When a password is set, ssh becomes enabled on the player.