Setting it up, start to finish
The whole thing takes about two minutes on a normal home network, and the awkward part —
typing a password on a Siri Remote — is the part you get to skip.
- Open the integration. In OneTV Connect, go to Settings → Integrations →
Jellyfin, then choose Add server.
- Let it find the server. On the same network, your Jellyfin server
announces itself and appears in the list within a few seconds. If it does not, you can
type the URL yourself — including the port, for example
http://192.168.1.20:8096.
- Ask for a Quick Connect code. OneTV displays a six-character code on the
TV screen.
- Approve it from any signed-in device. Open your Jellyfin web interface,
go to Quick Connect and enter the code. Pairing completes and your password never leaves
the machine you typed it on.
The step-by-step version with screenshots and the edge cases lives in
the full Jellyfin on Apple TV setup guide.
What plays without transcoding
Transcoding is what makes a server fan spin up and a stream look soft. The way to avoid it
is for the client to handle the file as it is, and that is what a native player buys you.
On Apple TV 4K, OneTV Connect direct-plays the formats that matter — including 4K HEVC —
rather than asking the server to re-encode them.
When a file genuinely cannot be played as-is, the standard Jellyfin transcoder takes over,
and any hardware acceleration you have configured on the server applies exactly as it
would for any other client. That part is server-side and OneTV does not change it.
If a specific file stutters, the player engine is worth a look before the server is:
the engines behave differently on 4K and
high-frame-rate content.
When something does not connect
Four causes account for nearly every failed Jellyfin pairing.
- The server never appears on the network. Discovery relies on a local
broadcast, and plenty of routers block exactly that — guest networks, "AP isolation",
and a TV on a different VLAN from the server all have the same effect. Enter the address
manually; discovery is a convenience, not a requirement.
- Quick Connect is switched off on the server. It is a Jellyfin setting,
not an app setting. If the code is refused, enable Quick Connect in the server dashboard,
or sign in with a username and password instead.
- The URL is missing its port. A Jellyfin server that is not behind a
reverse proxy answers on a port, and
http://192.168.1.20 alone will not
reach it. Include :8096, or whatever you configured.
- Remote access is not actually reachable. Pairing from outside the house
needs a URL that resolves and answers from outside the house. Test the same address in a
phone browser on mobile data before blaming the app.
Jellyfin, Plex or Emby inside OneTV Connect?
All three are first-class here — this is not a Plex app with two afterthoughts bolted on.
The differences that matter in daily use:
- Jellyfin — free and open source, no account and no company in the
middle. Quick Connect makes it the least painful to sign in to on a TV. Best fit if you
self-host and want nothing phoning home. Setup
guide.
- Plex — the most polished metadata and the widest ecosystem, at the cost
of an account and a cloud round trip.
Plex integration.
- Emby — the one of the three with real Live TV built in, which matters if
you already run channels through your server rather than only through a playlist.
Emby integration.
You do not have to choose. Several servers of several kinds can be connected at once, and
their libraries merge into the same Continue Watching, Recently Added and search results,
alongside your live channels.
Do I need a paid Jellyfin account?
No. Jellyfin is free and open-source — there is no premium tier. OneTV uses the standard Jellyfin API and works with any self-hosted server.
How does Quick Connect work?
OneTV asks your server for a one-time 6-character code. You go to your Jellyfin web UI (already signed in), open Quick Connect, type the code, and OneTV is paired. No password ever leaves your computer. Especially handy on Apple TV where typing is painful.
Can I use it without LAN access?
Yes. Enter your server URL manually (e.g. https://jellyfin.example.com) and OneTV connects over WAN. Quick Connect works over WAN too.
Does it work with the Hardware Acceleration on the server side?
Yes — that's purely a server-side feature. OneTV transcodes when needed via the standard Jellyfin transcoder. For 4K HEVC content, KSPlayer handles direct play even on Apple TV 4K (3rd gen).
Multiple Jellyfin servers in one app?
Yes. Add as many as you want — they appear in a single source switcher and their libraries aggregate. Each server tracks its own watch positions and favorites.