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-02-12 07:57]
admin [PIXILAB Player] 		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 46: Line 46:
  
 When the installation has finished, remove the USB drive and power off the player. Connect the player to the network used by the Blocks server (if it is not already connected) and power on the player again. If everything works as expected, you should see the PIXILAB logo on screen with an ID string below, allowing you to add it as a Display Spot to Blocks. When the installation has finished, remove the USB drive and power off the player. Connect the player to the network used by the Blocks server (if it is not already connected) and power on the player again. If everything works as expected, you should see the PIXILAB logo on screen with an ID string below, allowing you to add it as a Display Spot to Blocks.
 +
 +=====Updating the Player=====
 +PIXILAB Player version 7 and later can be remotely updated from Blocks. This is done using the "Update PIXILAB Player" setting in the Advanced tab in the Display Spot Settings dialog box. This feature is only available when:
 +  * The player starts from an internal SSD (i.e., not from a USB stick).
 +  * The current user has the role of Manager or Admin.
 +  * Another version of PIXILAB Player software is found on your Blocks server.
 +
 +Player updates must be stored here inside Blocks’ root directory on your server:
 +<code>
 +public/PIXILAB_Player/updates/pixilab-player-XXX.img
 +</code>
 +
 +where XXX is the version number. The current version of PIXILAB Player can be obtained from the link in point 1 on the web page shown above under "Getting Started". Updates must be named exactly as shown above, so don’t rename them after download.
  
 =====Configuration Options===== =====Configuration Options=====
Line 88: 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 104: 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 115: 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.
-  * ** headless_mode** Set to //yes// to use the player without a display, e.g. for audio only playback. Default is //no//.+  * **headless_mode** Set to //yes// to use the player without a display, e.g. for audio only playback. Default is //no//. 
 +  * **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 from USB may damage it. 
 + 
 +====Release notes==== 
 + 
 +[[blocks:player-setup:release_notes|PIXILAB Player release notes]] 
 + 
 +====Debugging options==== 
 + 
 +:!: 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. 
 + 
 +  * **ssh_password** When a password is set, ssh becomes enabled on the player.