Documentsraspberry-pi

Setting up your Raspberry pi Player


What you need

  1. Raspberry Pi: model 5, 4, 3, 2, 1 (We recommend the 5)
  2. Zero Micro SD Card: 16GB or higher write speed of class 10 or higher
  3. A laptop
  4. A working internet connection

Imaging the SD card

  1. Download Raspberry Pi Imager here
  2. Download the relevant image from Pisignage.com/downloads
  3. Insert your SD card into your PC and choose the custom option for OS in Raspberry Pi Imager

Please note: Do not use additional customizations such as SSH, Wi-Fi, or auto-login, as these will be configured by the PiSignage image.


Connecting your player to Wifi

Option A – Ethernet (simplest)
Plug in a network cable before powering on. The player connects by itself and you can skip to Register your player.

Option B – WiFi through the player’s hotspot

  1. Insert the SD card, connect the Pi to a TV over HDMI and power it on.
  2. If the player has no WiFi set up, it creates its own hotspot called piplayer_XXXX. The ending is unique to each player.
  3. On your phone or laptop, join the WiFi network piplayer_XXXX with the password piplayer.
  4. Open a browser and go to http://192.168.100.1:8000.
  5. Log in with username pi and password pi.
  6. Open the WiFi settings, pick your network (or type its name), enter the password and save.
  7. The player switches to your WiFi and the hotspot turns off. Your phone or laptop will disconnect from piplayer_XXXX, which is expected.

If the player later can’t reach your WiFi (for example the router is off or the password changed), the piplayer_XXXX hotspot comes back so you can set it up again.

Option C – Keyboard on the player
Connect a USB keyboard and press Ctrl+N (or F6) to open the network menu. Choose WiFi Configuration and connect to your network, then choose Finish & Reboot.


Register your player

Once the player is online, the TV shows the welcome screen with its Player ID.

  1. On your laptop, log in at pisignage.com.
  2. Go to the Players tab and click Register.
  3. Enter the Player ID from the TV screen and save.
  4. The player appears in your list and shows as online within a minute or two. You can now assign a group and playlists.

What next?