Appearance
Set Up ZynoDisplay on Raspberry Pi
WebWorkstationA Raspberry Pi runs ZynoDisplay as a dedicated player. Unlike most platforms, a Pi can drive more than one screen at once, and it can turn the connected TV on and off from ZynoSuite using remote controls.
Pi becomes a dedicated ZynoDisplay device
Every method below produces a dedicated ZynoDisplay player and erases the SD card. ZynoDisplay can't be added alongside an existing Raspberry Pi setup — installing onto an existing Raspberry Pi OS installation while keeping its current software and data isn't supported at this time.
Before You Begin
- A Raspberry Pi (models 1–5 are supported), its power supply, an SD card, and a network connection.
- A screen connected over HDMI before you power the Pi on.
- For the image and netboot methods: another computer with an SD card reader and an imaging tool such as Raspberry Pi Imager or balenaEtcher.
- The Register Device permission in ZynoSuite. See Permissions & Troubleshooting.
Choose an Install Method
There are three ways to set up a Pi. All three result in the same dedicated ZynoDisplay player.
Option 1 — Netboot (recommended)
A single netboot image that works on any supported Pi, so you don't need to match it to your board. Write it to the SD card with Raspberry Pi Imager or balenaEtcher, insert the card, and power on; the Pi pulls down the rest over the network.
Option 2 — Flash a per-model image
A complete image, one per Raspberry Pi model. Download the image that matches your board, write it to the SD card the same way, insert the card, and power on.
| Raspberry Pi model | Image |
|---|---|
| Raspberry Pi 1 | pi1.latest.zip |
| Raspberry Pi 2 | pi2.latest.zip |
| Raspberry Pi 3 | pi3.latest.zip |
| Raspberry Pi 4 | pi4.latest.zip |
| Raspberry Pi 5 | pi5.latest.zip |
Option 3 — Convert an existing Raspberry Pi
If you already have a Pi running Raspberry Pi OS, run this command on it to turn it into a ZynoDisplay device:
bash
curl -L https://get.zynodisplay.com/pios.sh | bashThis wipes the SD card
The command resets the Pi into a dedicated ZynoDisplay player and erases everything on the SD card. It is a reset, not an in-place install — back up anything you need first.
Register the Screen
On first boot the player shows a 9‑digit registration code. Enter it in ZynoSuite to claim the screen — see Registering a Device for the full steps. Once registered, the Pi pulls down whatever content you assign it.
Multiple Screens
A Raspberry Pi can power more than one display at once. Each screen is reported separately and configured on its own. See Screens & Outputs.
Remote Controls
From ZynoSuite you can turn the connected TV or display on and off. The Pi sends the power command to the screen over HDMI‑CEC — this controls the display, not the Pi itself. The Pi keeps running the whole time, which is how it can turn the screen back on later.
For this to work, HDMI‑CEC must be enabled on the TV. Manufacturers brand it differently — Anynet+ (Samsung), Bravia Sync (Sony), SimpLink (LG), VIERA Link (Panasonic), and so on — and the Pi must be plugged into an HDMI port that supports CEC.
See Remote Control & Management.
Common Issues
| Problem | What To Check |
|---|---|
| Pi boots to Raspberry Pi OS instead of ZynoDisplay | The image or reset didn't take. Re‑flash the SD card, or re‑run the reset command (it wipes the card). |
| Not sure which image to use | Use the netboot image — it works on any supported Pi model. |
| No registration code appears | Confirm the HDMI screen is connected and the Pi has network access. First boot can take a few minutes. |
| Can I keep my existing Pi software? | No — a ZynoDisplay Pi is a dedicated device. All install methods erase the SD card. |
| Only one screen shows up | Each output is configured separately; see Screens & Outputs. |
| TV won't turn on or off from ZynoSuite | Enable HDMI‑CEC on the TV (Anynet+, Bravia Sync, SimpLink, VIERA Link), and connect the Pi to an HDMI port that supports CEC. |
| Can't fill out a ZynoForm on the Pi | Forms are interactive — attach a touchscreen, or a keyboard and mouse. The Pi has no built‑in input. Web page and other content types don't need this. |