+4
Daily
3,343
stars
246
forks
7
watchers
863
prs
944
issues
71
releases
README
Wholphin - an OSS Android TV client for Jellyfin
"Never half-phin two jellies. Always wholphin one jelly."
Wholphin is an open-source Android TV client for Jellyfin. It aims to provide a different app UI that's inspired by Plex for users interested in migrating to Jellyfin.
This is not a fork of the official client. Wholphin's user interface and controls have been written completely from scratch. Wholphin supports playing media using either ExoPlayer or MPV.
!v0_5_1_home
Features
User interface
- Customize the home page to see the content you are interested in
- Use poster or thumb images, show/hide titles, add/remove/re-order different types of rows!
- Option to combine the Continue Watching & Next Up into a single row
- Pin collections, playlists, favorites, genres, and studios
- Remove series from next up
- A navigation drawer for quick access to libraries, favorites, search, and settings from almost anywhere in the app
- Integration with Seerr to discover new movies and TV shows
- Note: only available when installed from GitHub or the Play store
- Customize library display
- Option to show Movie/TV Show titles
- Choose image types & size
- Choose from grid or list layouts
- Play theme music, if available
- Customize subtitle style for plain text subtitles with separate HDR settings
- Search & download subtitles (requires compatible server plugin such as OpenSubtitles)
- Multiple app color themes
- Protect user profile switches with PIN code or require server login
- Change the user interface language per user
- In-app & Android OS screensaver support
Playback
- Different media playback engines:
- ExoPlayer w/ optional extra audio, SSA/ASS, & AV1 software decoding
- MPV for direct playing anything with great SSA/ASS subtitle support
- Plex inspired playback controls:
- Using D-Pad left/right for seeking during playback
- Quickly access video chapters & queue during playback
- Optionally skip back a few seconds when resuming playback
- Live TV & DVR support
- Music & music video support
- Cinema mode/pre-roll intro support (requires compatible server plugin such as Intros)
- Auto play next episodes with pass out protection
- Option for automatic refresh rate & resolution switching on supported displays
- Trickplay (video preview) support
- Subtly show playback position along the bottom of the screen while seeking w/ D-Pad
Roadmap
See here for the roadmap
Installation
Using Google Play or Amazon appstore are the fastest way to install. But you can follow these instructions to install without needing an app store
Downloader Code: 8668671
1. Enable side-loading "unknown" apps
- https://androidtvnews.com/unknown-sources-chromecast-google-tv/
- https://www.xda-developers.com/how-to-sideload-apps-android-tv/
- https://developer.android.com/distribute/marketing-tools/alternative-distributionunknown-sources
- https://www.aftvnews.com/how-to-enable-apps-from-unknoTop issues
#747[BUG] - <unable to login into seer>32 comments · 2026-01-22#512[BUG] - Skipping via timeline intermittently gets stuck after skip26 comments · 2025-12-19#1057DTS HD MA Passthrough not working on Fire TV Cube Gen 323 comments · 2026-03-07#867[BUG] - Exoplayer Playback Issues on Some 4K HDR Files22 comments · 2026-02-10#460[FEA] - Enhance Next Up Popup with configurable countdown, better description, side-by-side orientation, close button, etc.22 comments · 2025-12-14#528[FEA] - Video Player UI Modernization (Long-term goal)18 comments · 2025-12-21#335[BUG] - only stereo output, even though audio is 5.118 comments · 2025-11-28#1930PGS subtitles aren't showing up13 comments · 2026-09-03
Discussions
#2244[Enhancement?] Consolidate the ": More" menu entries0 comments · 2026-11-15#2239Add "mark as watched" button/option to the long-press sub-menu when there is activity on an episode0 comments · 2026-11-13#2238Past searches and auto suggestions missing?0 comments · 2026-11-13#2242Feature request: Add a "Libraries" row (library buttons) to the customizable home page2 comments · 2026-11-13#2236Reduce font size1 comments · 2026-11-13#2232Login disclaimer support0 comments · 2026-11-12#2230[Feature Idea] Automatic Playback Calibration0 comments · 2026-11-12#2228[Subtitles Selection Remember Per Audio Track: Working on a tested build]0 comments · 2026-11-12
Latest release
v1.1.1 v1.1.1 2026-11-06What's Changed [!WARNING] This is the final release that will support Jellyfin 10.10 and 10.11! v1.2.0, planned for release in December, will require Jellyfin 12+ This release has a lot! - Improvements & overrides for HDR & Dolby Vision playback - Support for the optional companion plugin - More consistent audio/subtitle track selection between episodes v1.1.1 is a quick release to fix a single bug, the majority of changes are from v1.1.0. New Features & Enhancements New user preference to force enable or disable common HDR and Dolby Vision formats by @whitingj in