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:porteus_kiosk [2023-11-15 12:43]
mattias [Installation Settings]
blocks:porteus_kiosk [2025-03-11 14:18] (current)
mattias ↷ Links adapted because of a move operation
Line 1: Line 1:
-====== PIXILAB Player advanced setup======+====== PIXILAB Player Advanced Setup======
  
-PIXILAB Player is free software that makes a browser-based player or interactive kiosk out of an Intel NUC or other PC-style computer, for use as a Display Spot for Blocks. It's based on an enhanced version of the excellent [[http://porteus-kiosk.org/|Porteus Kiosk]] project.+:!: IMPORTANT: The method of making PIXILAB Player described here is no longer supported. This article is kept for reference purposes only. Follow [[blocks:player-setup|these instructions]] to make a player. 
 + 
 +PIXILAB Player is free software that makes a browser-based player or interactive kiosk out of an Intel NUC or other PC-style computer, for use as a Display Spot for Blocks. 
  
 This is how it works: This is how it works:
Line 18: Line 20:
 ==== Obtaining the Installer ==== ==== Obtaining the Installer ====
  
-Start by downloading the ISO image of [[https://pixilab.se/outgoing/blocks/pixilab-player-231013-6.2.1.iso|PIXILAB Player version 6.2.1]]. This file needs to be copied to a USB stick using Etcher. Make sure your target computer can boot from a USB stick. Download [[https://www.balena.io/etcher/|Etcher]] and use it to copy the ISO image onto your USB memory stick.+Start by downloading the ISO image of [[https://pixilab.se/outgoing/blocks/pixilab-player-240209-6.3.iso|PIXILAB Player version 6.3]]. This file needs to be copied to a USB stick using Etcher. Make sure your target computer can boot from a USB stick. Download [[https://www.balena.io/etcher/|Etcher]] and use it to copy the ISO image onto your USB memory stick.
  
-More details on what's changed between versions in the [[blocks:porteus_kiosk:release_notes|PIXILAB Player release notes]].+More details on what's changed between versions in the [[blocks:player-setup:release_notes|PIXILAB Player release notes]].
 ==== Starting the Installer ==== ==== Starting the Installer ====
  
Line 167: Line 169:
  
 :!: Using [[https://www.balena.io/etcher/|Etcher]] you can flash several USB drives at the same time. :!: Using [[https://www.balena.io/etcher/|Etcher]] you can flash several USB drives at the same time.
- 
-===== Using the Display Spot ===== 
- 
-Connect the computer to your the network used by the Blocks server. For the above settings to work, you need to have at least a DHCP server on this network (which may be the one built into the [[blocks:server:creating_a_server|Blocks Linux Server]], or a separate one as often built into routers and gateways). Allow the player to restart and connect to the network. A browser window will open, attempting to access the specified URL (e.g., ''http://pixi.guide/spot'' in the example above). 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. 
- 
-==== Power Management ==== 
- 
-When used with Blocks 2.2 or later, you can control the power of the player as well as the attached display. This works with most modern NUC models. In order to power up the player, make sure "wake on LAN" is enabled. This is specified in the configuration file above, but on some PCs this must also be enabled in the BIOS settings. 
- 
-The display's power can be controlled in either of two ways: 
- 
-  * If the display supports CEC control (often called something else by display manufacturers), make sure this feature is enabled in the display's or TV's menu settings. 
-  * If you're using a computer-style display, it may not support CEC. Instead it will typically turn itself off and on automatically as the computer is turned off/on. Make sure to enable this automatic power management feature of our display. 
- 
-If you want to use the CEC method, you need to enter the BIOS settings of the NUC. Navigate to ADVANCED,  DEVICES, ONBOARD DEVICES. Enable //HDMI CEC Control// and set //Auto Turn On/Off TV// as shown below. When set in this way, the NUC will tell the TV to turn on and off in unison with itself. 
-  
-{{ :blocks:porteus:intel_nuc_bios_cec_options.png?800;nolink |}} 
- 
-To make sure your NUC-based display spot restarts after a power failure, in BIOS settings select "Last State" under Advanced, Power, Secondary Power Settings, After Power Failure. 
-{{ :blocks:porteus:intel_nuc_bios_power_options.png?800;nolink |}} 
- 
-==== Network Boot from the Blocks server ==== 
- 
-If you're using our [[blocks:server:creating_a_server|Linux based server]], you can configure the server so that players can be booted over the network (PXE boot). This has the following advantages: 
- 
-  * No USB stick is needed for each player. 
-  * The player resides only on the server, making it easy to update. 
-  * The configuration of all players also resides in a single place, making it easier to apply changes without making new USB sticks. 
- 
-:!: To use this feature, your player PCs must support the UEFI standard for network booting. 
- 
-Before attempting to boot the player from the server, make a USB stick as described above, and make sure your player works properly. 
- 
-To enable network booting of you player, do the following (where individual steps may vary depending on the BIOS in the player computer): 
- 
-  * Open the player's bios settings by pressing the appropriate key during startup. 
-  * Select "Boot USB Devices First" to make it boot from USB if one is attached. 
-  * Select "Boot Network Device Last" to make it boot from the server if no USB key is connected. 
-  * Select "Unlimited Boot to Network Attempts" to keep retrying if server can't be reached. 
-  * Disable "legacy boot". 
-  * Disable "secure boot". 
-  * Select "UEFI:LAN:PXE" as the preferred boot device. 
- 
-Follow [[blocks:server:pxe-boot|this guide]] to configure your Blocks server for network booting. 
  
 ==== Manage Pixilab Player Chrome Policies from the Blocks server ==== ==== Manage Pixilab Player Chrome Policies from the Blocks server ====
 +This section applies to Pixilab player versions < 5.2. From version 5.2 this is handled automatically for the servers homepage.
  
-This section applies to Pixilab player versions < 5.2. From version 5.2 this is handled automatically. +In some cases, when using the Chrome browser with PIXILAB Player, you may want to override the browser's policies. This can be done by storing a text file named chrome-policies.txt in the directory <your-blocks-root>/public/PIXILAB_Player (where "<your-block-root>" is the location of your Blocks root directory).The path to this file is then be specified in the kiosk-config.txt file used when creating the player the, as described above. This example assumes the default domain name //pixi.guide// (which in your case may be another domain name, or a hardcoded IP address).
- +
-In some cases, when using the Chrome browser with PIXILAB Player, you may need to override the browser's policies. This can be done by storing a text file named chrome-policies.txt in the directory <your-blocks-root>/public/PIXILAB_Player (where "<your-block-root>" is the location of your Blocks root directory).The path to this file is then be specified in the kiosk-config.txt file used when creating the player the, as described above. This example assumes the default domain name //pixi.guide// (which in your case may be another domain name, or a hardcoded IP address).+
  
 <code>browser_preferences=http://pixi.guide/public/PIXILAB_Player/chrome-policies.txt</code> <code>browser_preferences=http://pixi.guide/public/PIXILAB_Player/chrome-policies.txt</code>