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.

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.