Setting it up, start to finish
Emby signs clients in with an API key rather than a pairing code, so the one thing to get
right is generating the key on the server first.
- Create the key on the server. In the Emby dashboard, open Advanced →
API Keys and create a new key for OneTV Connect. Copy it — it is shown as a long
hexadecimal string.
- Add the server in the app. Settings → Integrations → Emby → Add server.
- Enter the address and the key. Include the port if the server is not
behind a reverse proxy, for example
http://192.168.1.20:8096.
- Pick what you want. Your libraries appear alongside your playlists, and
Emby Live TV channels join the same channel list as your M3U and Xtream sources.
The longer walkthrough, including how Live TV channels merge with your playlist channels,
is in the Emby on Apple TV guide.
Emby Live TV next to your IPTV channels
This is the thing Emby does that the other two do not. If you already run tuners or an
M3U through Emby, those channels do not stay in a separate app: they land in the same
channel list as your other sources, under the same guide, played by the same engine.
That matters for anything built on top of the guide. Catch-up and
timeshift are navigated through the EPG, and the
Sport Centre matches live scores against whatever channel you
are watching, no matter which source it came from.
One caveat worth knowing before you plan around it: guide quality still comes from
wherever the guide comes from. If Emby's Live TV listings are thin, they will be thin here
too — see choosing an EPG source.
When something does not connect
- The API key was rejected. Keys are per-server, and a key copied from a
different Emby install will always fail. Regenerate it in the dashboard of the server
you are actually pointing at.
- The URL is missing its port. An Emby server that is not behind a reverse
proxy answers on a port, and the bare IP will not reach it.
- Remote access is not reachable. Test the same address in a phone browser
on mobile data. If it does not answer there, it will not answer from the app either.
- Libraries connect but stay empty. The user the API key belongs to has to
have access to those libraries. Check the user's library permissions in the Emby
dashboard rather than re-adding the server.
Emby, Plex or Jellyfin inside OneTV Connect?
All three are supported to the same depth. What actually separates them here:
- Emby — the only one of the three with real Live TV built in, so it is
the natural pick if your server already handles channels as well as files.
- Plex — the most polished metadata and the widest ecosystem, at the cost
of an account and a cloud round trip. Plex integration.
- Jellyfin — free, open source, nothing phoning home, and the easiest to
sign in to on a TV thanks to Quick Connect.
Jellyfin integration.
They are not mutually exclusive: connect several servers of several kinds and their
libraries merge into one Continue Watching, one Recently Added and one search, next to your
live channels.
Do I need an Emby Premiere subscription?
No. OneTV uses the public Emby Server API which works on every tier. Premiere-only Emby features (such as DVR, Cinema mode) come from the server side and don't depend on the client.
What is Emby Live TV exactly?
If your Emby server is connected to a tuner (HDHomeRun, USB DVB stick, Tvheadend backend…), it exposes a list of TV channels with EPG. OneTV pulls that list via `/LiveTv/Channels` and `/LiveTv/Programs` and renders the channels alongside your M3U/Xtream sources — one unified Live tab.
How do I create an API key?
In Emby web UI, go to Settings → Advanced → API Keys, click +, name the key (e.g. "OneTV Apple TV"), copy it. Paste it into OneTV when prompted. You can revoke it at any time from the same screen.
Will it scrobble to Trakt?
Yes — when an Emby movie or episode plays in OneTV, the TMDB ID is resolved and a scrobble is sent to Trakt. The same logic handles Plex and Jellyfin: one Trakt history across all your media servers.
Multiple Emby servers?
Yes. Each server is its own source. Libraries aggregate into the same Recently Added / Continue Watching rails, and Live TV channels merge into the same guide.