Development Blog | December 2025 #1832
Closed
JPKribs
announced in
Announcements
Replies: 2 comments
-
|
Thank you it helps to know that the tvOs version is still getting completed and is closer than before. I really wish it were a little better but the only issue I have had so far is that one of my newer Apple TV 4k models is having trouble signing in. It may be my issue and to be honest I haven't put much effort into it. Thanks for the great update! |
Beta Was this translation helpful? Give feedback.
0 replies
-
|
Future versions of this will be included in the full Jellyfin team update. The first post for this can be found here: |
Beta Was this translation helpful? Give feedback.
0 replies
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Uh oh!
There was an error while loading. Please reload this page.
-
Development Blog
December, 2025
First Time Contributors
Welcome to these contributors who had their first PR(s) merged last month!
Work Summary
Completed and outstanding work from the last month.
%%{init: {'theme': 'base', 'themeVariables': { 'pie1': '#8b949e', 'pie2': '#f85149' }}}%% pie showData title Merged Changes "Other" : 7 "Bug Fixes" : 4%%{init: {'theme': 'base', 'themeVariables': { 'pie1': '#f85149', 'pie2': '#00a4dc', 'pie3': '#f0e68c' }}}%% pie showData title Outstanding Items "Bugs" : 98 "Features" : 89 "Tasks" : 14New Items
New issues and pull requests opened last month that are still outstanding.
Issues
iOStvOSFeaturegood first issuetvOSTaskListRowMenuStylingdevelopergood first issueiOStvOSTaskListRowButtonUsagesdevelopergood first issueiOStvOSFeatureiOStvOSTaskUIScreen.main.scaleUsagesdeveloperiOStvOSTaskUIScreen.main.boundsUsagesdeveloperPull Requests
iOStvOSenhancementiOStvOSenhancementiOStvOSFilterViewdevelopertvOSbugtvOSbugiOS@Stateful- Server TasksdeveloperiOStvOSNetworkErrordeveloperResolved Items
Issues closed and pull requests merged last month.
Issues
iOSBugdeveloperiOStvOSTaskseconds.formatted(.hourMinute)Usagesdevelopergood first issueiOStvOSFeature.textUsagesdevelopergood first issueiOStvOSBugplaybackiOSBugcrashexternalPull Requests
tvOSbugplaybacktvOSbugiOStvOSdeveloperiOStvOSdeveloperSwiftfindocumentationiOStvOSErrorViewCleanupdevelopertvOSdeveloperiOStvOSbugiOStvOS@Stateful-ServerActivityDetailViewModeldeveloperiOStvOSdevelopertvOSbugDevelopment Notes
Hey All,
I wanted to try something different for keeping the community in the loop. Our contributors do a great job of making detailed issues and PRs to explain the current state of Swiftfin but unfortunately we are still a bit of a black box for people who don’t track individual issues. My goal for these "Development Blogs" is to be a snapshot of Swiftfin at the start of a new month and give us a place to share thoughts or highlight things that we are excited about. If there are any topics that are top of mind, this gives us a spot to mention them if they don't fit into our existing Discussion structure. I hope the result of these is a more transparent place for folks to stay up to date with changes and feel as though they have a window into what is going on without needing to watching new PRs like a hawk.
For this first post, I wanted to focus on the meta/project changes we have been up to, since a lot of this work exists out of sight.
Project Board
I've mentioned this in a few places, but I have been working on a project board for a while. A place to track active issues and items that need an owner. Also, a way to for users to track what is going into a release or find issues that would be good as a new contributor.
Cleanup
Before I could do any of that, I had some pre-work I needed to get resolved. If anyone follows our open issues, you may have noticed some changes to our backlog over the last couple of months. For open items, I have made sure to include impacted OSes for
iOS,tvOS, and a currently mostly unusedmacOS. This should help people determine whether an issue or PR impacts their system of choice. Many of our issues impact both platforms and are reflected by having both labels.I have also categorized our issues to mirror the
Typesfound in the main Jellyfin Server repo. All issues will now fall underTasks,Bugs, orFeaturesbased on the type of work that is required. Types will track our issue category, allowing labels to focus on adding commentary or metadata.Finally, I have added a new label to track good issues for new contributors. These are issues which I believe contributors should be able to complete without a lot of Swiftfin or Jellyfin specific context. These are also lower priority items that need to be done but aren’t urgently pressing.
Consolidation
While I was cleaning these up, I combined some issues together under parent issues for ease of tracking. These group issues exist for two reasons. Either to consolidate issues that all have the same root cause, or to capture issues that have multiple steps that need to be completed in a specific order. For now, there are three main places where I have done this:
tvOS Device Profile Issues should all be resolved in our next tvOS Release as a result of #519 but are live in our current 1.0.1 version on the App Store. This parent gives us a single place to track these issues and link to our resolving PRs. This issue and its children will be closed as part of our next tvOS release but are left open for now to allow people to track their issue and prevent duplicate new issues from being created.
tvOS Media Player contains issues related to our tvOS Player UI. These issues are all grouped together because we are striving to resolve all of these as part of the tvOS Player UI PR. This helps us track this and serves to prevent contributors from spending time resolving symptoms when these issues should be handled as part of a single action. The goal would be to wrap all of these up as part of the rewrite but there is a chance that some of these items will get pushed to later PRs in an effort to get the tvOS release out sooner. As this changes, I will remove/add issues under the parent to track this.
Downloads contains new sub-issues or steps to complete this project. There have been a few people that have attempted to build out the downloads feature into Swiftfin iOS but this project has a lot of moving parts and touches a lot of places. As a result, these PRs often get too large to adequately review or too complex to keep aligned with other work. Instead, I’ve split this out in smaller steps that should be able to be done in tandem with other development. This should also better define our scope and make this easier to review. For now, I am happy with these sub-issues but these may be updated as time progresses or if we have any changes in direction or scope.
The Grand Finale
This brings us to our completed dashboard which is now publicly available at our link below:
Swiftfin - Roadmap
I will be the first to say, this isn’t the prettiest or coolest dashboard that I’ve ever seen but, for now, this gets us to a functional state with the items that we need. As I have more time, I might work on adding some pizzazz but for now the primary focus was to try and make this maintainable. All steps in our workflow should be automated. Project management can often creep over time, resulting in more time managing work than doing work. My goal for this dashboard was to be functional but simple enough that we don’t have to manage complex states & steps.
I am open to feedback if anyone has any! For now, this link will live on the contribution discussion that I created earlier this year. If anyone is interested in contributing and needs help getting started, that is the best place to go!
Milestones
To help group information, I have added a few milestones to Swiftfin. Right now, I am doing this backwards, where completed issues are added to milestones as they are completed. This is primarily for tracking so folks can find issues and trace which version that issue should be resolved in. At this time, we have the following milestones available:
Version 1.4 contains issues that should be resolved in version 1.4 of Swiftfin iOS. This list is currently incomplete because I started this milestone midway through our 1.4 development cycle. Moving forward, these milestones should be more complete. Issues in this milestone are available for testing now as part of our TestFlight.
Version 1.5 contains issues that should be resolved in version 1.5 of Swiftfin iOS. This is currently unused but will start to fill up as we start our 1.5 development cycle.
tvOS Resync contains tvOS specific issues that will be resolved as part of our next tvOS Release. As a note, many items in there are resolved as part of our Player UI and Device Profile changes so this list should be used as more of documentation than a place to find ways to contribute. Issues that impact tvOS but are part of 1.4 or 1.5 will end up in the version milestone instead of this one. Once tvOS is released, tvOS should mirror our existing 1.X structure and iOS.
Looking Forward
I’m creating this post in an unofficial capacity. To be frank, this was a fair bit of work to put together so I don't want to give the idea that this is the official expectation of Swiftfin as a project. If something changes in my life, I don't want there to be an expectation that someone else has to carry this forward. I’ve been thinking about using discussions like this for a while so I thought I would try this as a pilot post and see if what our feedback looked like. If people seem interested in this as an idea moving forward, I would be happy to keep doing this. But, if this ends up as clutter in our discussions or the idea falls flat, I’m fine moving off this quickly haha.
For this month, this is post is purely meta/project items but, moving forward, I would love to use this to highlight some of our upcoming changes. January, I don't have anything specific planned because this will depend on where we on in the release cycle. If there are any topics that people are interested in I am happy to make that a priority. I am also open to any feedback on format or metrics. I scripted out the API calls for the whole top portion of this post, so this should be easy to generate consistently or change if people find this information is helpful.
If anyone is interested in our next iOS release, I highly recommend our TestFlight for 1.4. Some of our major changes are:
Any help testing and/or finding issues prior to a final release is always greatly appreciated!
Feedback
We'd love to hear from you! If you have any questions, suggestions, or feedback about Swiftfin's development, please let us know in the discussion below.
Beta Was this translation helpful? Give feedback.
All reactions