Docs Setting up screens
Supported hardware
Which player devices work, what to buy and how to size them.
A screen is a display plus a small computer that runs the player. Any TV or monitor with HDMI works; the computer is what matters.
Recommended players
| Device | Image | Good for |
|---|---|---|
| Mini PC / NUC (Intel N100 or similar, x86-64) | USB installer | The best all-rounder. Smooth 1080p video, fast web pages, 4K-capable. |
| Thin client (used business thin clients, x86-64) | USB installer | Cheap and reliable for image, text and 1080p video slides. |
| Raspberry Pi 4 / 400 / CM4 | Raspberry Pi image | Budget screens with mostly images, text and clocks. Video plays, but a mini PC is smoother for video-heavy playlists. |
| Raspberry Pi 5 | Raspberry Pi image | Where the Debian kernel supports it. |
| Any existing Debian 13 machine | Agent package | Reusing hardware you already have. See installing the agent. |
x86-64 machines must boot with UEFI or legacy BIOS; Secure Boot is supported.
Sizing
- Storage: a screen caches the media it currently plays, up to 8 GB by default. A 32 GB disk or SD card is plenty for most screens; get more (and raise the cache limit) if a screen plays lots of long videos.
- Memory: 4 GB is comfortable. 2 GB works for image and text slides.
- Network: Ethernet is the most reliable. Wi-Fi is fully supported, and the screen can set it up itself — see networking.
Displays
- Use the display's HDMI-CEC or energy settings to turn it off at night if you like; the player doesn't mind.
- Disable the TV's own "eco" dimming and overscan for crisp edges ("Just scan", "Screen fit" or "1:1 pixel" in most TV menus).
- Mount screens in portrait if you want — set the screen group's orientation and the player rotates the picture.
Ready-to-run players
Don't want to install anything? We can ship pre-installed players that only need power, HDMI and a network. Contact us for current models.
Something unclear or out of date? Tell us.