Swiftfin tvOS - Status Update #1294
Replies: 31 comments 91 replies
-
|
So this is the reason why I still see Swiftfin 1.0.1 on tvOS? I really hoped when I saw the change log for Swiftfin 1.2 it would also be available on tvOS. |
Beta Was this translation helpful? Give feedback.
This comment was marked as off-topic.
This comment was marked as off-topic.
-
|
Firstly, I just want to thank you for all the hard work here, I think we are alot of TVOS users that are quite existed about the prospect of this update. With that said, I really would plead for you to bump the prioritisation of "Reactive Home Screen". As my understanding is, the "Up next" bug is going to be As somebody that watches a lot of series, I'd go so far to say that not having to manually browse for the next episode of a TV series, every time I want to continue watching, represents the biggest quality of life improvement I can think of in the currently client (which otherwise works fairly well for me). |
Beta Was this translation helpful? Give feedback.
-
|
I know I've been saying "I want to help out" and haven't pulled through, mostly because my 2018 MBP was crapping out and I was waiting for the M4 release. I have a new MBP now so I'd like to [finally] jump in! Since tvOS has been one of the biggest asks from the community I want to focus there, could I get a bit of an explanation (or be pointed to previous discussions) of what needs to be done for the items in the Not Started section? |
Beta Was this translation helpful? Give feedback.
-
|
I don't want to "inject" too much noise here, so, sorry for "moaning" about this, but please don't forget about the letter picker, if one uses the current tvOS version and one has a lot of entries under movies, it is impossible to navigating quickly (yes I know about search, but thats not "navigating quickly") with the letter picker Thanks again to the devs for your work ! |
Beta Was this translation helpful? Give feedback.
-
|
Many of the playback issues mentioned in the "Solve these issues" section were solved with the device profile builder refactor in #519. (And then IIRC the opus ones subsequently when you did the refactor of device profiles.) Which is to say that not all those open issues need work, but they haven't been closed because they still occur in the latest released build - which is outdated. |
Beta Was this translation helpful? Give feedback.
-
|
is there any rough timeline or release date for the coming tvos version? really can't wait for it! |
Beta Was this translation helpful? Give feedback.
-
|
is it possible to join the testflight for this? |
Beta Was this translation helpful? Give feedback.
-
|
I would love to jump in and help get the tvOS application up to date. Are you looking for contributors? |
Beta Was this translation helpful? Give feedback.
This comment was marked as off-topic.
This comment was marked as off-topic.
This comment was marked as off-topic.
This comment was marked as off-topic.
This comment has been hidden.
This comment has been hidden.
-
|
Hi guys! First of all, thank you for all the time and effort you put into this project as a volunteer. Since there are a lot of changes after 1.0.1, is it even helping you guys opening new issues based on that "old" AppStore version? |
Beta Was this translation helpful? Give feedback.
This comment was marked as spam.
This comment was marked as spam.
This comment was marked as spam.
This comment was marked as spam.
This comment was marked as off-topic.
This comment was marked as off-topic.
This comment was marked as off-topic.
This comment was marked as off-topic.
-
|
Hi All, I wanted to make a comment to give a quick notification and update on where we stand now. I've updated our main discussion to reflect the completion of #1581. This is a huge milestone for Swiftfin and I want to applaud @LePips for the absolute insane amount of time, effort, and work that went into this feature! In addition to the existing improvements, this change opens a lot of doors for us and helps us move quicker towards future features. For the next tvOS release, there is some cleanup post-1581 that's in the works right now and we need to make a tvOS specific UI to put on top of the new media player. Finally, tvOS 26 appears to have broken some our navigation so this will need to be tackled as well. This being said, we're in the end stages now! We appreciate everyone's patience and all of the volunteers who have worked on making Swiftfin a reality. I will update this post with any additional information as it becomes available. You can find our current status in the main section of this discussion now up-to-date! |
Beta Was this translation helpful? Give feedback.
This comment was marked as off-topic.
This comment was marked as off-topic.
-
|
Thanks for your hard work! If you weren’t already aware, the sheet behaviour in tvOS 26 seems to be unintended by Apple. It is listed as a known issue in the 26.1 beta. Maybe it’s one less thing for you to worry about or is this something you would still need to address in the meantime? https://developer.apple.com/documentation/tvos-release-notes/tvos-26_1-release-notes |
Beta Was this translation helpful? Give feedback.
This comment was marked as spam.
This comment was marked as spam.
-
|
Hi Team, Thanks for much for all your work on Swiftfin. The next tvOS update looks very exciting! I'm looking for a little guidance on upgrading Jellyfin to 10.11. Do we need to wait until #1772 is pushed to both the iOS and tvOS apps before we upgrade the server? Will functionality fully or partially break if we upgrade to 10.11 before the respective apps? I'm bringing this up in the tvOS specific thread because traditionally tvOS updates have taken longer than iOS, so if waiting is required it may be more relevant to folks paying specific attention to this thread. |
Beta Was this translation helpful? Give feedback.
This comment was marked as off-topic.
This comment was marked as off-topic.
This comment has been hidden.
This comment has been hidden.
This comment was marked as off-topic.
This comment was marked as off-topic.
This comment was marked as off-topic.
This comment was marked as off-topic.
This comment was marked as off-topic.
This comment was marked as off-topic.
-
|
Thanks for all the hard work on getting this update ready. I’m really hoping we can get this update out soon cause I use HomePod stereo pair for tv audio and have been forced to use the Android TV app due to the audio sync bug for the last few months, and would love to set my tv back to “Basic TV Mode”. |
Beta Was this translation helpful? Give feedback.
-
|
Hey guys, I really want to be able to contribute but am not proficient in Swift or iOS/tvOS development. So I wanted to instead ask if I could donate money that would be used to pay developers to work on this tvOS release and hopefully speed up its progress? I noticed this repo links to Jellyfin's OpenCollective donation page and on there the Jellyfin team has made a post asking people to stop donating since they have enough money in the bank to run development for the next 3 years. Seems like these donations are only going to the Jellyfin media server developers and not to client makers like the developers of Swiftfin? Have you considered creating your own donation page and linking to it? I am at least willing to provide a couple hundred bucks. Really appreciate your efforts and I will keep on patiently waiting for another tvOS release. |
Beta Was this translation helpful? Give feedback.
-
|
Thanks for all the hard work. The UI already looks great. Can't wait for more functionality on the system. Is there anyway to provide help for this project? |
Beta Was this translation helpful? Give feedback.

Uh oh!
There was an error while loading. Please reload this page.
Uh oh!
There was an error while loading. Please reload this page.
-
Last Updated | 2026-01-12
Currently, Swiftfin for tvOS is not yet ready for TestFlight. Some delays are due to shared components between iOS/iPadOS and tvOS (such as the Video Player Manager), while others stem from challenges unique to tvOS. Developing for tvOS tends to introduce quirks that make progress slower, such as more limited support for SwiftUI on tvOS, cursor focus management, and a more complex process to test builds on real hardware than with iOS.
That said, we are actively working to get the next version of Swiftfin for tvOS ready for testing. Below is an outline of our progress, detailing both what has been achieved and what remains to be done.
tvOS Release Timeline
Required Work
There are 3 outstanding items that we need to resolve before Swiftfin is ready for its next tvOS Release. Two of these items are tvOS specific and one is shared between tvOS and iOS:
1. Media Item Overhaul
2. Media Player UI
3. tvOS Storage Rework
Ongoing Work
While our required items are being worked on, there is also some refactoring to help us better unify iOS and tvOS for ease of development. We currently have shared
ViewModels, that call the APIs and perform data actions. This let's us reuse all "Business logic" between iOS and tvOS without issue. Moving forwards, we'd like to have shared views that can be used between each platform. Previously, this wasn't possible to do cleanly but, as SwiftUI has developed, this is a much more manageable task. The goal of this refactor is to allow us to build the UI for tvOS and iOS from a single location. If something on tvOS/iOS requires special considerations, we can add logic there as well. But, for the majority of our views, tvOS and iOS have enough overlap this saves us from having to do this in 2 locations. This work was originally started here:Statefulmacro #1714 (comment)But, for some examples of what this looks like:
ErrorViewCleanup #1798SplitFormWindowView&LearnMoreTypes #1838This is not a requirement for our tvOS release but completing this should expedite future development and help us keep parity between platforms. Unofficially, this will also naturally result in a macOS client as our unified logic should work more cleanly there as well.
Completed
Please find our new milestone for tracking tvOS items below:
https://github.com/jellyfin/Swiftfin/milestone/3
There are some items and features that are missing from this list, but this milestone helps make updating & tracking changes to tvOS easier. As items are completed, they will automatically be updated there.
Disclaimer
Please note that we have no firm release date and won’t commit to one. Swiftfin development is volunteer-driven by individuals who have other commitments. Updates will be posted here as available. We ask that you please be respectful of those dedicating their free time to make Swiftfin a reality.
At this time, there is no tvOS TestFlight or beta available for testing.
If you have any questions, feel free to ask in the comments, and I'll answer as best I can!
We will update this post with any updates as they occur along with a timestamp of the last update.
Post Updates
All Edits
2024-11-04: Added all tvOS PR's currently merged into Main
2024-11-12: Added episode card changes
2024-12-08: Reorder for readability and adding new tvOS items
2024-12-11: Clarity on the PRs included and the issues potentially resolved
2024-12-12: Move
Sign-In Flowfrom 'Not Started' to 'In-Progress'2024-12-18: Move
Home Screentasks from 'Nice to Have' to 'Not Started'. Break out tasks to be more descriptive for new potential contributors.2024-12-19:
Sign-In Flow - General Polishcompleted.2024-12-31:
Sign-In Flow - Delete Userscompleted.2025-01-02: Added a note clarifying that there is currently no TestFlight available for tvOS. Also included more details in the post to address common questions, such as progress updates. Started:
Home View - State / Error / Empty Handling&Sign-In Flow - User Local Authentication.2025-01-05: Included:
Home View - Manual Refresh Buttonto PR #1382. Subject to change.2025-01-09: Completed:
Sign-In Flow - User Local Authentication. Included:Home View - Reactive Changesto PR #1382. Subject to change/feedback on PR.2025-01-10: Completed:
Home View - Reactive Changes. This was already completed by earlier changes from an earlier PR to theHomeView.2025-01-11: Moved back to 'Not Started':
Home View - Manual Refresh Button&Home View - State / Error / Empty Handling. More discussion is needed for tvOS design and this PR was not the correct route. Pulling in favor of a more built-out solution later.2025-01-23: Created & Set as In-Progress:
Library View - Reload Settingsas a continuation of PR #1213. This is needed as a precursor to Filters / Letter Picker conversations. Those items are not a requirement for this release and will require a discussion on UX/UI prior to their development. Finally, added PR #1403 to the general polish for the login flow.2025-01-24: Created & Set as In-Progress:
Enable ItemType Filtering. Completed:Library View - Reload Settings. Both are preparation for tvOS library filtering.2025-01-26: Completed:
Enable ItemType Filtering.2025-01-29: Set as In-Progress:
Home View - Error Handling. Cleaned up some of the completed PRs and tied back some related PRs to completed tasks. Broke out Home View tasks intoError Handlingvs the broader restructure mentioned here: [tvOS] HomeView - Error Handling & Refreshing #1382 (comment)2025-02-03: Set as In-Progress:
Sign-In Flow - Sign-In Options. Also, removedItemType Filterssince it should all now be covered fromLibraryViewModelso only one configuration is required.2025-02-06: Completed:
Sign-In Flow - User Auto Sign-Out&Sign-In Flow - Sign-In Options. Created a new task forSign-In Flow - User Auto Time-Outwhich will handle the "Log out after X period of inactivity" asUser Auto Sign-Outhandles logout on close.2025-02-15: Completed:
Home View - Error Handling. AddedMultiple Version Support. Set as In-Progress:Multiple Version Support,Episode Selector, andSign-In Flow - Handle Duplicate Users. Re-ordered the "Nice to Have / Low Priority" section to better reflect the items that are less likely for the final build. Updated the PRs that will be included in this next release with all new PRs since I last updated it.Episode Selector's work is the first PR of likely a few.2025-02-20: Completed:
Multiple Version Support.2025-02-23: Expanded
Episode Selector - State / Error / Empty & Focus Handlingto include Focus Handling.2025-02-25: Included the new fix for [iOS] Grid in UserSelectView gets cut off with more than one user #1425.
2025-03-02: Set as In-Progress:
Library Filters & Letter Picker. This is subject to change based on feedback. If this filter layout is not desirable I will reset this back to Lower Priority.2025-03-03: Completed:
Episode Selector - State / Error / Empty & Focus Handling.2025-03-04: Set as In-Progress:
Sign-In Flow - User Auto Time-Out. Re-opened:Episode Selector - State / Error / Empty & Focus Handling2025-03-12: Completed:
Episode Selector - State / Error / Empty & Focus Handling. Now with some scrolling/focus fixes. Appropriately linkedSign-In Flow - User Auto Time-Outto the review ready PR. RemovedItem View - State / Error / Empty Handlingas an item this appears to already beStateful. Additionally, theHome View - Error Handlingcovered theItemViewError state as well. SeparatedLibrary Filters & Letter Pickerout from the rest of "In-Progress" as it likely will not be polished in time for the tvOS release.2025-03-14: Completed:
User Auto Time-Out. With this, our sign-in logic should be roughly at feature parity with iOS 🎉.2025-03-21: Completed:
Menu Button Cleanup&Video Ranges. AddedTrailers & ActionButton Cleanup&Accent Color & tvOS ColorPickerViewto in-progress. None of these are mission critical but they are some good QOL cleanup while theVideoPlayerManagerrefactor is ongoing.2025-04-01: Set as In-Progress:
Select User View - Move the AddUserButton to the Bottom Bar2025-04-05: Completed:
Item View - Trailer Support & ActionButton Cleanup.2025-04-06: Added:
App Crash on First Login. Set as In-Progress:App Crash on First Login. Completed:App Crash on First Login,Select User View - Move the AddUserButton to the Bottom Bar, &Developer - Update SDK to 10.10. RenamedAddUserButtonto mirror other Sign-In Flow items. Updated other PRs included and moved some other issues around in terms of priority.2025-04-15: Cleanup PRs and active items.
2025-04-16: Moved all QOL items to a more generic Help Wanted Post
2025-05-19: LePips has resolved the
PagingLibraryViewfocus issue in their CollectionVGrid repository. This should be bumped in our next tvOS PR that makes it's way. I am going to create a single PR just to bump this version. This should be our last major item required outside of the Video Player Manager which can be followed from Video Player Manager Refactor #1203. Cleaned up open items to better reflect our current outstanding needs for our next release.2025-06-12: Added an update to get in front of some of the 1.3 tvOS questions.
2025-06-15: Added an PR for the Video Player.
2025-07-20: Removed the long list of PRs for the next release as this was taking some effort to maintain and didn't really add much to the conversation. Instead, I will focus on keeping the Completed task list up-to-date with the more key/high profile items. Removed no longer in-progress items from the list and added the resolution for Logged Out Between Sessions [TVOS] #776 to the completed items.
2025-09-19: Cleanup notes post Media Player #1581. New tvOS 26 issues are present that need to be squashed.
2025-10-06: Linking [tvOS] tvOS 26 Fixes for Navigation & Updated Linting #1715 and updating to better reflect the source of the issue as an Apple Bug. This workaround should be minimally invasion and we should be able to reverse this easily when Apple patches this. Mark
Video Player Cleanupas resolved.2025-10-22: Added and Sorted outstanding tasks. Cleanup to refill Help Wanted! #1503.
2025-10-24: Marks
.sheetfix and SDK changes as complete. Clean up and move to a Milestone instead of manually updating this list.2025-11-17: Cleanup issues. Trailers now resolved for tvOS. Majority of tracking should now be on the Milestone.
2026-01-02: Cleanup Edits to be collapsible. Create a more narrative 1, 2, 3... gameplan for our next release.
2026-01-05: Bolding and formatting changes to make this more readable.
2026-01-12: 2026 NOT 2025...
Beta Was this translation helpful? Give feedback.
All reactions