Introduction

What You’ll Need to Build a Raspberry Pi-Based Digital Signage OS Player.

To build a Digital Signage OS Player, you need a Raspberry Pi and a few essential accessories.

Required Components

• Raspberry Pi
  • Recommended: Raspberry Pi 4B (4GB or 8GB models are ideal for heavier usage like multiple web dashboards or webpages)
  • Fully Supported Models: Raspberry Pi 4 (1GB+), 3 B+, 3, 2, and Compute Module 3
• MicroSD Card
  • Minimum 8GB Class 10 (preferably 16GB from a known brand)
  • Note: Yodeck software uses ~3.5GB, rest is for media
• Power Supply
  • Pi 4: 5V/3A
  • Pi 3: 5V/2.5A
  • Pi 2: 5V/2A
• SD Card Reader
  • For flashing the software from your computer
• Internet Connection
  • Ethernet preferred for setup; WiFi is also possible

🔧 Optional But Useful

• Raspberry Pi Case
  • Plastic is fine, but metal is preferred for better cooling
• HDMI Monitor or TV
  • You’ll need a screen to see the output
• Ethernet Cable
  • Especially helpful if you don’t want to configure WiFi immediately

Installing Digital Signage OS Software on the SD Card (Step-by-Step)

1. Download the Latest Image
   • You’ll get a .zip file—extract it to get a .img file (~3.2GB)
2. Download & Install Etcher
   • Etcher is a free tool to flash images to SD cards
   • Compatible with Windows, macOS, and Linux
3. Flash the Image to the SD Card
   • Insert your SD card into your reader
   • Launch Etcher
   • Select the .img file and the SD card as the target
   • Click “Flash!” and wait until it completes
4. Insert the SD Card into the Raspberry Pi
   • Connect the Pi to a TV/monitor via HDMI
   • Plug in the Ethernet cable (optional)
   • Power up the Pi
5. Wait for Initialization
   • Takes up to 5 minutes
   • The screen will display a Registration Code or an Internet Error Message
6. ⚠️ Do not unplug the Pi during this stage if the screen shows messages like “Loading”, “Configuring”, or “Downloading.”

Registering the Raspberry Pi Player on Your Account

Once the Player is powered and showing a registration screen:

1. Log in to your Digital Signage OS Account
   
   
2. Add Your Player
   • Go to Screens > Click + Add Screen
   • Enter the 8-digit Registration Code shown on your screen
   • Click Save
3. You’re Live!
   • After about a minute, the player should sync and start showing content
4. 💡 If there’s a connection error, switch to a wired Ethernet connection.

Solving Internet Access Issues

If your DIY Raspberry Pi can’t connect to the Internet:

• Wired (Ethernet) is the easiest and most reliable way to go online for the first setup
• If using WiFi, follow the guide below.

Once online, you can manage all settings (including WiFi or proxy configs) from the Digital Signage Control Panel.

Here’s a guide for connecting your DIY Raspberry Pi to a WiFi network:

1. Prepare WiFi Credentials in Digital Signage OS CMS

First, enter your desired WiFi network’s credentials in your Digital Signage OS account. Select the player’s name, go to the Network tab, toggle “Enable WiFi” to ON, and input the details. Remember to click “Save”. For simple networks (SSID/Password), always use the WPA/WPA2 option.

2. Initiate the WiFi Wizard on the Player

Next, plug a USB keyboard into any of the player’s USB ports. Then, simultaneously press Ctrl+Alt+F12 (or Ctrl+Alt+F10 for Raspberry Pi 5).
After 4-6 seconds, a new screen will appear.

• Important: Avoid using wireless or Mac keyboards, as they are not compatible.

3. Log In to Your Player

To proceed, you’ll need the player’s Remote Support Password. Log in to your Digital Signage OS account, click the player’s name, and navigate to the Advanced -> Security tab. Locate the 8-digit password in the “Remote Support Password” field. Type this password using the connected keyboard and press Enter.

4. Connect Using the WiFi Wizard

Once logged in, the player will automatically scan for nearby WiFi networks.

• Choose your desired network and press Enter. (You can also configure Enterprise WiFi networks (EAP) here).
• Type the WiFi password (it’s case-sensitive) and press Enter.
• The player will attempt to connect. If credentials are correct, it should connect smoothly.
• Finally, select “Yes” to save the WiFi settings and apply the new configuration. During this “Configuring” phase, do not reboot the player.

Need Help?

Our Support Team can help you out!