Jellyfin is the free, open-source media server a lot of us landed on after leaving the walled gardens — no premium tier, no account required, just your own library on your own hardware. The catch on Apple TV has always been the same: typing a server password with the Siri Remote is miserable. This guide walks you through pairing Jellyfin with OneTV Connect using Quick Connect (zero password), then watching your library right next to your live IPTV channels.
Jellyfin + IPTV in one app
Most IPTV apps stop at live channels and a thin VOD list, and most Jellyfin clients ignore IPTV entirely. OneTV Connect does both in one home. Your Jellyfin movies and shows appear in the same rails as your channels, share the same cinematic detail pages, and play through the same multi-engine player. For 4K HEVC files, KSPlayer handles direct play even on Apple TV 4K, so you're not stuck waiting on a server-side transcode when your hardware can decode it locally. If you're weighing Jellyfin IPTV against running two separate apps, the single-app setup is the whole point — one EPG, one player, one favorites list.
Before you start
You'll need three things:
- OneTV Connect installed on your Apple TV (it's a free download on the App Store). The Jellyfin integration unlocks with Pro.
- A running Jellyfin server — on your LAN or reachable over the internet. Jellyfin is free and open-source, so there's nothing to buy.
- A second device signed in to Jellyfin (a phone or laptop with the Jellyfin web UI open) if you want to use Quick Connect. That's where you'll approve the pairing.
Quick Connect must be enabled on your server — it is by default. If it's off, you can turn it on under Dashboard → General in the Jellyfin admin, or just use the username/password fallback described below.
Pairing with Quick Connect on Apple TV
This is the part people dread on a TV, and it's the part OneTV Connect makes painless. Follow these steps:
- Open the Jellyfin integration. In OneTV Connect, go to Settings → Integrations → Jellyfin and tap Add server.
- Let OneTV find your server. On the same network, the app runs a POSIX UDP broadcast on port 7359 across every local subnet and lists your Jellyfin server within about five seconds — no manual URL needed. Not on the LAN? Enter the server URL yourself, for example
https://jellyfin.example.com. Quick Connect works over WAN too. - Request a Quick Connect code. Choose Quick Connect. OneTV asks your server for a one-time 6-character code and shows it on the Apple TV screen.
- Approve it from the Jellyfin web UI. On any device already logged in to Jellyfin, open the Quick Connect screen (usually under your user menu) and type the 6 characters. The moment you confirm, OneTV is authenticated. No password is ever typed on the remote, and none leaves your computer.
That's the full Jellyfin Quick Connect Apple TV flow — it typically takes under two minutes. Prefer the classic route? Username and password still work as a fallback if Quick Connect is disabled on your server.
Browsing your library
Once paired, your Jellyfin libraries populate the home rails alongside your IPTV catalog: Recently Added, Continue Watching, and Search all merge the two sources. Tapping any Jellyfin title opens the same detail page used for IPTV VOD, and when metadata is thin, TMDB fills in the artwork and descriptions. During playback, OneTV reads Jellyfin's intro and outro markers (from the IntroSkipper plugin) and surfaces a native Skip Intro button at exactly the right moment — a feature that isn't Plex-only here. Watch state and progress stay in sync, so a movie you started on your phone shows up in Continue Watching on the TV.
Multi-server & favorites
You're not limited to one server. Add as many Jellyfin servers as you want — your home box, a friend's, a remote VPS — and they appear in a single source switcher with their libraries aggregated into one Recently Added, one Continue Watching, one Search. Each server tracks its own watch positions and favorites, so nothing bleeds across accounts. Favorites are bi-directional: star a movie in the Jellyfin web UI and it shows up in OneTV; star one in OneTV and it appears back in Jellyfin. If you use Trakt, Jellyfin episodes scrobble to your unified Trakt history via TMDB ID, exactly like Plex and Emby do.
Troubleshooting tips
A few things smooth out the rough edges:
- Server not showing up in the list? Aggressive home routers sometimes block UDP broadcast. Enter the server URL manually — Quick Connect still works once OneTV can reach it.
- Quick Connect option greyed out? It's disabled on the server. Enable it under Dashboard → General in the Jellyfin admin, or fall back to username/password.
- Buffering on 4K? Keep the server on your LAN when you can. Hardware acceleration is purely server-side, but for 4K HEVC, KSPlayer direct-plays on Apple TV 4K without leaning on the transcoder.
The four failures worth understanding
Beyond the quick fixes above, almost every persistent Jellyfin problem on Apple TV is one of these four, and each has a tell that identifies it in seconds.
The server is invisible but reachable
Tell: discovery finds nothing, but typing the address works immediately.
Discovery relies on a local broadcast, and that is exactly what guest networks, "AP isolation" and VLAN segmentation are designed to block. Nothing is broken — the TV and the server simply cannot shout at each other, even though they can talk. Use the manual address and move on; discovery is a convenience, not a requirement. If you want it back, the fix is on the router: put the Apple TV and the server on the same subnet.
Everything transcodes
Tell: the server's CPU spikes whenever you press play, and the picture is softer than the file deserves.
Transcoding is the server re-encoding a file because the client claimed it could not play it. Native playback avoids that for the formats that matter, 4K HEVC included. When it does still happen, the usual causes are a subtitle format that has to be burned in, or an audio track the output chain cannot pass through. Try disabling the subtitle track for one playback: if the transcode disappears, you have found it.
Playback works but the timeline does not
Tell: episodes play fine, but Continue Watching never updates, or updates on one device and not another.
Watch state is per-server and per-user. If you paired with a different Jellyfin user than the one you browse with in the web interface, both are working correctly and simply keeping separate histories. Check which user the pairing belongs to before assuming a sync bug.
Remote access is not actually remote
Tell: everything works at home and nothing works away from it.
A local address is meaningless outside the house. Test the exact URL you configured in a phone browser on mobile data with Wi-Fi off — if it does not answer there, no client will reach it, and the problem is port forwarding, a reverse proxy or DNS rather than the app.
What you get once it is connected
Worth knowing before you judge the setup, because several of these are not obvious until you go looking:
- One library, several servers. Add as many Jellyfin servers as you like — home, a friend's, a remote box. Their libraries merge into the same Recently Added, Continue Watching and search results, with watch state tracked per server.
- Your files sit next to your channels. The point of the integration is that you do not switch apps: the library and the live channels live in the same interface, under the same guide and the same player.
- Intro and outro markers are honoured. If your server generates them, the skip button appears at the right moment rather than being a Plex-only luxury.
- Favourites and watch state go both ways. Star something here and it is starred in the Jellyfin web interface, and the other way round.
- Trakt sees all of it. A Jellyfin episode scrobbles like any other, so your history stays in one place regardless of which server you watched from — how Trakt scrobbling works here.
Jellyfin, Plex or Emby — does the choice matter?
All three are supported to the same depth, so pick on their own merits rather than on what this app prefers. Jellyfin is free and open source with nothing phoning home, and Quick Connect makes it the least painful to sign in to on a television. Plex has the most polished metadata and the widest ecosystem, at the cost of an account and a cloud round trip. Emby is the only one of the three with real Live TV built in, which matters if your server already handles channels as well as files.
And you can run all three at once — the libraries merge rather than compete for the interface.
That's it — your Jellyfin library now lives beside your channels in one place. For the full feature breakdown, see the Jellyfin integration page, and if anything gets stuck, the support page has the complete checklist.