Documentsplayer-image-customization

Player image customization

You can customize the player image for your own branding and pre-configure it, so players come up ready to go.

There are three ways to customize.

1. Bootup video and welcome screen

  1. Upload your own assets to your account with Add files under the Assets tab.
  2. Deploy the assets to your groups.

More details are in Special assets.

2. Server and wifi configuration

  1. Download the SD card image and mount it on a laptop. The /boot partition is visible in the laptop's OS.
  2. Create a file named player-config.txt in the /boot partition and add the config lines below.
/boot/player-config.txt
server_name=piathome.com

country=IN
wifi_name="your-wifi-name"
wifi_password="your-wifi-password"
wifi_hidden=0

user_pin="123456"
installation="e2etest"
group="test"
player_name="QCast Player"
timezone="Asia/Calcutta"

The user_pin, installation, group and player_name fields auto-register the player. To get the PIN, enable Auto-register player in Settings. A 6-digit ID appears next to it, copy that as user_pin (see Settings).

A few comments

  1. Do not add comments in the file.
  2. server_name is only needed to point to a different server. It is not needed for pisignage.com.
  3. All blocks are optional, but if a block is present, all of its fields are required.
  4. Generate the PIN and copy it from Settings.
  5. The installation value is the same as your username.
  6. Edit the file only in a plain text editor so no carriage returns (^M) are added. This matters especially on Windows.

3. Customized SD card image for white label servers

Write to support@pisignage.com for the base image. Boot a Pi with it, add your own assets and software modules, run the supplied script and prepare your own image.

White labelling is now done on pisignage.com (25+ players) or on the self-hosted enterprise server. See White Label and Self Hosted.