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
- Upload your own assets to your account with Add files under the Assets tab.
- Deploy the assets to your groups.
More details are in Special assets.
2. Server and wifi configuration
- Download the SD card image and mount it on a laptop. The
/bootpartition is visible in the laptop's OS. - Create a file named
player-config.txtin the/bootpartition 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
- Do not add comments in the file.
server_nameis only needed to point to a different server. It is not needed for pisignage.com.- All blocks are optional, but if a block is present, all of its fields are required.
- Generate the PIN and copy it from Settings.
- The
installationvalue is the same as your username. - 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.