How to Set Up Digital Signage on a Raspberry Pi (2026)

A step-by-step guide to turning a Raspberry Pi into a free, open-source digital signage player using ScreenTinker. Works on Pi 3, Pi 4, and Pi 5.

What you will need

Step 1: Install Raspberry Pi OS

Use Raspberry Pi Imager to flash Raspberry Pi OS (64-bit) to your microSD card. Choose the standard Desktop edition (not Lite - we need a desktop environment for the browser).

In the Imager's advanced options (gear icon), pre-set:

Insert the SD card, plug in the Pi, and let it boot through first-time setup.

Step 2: Run the ScreenTinker installer

Open a terminal on the Pi and run:

curl -sL https://screentinker.com/scripts/raspberry-pi-setup.sh | bash

The script will:

On reboot the Pi will launch directly into the ScreenTinker player and show a 6-digit pairing code.

Step 3: Pair the Pi to your dashboard

Sign in to your ScreenTinker dashboard and click + Add Display. Enter the 6-digit code shown on the Pi and give the display a name (e.g. "Lobby TV"). The Pi will switch from the pairing screen to "Waiting for content".

Step 4: Push content

From the dashboard:

  1. Open Content Library and upload an image, video, or paste a remote URL.
  2. Open Playlists, create a playlist, and add items.
  3. Publish the playlist.
  4. From the device's detail page, assign the playlist.

The Pi picks up the new playlist within a few seconds and starts playing.

Performance tips

Troubleshooting

The Pi reboots into the desktop, not the player

Check that the autostart file ~/.config/autostart/screentinker.desktop exists. The installer creates this; if it's missing, re-run the installer.

The screen goes dark after a few minutes

The installer should disable screen blanking, but some monitors sleep based on their own timer. Disable sleep mode on the monitor itself, or use a dummy HDMI plug if the Pi negotiates a low-power mode.

The Pi shows the pairing code but I can't see it on the dashboard

The pairing code is shown on the Pi screen, not the dashboard. Sign in, click Add Display, and type the code from the Pi.

Ready to set up your Pi?

Start a free ScreenTinker account in under a minute.

Start Free View on GitHub