Skip to Content
PlayersLinux & Raspberry Pi

Linux & Raspberry Pi

Veyli Player runs on Debian 11+ / Ubuntu 22.04+ (x86_64 and arm64) and on Raspberry Pi 4 and Pi 5 with 64-bit Raspberry Pi OS (Bookworm or later). A Raspberry Pi is an inexpensive, reliable choice for menu boards and notice screens.

Install

The quickest option on any supported distribution. It installs the player, a systemd service, and kiosk auto-start:

curl -fsSL https://veyli.cloud/install.sh | sh

32-bit Raspberry Pi OS and Pi 3 or older are not supported — they lack the memory and video decoding needed for reliable playback.

Pair the screen

The player shows a 6-character pairing code full screen. In app.veyli.cloud  go to Screens → Add screen, enter the code, name the screen and choose its screen group and timezone. See Pair your first screen.

If the device is headless or you’re working over SSH, print the code with:

veyli-player status

Kiosk and auto-start

The install script configures:

  • A veyli-player systemd service that starts on boot and restarts on crash
  • Desktop auto-login and a full-screen session with no panels, cursor or screen blanking

Useful commands:

sudo systemctl status veyli-player     # is it running?
sudo journalctl -u veyli-player -f     # live logs
sudo systemctl restart veyli-player    # restart the player

Offline caching

  • Media is cached in /var/lib/veyli/cache, up to 80% of free storage.
  • On a Pi, use a quality A2 microSD card (32 GB+) or, better, boot from a USB SSD for longevity.
  • The player keeps playing its schedule indefinitely while offline.

Tips

  • Pi 5 + 4K: the Pi 5 decodes H.265 in hardware; prefer H.265 for 4K content. The Pi 4 is best kept at 1080p.
  • Cooling: use a case with a heatsink or fan — a throttling Pi drops frames.
  • Power: use the official power supply. Undervoltage causes random reboots that look like offline screens.
  • Display rotation: set rotation in the dashboard screen settings; the player handles it.
WindowsChromeOS