Home Assistant HACS

Your IPTV player, inside Home Assistant.

OneTV Connect on Apple TV becomes an ordinary Home Assistant device: a media player with artwork, TV guide sensors and channel selects. Dim the lights at kick-off, pause when the doorbell rings, switch to the news at eight.

Read the setup guide Integration on GitHub

Free · Open source · Local push · Home Assistant 2024.1 or later

OneTV · Apple TVExample

media_player.onetv: playing · France 2 — Télématin
Now playing: France 2
Progress: 62 % · 34 min left
All channels: select · 1,184 options
Audio track: Français
App reachable: on

Illustration with sample values. Entity names and IDs can differ on your install.

WHAT HOME ASSISTANT GETS

Everything the app knows, as entities you can automate.

A real media player.

Artwork, the channel, the programme on air, position and duration, volume and mute. Next and previous change channel, and the source list is your playlist in its own order.

Changes arrive at once.

The app pushes an event stream, so a channel change reaches Home Assistant in well under a second. Polling stays in the background as a safety net.

The TV guide as sensors.

What is on now, its start and end, minutes left and synopsis. During a film or an episode, the same sensor reports the playback position.

Pick a channel from a dashboard.

A select for all channels and one per category, plus selects for the audio track and subtitles of whatever is playing.

The media browser.

Resume, favourites, channels by category, movies and series, straight from the Home Assistant media panel. Thumbnails are padded so logos keep their edges.

Wakes the Apple TV.

Pair the Apple TV entity from Home Assistant’s own Apple TV integration and turn_on wakes the box, opens OneTV Connect, then plays what you asked for.

SET-UP

Five minutes, no token to copy.

The Apple TV announces itself on your network with its access key, so Home Assistant only asks you to confirm.

The full guide, with automations

Turn it on in the app
On the Apple TV: Settings › Integrations › Control & Home Automation › Home Assistant, then Enable Home Assistant.
Add the repository to HACS
HACS › ⋮ › Custom repositories, paste the GitHub address and choose the Integration type.
Install OneTV and restart
Search for OneTV, download it, then restart Home Assistant completely.
Confirm the Apple TV
It shows up under Settings › Devices & services › Discovered. Click Add, and the entities appear.

ACTIONS

Four actions for your scripts.

noopy_tv.play_channel: Plays a channel by name or ID. Case and accents do not matter: “france 2” finds France 2.
noopy_tv.play_movie: Starts a film from the catalogue, optionally at a given second.
noopy_tv.play_episode: Starts an episode by series, season and episode number.
noopy_tv.send_command: Play, pause, seek, back to live, audio or subtitle track, next or previous channel, volume.

# Weekdays at 17:58, the six o’clock news
alias: Six o’clock news
triggers:
  - trigger: time
    at: "17:58:00"
conditions:
  - condition: time
    weekday: [mon, tue, wed, thu, fri]
actions:
  - action: media_player.turn_on
    target:
      entity_id: media_player.onetv
  - action: noopy_tv.play_channel
    data:
      channel_id: "BBC One"

Questions about the integration.

Is the integration free?

Yes. The Home Assistant integration is open source and it does not need a OneTV Pro subscription. You only need OneTV Connect on your Apple TV and Home Assistant 2024.1 or later.

Does it work with any IPTV service?

It works with whatever you have added to OneTV Connect: Xtream Codes, M3U playlists, Stalker portals, Plex, Jellyfin or Emby. Home Assistant sees the same channels and the same guide as the app. OneTV Connect provides no channels of its own.

Does OneTV Connect have to be open?

Its local server runs while the app is open, which is how tvOS works. To start it from Home Assistant, pair your Apple TV entity in the integration options: turn_on then wakes the Apple TV and launches the app.

Does the volume slider change my TV volume?

No. It controls OneTV Connect’s own playback level. The television or receiver volume belongs to HDMI-CEC and the Siri Remote, which a tvOS app cannot reach.

Is anything sent to the cloud?

No. Home Assistant talks to the Apple TV over your local network. The access key is exchanged automatically on your network and never leaves your home.

Can I use it with Alexa or Google Home?

Yes, through Home Assistant. Voice assistants cannot pick a channel by name as a source, so the usual approach is one Home Assistant script per channel, which you then expose to your assistant.

Start with the app on your Apple TV.

Free to download. The Home Assistant integration is included at no cost.