Skip to content
RelayTVRelayTV Docs

Home Assistant

RelayTV for Home Assistant represents each endpoint as a media_player while keeping the playback engine on the Linux host beside the TV.

Compatibility

Section titled “Compatibility”

RelayTV HA 0.4.0 and newer require Home Assistant 2026.7 or newer. Use the current RelayTV server release for compatible realtime state, redaction, and cross-origin thumbnails.

Install through HACS

Section titled “Install through HACS”
  1. Open HACS.
  2. Add mcgeezy/relaytv-ha as a custom repository in the Integration category.
  3. Install RelayTV and restart Home Assistant.
  4. Open Settings → Devices & Services → Add Integration.
  5. Enter the RelayTV base URL, a display name, and the API token if enabled.

What it exposes

Section titled “What it exposes”
  • playback, seek, volume, mute, power, and queue-adjacent controls
  • current title, artwork, progress, and availability
  • smart play, immediate play, temporary playback, and resume flows
  • text or image overlays
  • current-frame snapshots
  • synchronized starts across multiple RelayTV entities
  • local Home Assistant media upload and playback
  • optional RelayTV sidebar panel

Verify

Section titled “Verify”
  1. Confirm the entity is available and current state is visible.
  2. Use the entity controls to pause and resume playback.
  3. Call relaytv.smart_url with a test URL.
  4. Confirm the action targets the intended screen.
  5. If using authentication, verify the token is stored in the config entry and never placed in an automation URL.

Canonical source: RelayTV for Home Assistant README. Reviewed 2026-08-29.