A Swift library for building Apple-platform apps with consistent state management, composable features, side-effect control, and strong testing support.
15K1.7KSwiftMITUpdated 14 days ago
jellyfin/Swiftfin
A native iOS and tvOS video client for the Jellyfin media server, built in Swift and SwiftUI.
Open-source alternative to:Plex
- Stars
- 4,220
- Forks
- 625
- Open issues
- 100
- Last commit
- yesterday
What is it?
Swiftfin is a video client for the Jellyfin media server that runs on iPhone, iPad, and Apple TV. It is written in Swift so it can look and behave like a native Apple app while connecting to a self-hosted Jellyfin library.
The app offers two playback options: a native player and a VLC-based player. Its documentation covers which media types and libraries are supported and how each player's features differ. Minimum supported iOS and tvOS versions are documented separately.
Swiftfin is distributed through the Apple App Store and TestFlight for beta builds. Development contributions follow the project's published contribution guidelines.
Key features
- 01Native SwiftUI interface for iOS and tvOS
- 02Playback through a native player or a VLC-based player
- 03Connects to Jellyfin media servers
- 04Documented library and media type compatibility
- 05Available on the App Store and TestFlight
Use cases
- Watching a self-hosted Jellyfin library on an iPhone or iPad
- Playing Jellyfin movies and shows on an Apple TV
- Testing beta builds of a Jellyfin client before App Store release
Quick start
- 1
Download the app from the App Store
- 2
Or join the TestFlight beta
- 3
Read the contribution guidelines to build from source
Things to know
- Apple platforms only: iOS and tvOS, not Android or desktop.
- Requires a running Jellyfin media server; the app is a client only.
- Minimum OS versions are high (iOS 18+, tvOS 26+).
Topics
FAQ
- What is Swiftfin?
- A native iOS and tvOS video client for the Jellyfin media server, built in Swift and SwiftUI. Swiftfin is a video client for the Jellyfin media server that runs on iPhone, iPad, and Apple TV. It is written in Swift so it can look and behave like a native Apple app while connecting to a self-hosted Jellyfin library.
- Is Swiftfin free to use? What license does it have?
- Swiftfin is open source under the MPL-2.0 license. Check the license terms before using it in commercial products.
- Is Swiftfin still maintained?
- Actively maintained. The last commit to Swiftfin was on Oct 19, 2026.
- What can I use Swiftfin for?
- Watching a self-hosted Jellyfin library on an iPhone or iPad Playing Jellyfin movies and shows on an Apple TV Testing beta builds of a Jellyfin client before App Store release
- How do I install Swiftfin?
- Download the app from the App Store Or join the TestFlight beta Read the contribution guidelines to build from source
- Where can I get Swiftfin?
- The source code and installation instructions are on GitHub: https://github.com/jellyfin/Swiftfin
Summary generated by AI from the project's README. GitHub stats refresh daily.
Related projects
An iOS app launcher that runs IPA apps inside itself without installing them, with multiple containers per app.
13.1K1.2KSwiftAGPL-3.0Updated 3 days ago
An agent skill that teaches AI coding assistants like Claude Code and Codex to write modern, correct SwiftUI code.
6.2K236MITUpdated 4 days ago
A macOS and iOS document chat app that lets you upload files and ask questions, with all AI processing done on-device via Apple Foundation Models.
1978SwiftMITUpdated 7 months ago
Official source code for the Telegram messenger iOS app, with a build system for compiling it yourself in Xcode.
9.3K3.1KSwiftNo licenseUpdated 12 days ago
A macOS menu bar app that explains in plain English what each USB-C cable on your Mac can do and why charging may be slow.
8.9K270SwiftOtherUpdated 7 days ago