RelayTV

RelayTV turns a Linux box connected to your TV into a self-hosted, local-first media player and remote-control endpoint.

  • Media Servers
RelayTV turns a Linux box connected to your TV into a self-hosted, local-first media player and remote-control endpoint. It unifies Plex, Jellyfin, Emby, Seerr, web videos, and live channels in a single web interface, so you can browse your libraries, queue media onto the display, and drive playback from Android, Home Assistant, a media server, scripts, or any browser. It's built for self-hosters who want to control a connected TV without the TV's built-in apps or cloud casting.

Platform availability

Available on 1 of 10 platforms

  • Unraid (not listed)
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

69/100 Good

Maintained
100last commit 8 days ago
Popular
4099 GitHub stars
Easy to install
251 install platform, install notes
Light to run
No data
Security check
89no serious findings, 1 minor, CI, tests

Based on 4 of 5 factors.

Availability: platform listings confirmed today

GitHub stars
99
Open issues
3
Last commit
2026-11-12
Latest release
v0.12.2
License
GPL-3.0
Activity
declining

Checked yesterday - source: GitHub (mcgeezy/relaytv)

Resources & Compatibility

Requirements not published yet.

Checked yesterday - source: Docker Hub image tags and published docs

First-install notes

  • Install & first run RelayTV ships as a Docker image for amd64 and arm64. The official installer is interactive — it walks you through each choice and installs Docker for you if the host lacks it, so you don't need to pre-configure the machine. Review the install script first, or force a specific runtime and directory from the install docs. source

Fetched yesterday - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

Is RelayTV a casting app for my existing smart TV?

No. RelayTV is the playback endpoint on a Linux device connected over HDMI, not an app running inside the smart TV.

Can the TV keep playing after I leave the remote page?

Yes. Playback runs on the Linux box, so the phone or browser can leave the remote page while the TV continues.

Do I need Docker installed before first run?

No. The official interactive installer can install Docker if the host lacks it and walks through the runtime and directory choices, though you can force specific settings from the install docs.

What state does RelayTV store on the Linux host?

It keeps a durable queue in SQLite state and history on the host, and the server keys used by the browse and DVR proxy stay on the host.

Can I use the remote outside my home LAN?

RelayTV is designed for trusted LAN use. If you cross an untrusted network, enable the optional bearer token and use a VPN or authenticated reverse proxy.

Answers sourced from github.com, relaytv.app, relaytv.app, relaytv.app

Community

Collected yesterday - public community threads