piSignage Player2 Setup

Player2 is a new generation piSignage player based on new Raspberry Pi OS and also available for many more platforms based on Debian/Linux and as PWA/Android apps.

Make sure video play is supported in chromium browser or mpv using hardware acceleration before chosing the Linux SBC 

A. Tested platforms and known issues

  1. Raspberry Pi 5 and Pi4 (Bookworm OS - 5.0.1 piSignage image) (beta)

    or Raspberry Pi 4 (with Raspberry Pi Legacy Buster OS - 4.9.0 piSignage image)**

  2. Intel CPU based NUC and other boards

  3. Radxa Rock 4C+

  4. Odroid N2

B. Preparing the OS for piSignage installation

Installing on Raspberry OS (Only for Raspberry Pi)

  1. Download latest Raspberry Pi OS with desktop (32-bit) and prepare SD card using Raspberry Pi Imager/Baleno Etcher software

  2. Configure the OS, wifi and wait for the latest upgrade completion

  3. If needed, do sudo apt update and sudo apt full-upgrade -y

  4. Under raspberry configuration -> interfaces -> enable ssh

  5. Under raspberry configuration, select audio output for HDMI (raspi-config -> general -> Audio)

    For Buster OS and Pi 3, issue the following command for chromium browser issue(courtesy: https://forums.raspberrypi.com/viewtopic.php?t=330711#p1990146)   
     ```echo 'export CHROMIUM_FLAGS="$CHROMIUM_FLAGS --use-gl=egl"' | sudo tee /etc/chromium.d/egl```

Installing on Debian 10/Debian 11/Ubuntu 20(Skip this step for Raspberry Pi hardware)

  1. Intel boards
    1. Install debian 10/11 with graphic install and copy any missing firmware files to /lib/firmware/
    2. username and password are set to pi
    3. Use entire disk for partition
    4. Software selection - GNOME, SSH server, Standard system utilities (unselect other window managers)
    5. On boot login and open terminal su sudo usermod -aG sudo pi
    6. Logout and login as pi
  2. For odroid, just boot Ubuntu mate 20.04 desktop
    1. Select Ubuntu(Default) instead of MATE desktop environment using cog wheel while login
    2. Configure wifi access
    3. sudo snap install chromium

Installing Debian 11 for radxa Rock4 boards

  1. Download Debian 11 Desktop image from https://wiki.radxa.com/Rock4/downloads from Official images (Make sure you select the right board tab)
  2. Type in "radxa" password to login

C. Wireless Network Configuration

For Radxa boards

For other boards

C. User configuration and other configuration (for all platforms)

Install piSignage software (for all platforms)

  1. Download one of the following files to home directory $HOME
  2. unzip -o pi-image-p2-v14.zip (OR unzip -o pi-image-p2-v20.zip)
  3. cp player2/build-scripts/install-pisignage.sh .
  4. chmod +x install-pisignage.sh
  5. chmod +x -R player2/build-scripts
  6. chmod +x -R player2/shell-scripts
  7. ./install-pisignage.sh
  8. Notice the log for any Errors
  9. sudo apt update --fix-missing

(Optional) If script do not work, Using GUI (dconf-editor or gsettings command),

Upgrading software with new zip file (Manual upgrade, not needed for auto upgrade)

  1. Copy the pi-image-p2-v14.zip to home directory /home/pi
  2. unzip -o pi-image-p2-v14.zip
  3. chmod +x -R player2/shell-scripts


  1. If there is no Audio, please refer help article to select the audio interface
  2. If you are stuck and need support for image generation for your hardware, please write to us with hardware type, OS link and error log at support at pisignage.com***