Skip to content
Swiftly Music Blog Discord GitHub
  1. Swiftly Player
  2. Blog

Jellyfin on Apple TV with multiple users: profiles and switching

How tvOS profiles work, which Jellyfin apps tie a login to each Apple TV user, Quick Connect sign-in, and server-side parental controls.

By Swiftly Player13 min read

Disclosure: we build Swiftly Player, one of the clients in this article. We point out where other apps do better.

Version numbers, feature claims and support-page wording come from Apple's own support guide, each project's GitHub repository and its documentation, checked in September 2026.

TL;DR

  • Apple TV has had system-level user profiles since tvOS 15, with Control Center's "Switch Profiles" screen letting anyone jump between them (Apple Support). tvOS 16 gave third-party apps a proper way to follow along, replacing an older manual mapping API (WWDC22 session 110384).
  • "Following along" does not happen by itself. Most Jellyfin apps still show one login screen regardless of which tvOS profile is active; only a few tie a Jellyfin account to each Apple TV profile.
  • Swiftly Player does this: per its README, switching the tvOS profile switches which Jellyfin account is signed in, with no separate step inside the app. Infuse also recognizes a tvOS profile switch automatically, though its own community has reported the mapping to a specific Jellyfin account being unreliable. Swiftfin has an in-app account switcher, but linking it to the tvOS profile itself is an open, unimplemented request.
  • Quick Connect lets you add a second or third Jellyfin account on a TV without typing a password on the remote — see the full Quick Connect guide.
  • Parental limits belong on the Jellyfin server, not in any one app: a maximum content rating, blocked or allowed tags, and per-library access, all set per user under Dashboard > Users (Jellyfin docs).

What a tvOS profile actually is

Apple TV's own multi-user system predates most of this. Anyone can add a user from Control Center: press and hold the TV button on the remote, open Control Center, and choose "Add User" or a profile that already exists (Apple Support). Once several people are set up, switching between them is the same two steps — hold the TV button, pick a profile — and, according to Apple's guide, "the previous user is signed out, and the TV and Music apps refresh with the new user's unique Watchlist, video or music collections, and recommendations." The same guide notes one exception: switching users does not touch the Photos app or other settings tied to the Apple TV's default Apple Account.

That is the built-in behaviour for Apple's own apps. Third-party apps such as Jellyfin clients have to opt in separately, and the way they are allowed to opt in changed over time:

  • tvOS 14 gave apps the ability to "run as the current user" at all, according to Apple's WWDC 2022 session on the topic.
  • tvOS 16 replaced the earlier approach. The same session states plainly: "In tvOS 16 we've deprecated the methods to manually map profiles to system users in TVUserManager." In its place sits a "Runs as Current User" entitlement — turn it on, and, in Apple's words, "tvOS takes care of everything. Privacy and security, all handled by the system." Apple's developer documentation for this is titled "Mapping Apple TV users to app profiles".

In practice this means an app built against tvOS 16 or later can ask the system which profile is active and be notified when it changes, without maintaining its own mapping table. Whether a given Jellyfin client actually does anything useful with that information is a separate question, answered below app by app.

Which Jellyfin clients tie a login to the tvOS profile

ClientTies Jellyfin login to the tvOS profileHow switching works todaySource
Swiftly PlayerYesSwitch the Apple TV profile in Control Center; Swiftly is in that person's Jellyfin account automatically, no in-app stepREADME
InfuseRecognizes the tvOS profile switch automatically, but Jellyfin-account mapping across profiles is reported as unreliableEach Infuse profile keeps its own settings, network shares and parental controls; some users report a Jellyfin account change on one profile leaking into anotherFirecore support, Firecore community thread
SwiftfinNo, open feature requestSwitch accounts from Swiftfin's own in-app screen, independent of the tvOS profileGitHub issue #258
JellyTVNot documented for automatic tvOS tie-inSupports "multiple Jellyfin user profiles" managed inside the app; a plugin issue references per-profile token handlingJellyTV, JellyTV-plugin issue #2
StreamyfinNot documentedREADME does not mention tvOS system profilesREADME
Jellyfin for Android TV, Kodi add-onsNot applicableThese run on Android TV / Fire TV, not Apple's tvOS—

Swiftly Player's own Android app, joined through swiftlyplayer.com/android, does not have an equivalent system-level profile picker to follow on Android or Android TV — Android has no OS feature quite like tvOS profiles, so the several-accounts-at-once approach described below is what carries over there instead.

Swiftly Player

Swiftly's own description of this, from its README: "The Apple TV already knows who is watching — it has profiles at the top of the screen. Swiftly follows them. Switch the tvOS profile, and Swiftly is in that person's Jellyfin account. Their Continue Watching, their watched marks, their Top Shelf on the home screen. Nobody has to sign anything in or out; the television already asked the question, and the app simply respects the answer." Each profile's Jellyfin login is set up once; after that, the person watching does not interact with Swiftly's sign-in screen at all, because the tvOS profile decides which account is active.

Infuse

The free Infuse alternatives comparison covers Infuse's pricing and format support against the other apps named here. Infuse's own support article on multiple user profiles confirms the tvOS side works as intended: "When switching to a new profile, Infuse will recognize this automatically," with each profile keeping independent viewing history, ratings, parental controls, network shares and even connected Trakt accounts. Where it gets less clean is Jellyfin specifically. A Firecore community thread from 2026 describes users who set up one Infuse profile per family member, each meant to hold a different Jellyfin account, finding that changing the Jellyfin account on one profile also changed it on another, or that profile switching left the wrong account signed in. Firecore's own known-issues note for the current tvOS release also lists an unrelated bug where the Up Next list on the Apple TV Home Screen does not refresh correctly across profile switches, even though it is correct inside the app. None of this makes Infuse unusable with several Jellyfin accounts, but it means the tvOS-profile-to-Jellyfin-account link is less dependable there than Apple's own profile switching is for Apple's apps.

Swiftfin

Swiftfin, the Jellyfin project's own tvOS and iOS client, takes a different approach: it has its own user-switching screen inside the app, unrelated to which tvOS profile is active. A 2022 GitHub issue asked for exactly the feature described above — automatically switching the Jellyfin account when the Apple TV user changes, using Apple's TVServices framework — and remains open, marked "Blocked" in the project's own roadmap. A separate, later request, issue #855, asks for the in-app switch itself to be quicker, which suggests the current one works but takes more steps than tapping a tvOS profile. If several people share one Apple TV and each wants their own Jellyfin account in Swiftfin today, they switch inside the app rather than relying on the profile picker. The Swiftfin alternatives comparison covers what else differs between Swiftfin and the other clients named here.

JellyTV and Streamyfin

JellyTV's own site describes support for "multiple Jellyfin user profiles," managed as part of the app rather than through Apple's profile system as far as its published pages describe. A bug report against a companion JellyTV plugin — "tvOS: detail requests intermittently use the wrong Jellyfin profile token" — shows that JellyTV does keep separate Jellyfin tokens per profile internally, but nothing in JellyTV's public documentation states that switching the tvOS system profile switches which of those tokens is active, so that link is left as not verified here. Streamyfin's README does not mention tvOS system profiles at all.

Switching Jellyfin users inside an app

Not everyone wants — or has — separate tvOS profiles for every household member. Every Jellyfin client that supports multiple accounts also has some form of in-app switching, and most of them can use Quick Connect to add a new account without typing a password on the remote.

The general shape of adding an account through Quick Connect, from the official Jellyfin documentation:

  1. On the TV, start signing in and choose Quick Connect instead of typing a password. A short code appears on screen.
  2. On a phone, tablet or computer that is already signed in to the same server, open its Quick Connect setting, enter that code, and confirm.
  3. The TV signs in automatically, without ever seeing a password.

The Quick Connect documentation's own client table lists which official and community apps can do which half of this exchange. TV-focused clients — Jellyfin for Android TV, Jellyfin Roku, JellyCon, Swiftfin on tvOS — can sign in with a code but cannot approve one shown elsewhere, for the practical reason that approving means typing a code in, which a TV remote is bad at. Every detail of this, including the server-side timeout and code length, is covered in the dedicated Quick Connect article.

Once two accounts exist inside one app, switching between them is app-specific: Swiftfin's own in-app screen (described above), Swiftly Player's profile strip on iPhone, iPad and Mac, or a server sign-out and sign-in for apps that only support one active account.

Parental controls live on the server, not in the app

Whichever Jellyfin app a child uses, the limits that actually hold are the ones set on the server, because every client reads the same restrictions from the same account. The Jellyfin documentation on managing users describes four tabs per user in the Dashboard: Profile, Library Access, Parental Control and Password.

Library Access controls which parts of the server a user can even see. With "Enable access to all libraries" turned off, an admin grants access library by library — so a kids' account might see only a Cartoons library and nothing else. A second toggle, "Enable access from all devices," works the same way for which devices are allowed to sign in as that user at all.

Parental Control works on content already inside a visible library:

  • Maximum allowed parental rating — the highest rating that shows up at all for this user; anything rated higher is hidden as if it did not exist.
  • Block items with no or unrecognized rating information — hides anything Jellyfin could not classify, rather than letting it through by default.
  • Block items with tags / Allow items with tags — filters based on tags set on the metadata itself, for finer control than a single rating cutoff allows.
  • Access Schedule — restricts which hours of the day (and which days) the account can be used to sign in or keep playing at all; the documentation notes that playback stops once the window closes.

None of these settings live in Swiftly Player, Swiftfin, Infuse or any other client — they apply the moment that Jellyfin account is used anywhere, on any device, which is also why setting them up on the server is the only way they hold regardless of which Apple TV profile, phone or client someone picks up.

The phone and Mac side: several accounts, one server

Apple TV profiles are one way to keep accounts separate; the other is simply holding more than one Jellyfin account inside the same app, on a device that has no system-level profile picker of its own — an iPhone, iPad, Mac, Windows PC or Linux desktop. This side of the picture is covered in more depth in watching Jellyfin across devices. Support for this varies by client. Swiftfin lets you save several users per server and switch between them from its own sign-in view, work that shipped in pull request #1045. Swiftly Player keeps every added account signed in at the same time rather than switching one active session for another: per its README, "Above 'Sign out' there is 'Add another account'. After that, a strip at the top of your profile switches between them: press a picture, and you are in that account. No password, no signing out, no waiting — both logins stay in the keychain." Signing out of one account in Swiftly does not touch the others.

FAQ

Does Apple TV support multiple user profiles?

Yes. Apple TV has had system-level profiles since tvOS 15, switched from Control Center by holding the TV button on the remote and picking a profile (Apple Support). Each profile gets its own Watchlist and recommendations in Apple's own TV and Music apps.

Does Jellyfin automatically switch accounts when I switch Apple TV users?

Only in apps built to follow the tvOS profile. Swiftly Player does this, per its README. Infuse recognizes the tvOS profile switch but its community has reported the specific Jellyfin account mapping being unreliable across profiles. Swiftfin does not; it has its own separate in-app account switcher instead, and automatic tvOS-profile mapping remains an open GitHub request.

How do I add a second Jellyfin account to a client on Apple TV without typing a password?

Use Quick Connect. Start signing in on the TV, choose Quick Connect, and enter the resulting code from a phone, tablet or computer that is already signed in — see the full walkthrough.

Can I stop a child's account from seeing certain movies or shows?

Yes, but it is set on the Jellyfin server, not in any app. Under Dashboard > Users > (the child's account) > Parental Control, set a maximum allowed rating, block unrated items, or block and allow specific tags. Library Access on the same account can also hide entire libraries. See Jellyfin's own documentation.

Can two people use different Jellyfin accounts on the same iPhone or Mac?

Yes, in apps that support it. Swiftfin lets you save and switch between several signed-in users per server. Swiftly Player keeps several accounts signed in at once, switched with a tap, without signing out of the others.

Is tvOS profile switching the same as Jellyfin's own user accounts?

No — they are two separate systems that some apps connect and others don't. A tvOS profile is Apple's own concept, tied to the Apple TV hardware and Apple's apps by default. A Jellyfin user account lives on your server. Only a client built to read the current tvOS profile, like Swiftly Player, links the two together automatically.

Summary

Apple TV's own multi-user system is old news by now — profiles since tvOS 15, switched from Control Center, with tvOS 16 giving apps a proper, Apple-maintained way to follow the active profile instead of managing their own mapping. Whether a Jellyfin client uses that is a different matter for each one: Swiftly Player ties a Jellyfin login to every Apple TV profile automatically, Infuse recognizes the profile switch but has documented reliability issues doing the same with Jellyfin accounts specifically, and Swiftfin keeps its own in-app switcher with tvOS integration still an open request. Quick Connect makes adding any of those accounts painless from a device that already has a keyboard. And whatever a child is or isn't allowed to watch is a setting on the Jellyfin server itself, under Parental Control and Library Access, which holds no matter which app or which profile they pick up.

Related articles

All articles