mirror of https://github.com/JustinZeus/Wholphin.git synced 2026-07-08 15:50:16 +02:00

An OSS Android TV client for Jellyfin

Find a file

Justin Visser 8ff97daf44 Display size page polish: tick-slider control, typography lock, richer preview Settings panel layout flipped: preview now occupies the left two-thirds of the page (nav rail at the natural app-left position), settings panel sits on the right at 300dp wide. Mirrors the real home-screen layout so the preview reads as a true reflection of what the user will see. Replaces the popup ChoicePreference selector with an inline tick-slider per control. Each slider is a chunky 24dp rounded track using surfaceVariant for the inactive background and primary for the thumb; the thumb is a rounded pill that snaps to one of four slot centers and fills 88% of the track height. D-pad LEFT/RIGHT cycles slots within the focused control; UP/DOWN moves between controls. Selection commits on focus change so the preview updates without an extra Enter press. Wraps the settings panel in a nested MaterialTheme using the unscaled AppTypography (both tv.material3 and compose.material3 flavors) so the panel's own labels stay at base size regardless of the Text size level the user picks. Without this nesting the panel chrome reflowed under the user's fingers as they cycled levels. Preview now uses SlimItemFields when fetching, so the Overview text populates on the hero. Episodes row is rendered first (matching the real home-screen ordering) so the hero defaults to an episode item, which exercises the full hero surface (title + episode name + overview + quick details). TimeDisplay is drawn over the preview area when the user's showClock preference is enabled. Text-size jumps are tuned wider: ExtraSmall 84% (was 88), Small 92% (was 94), Large 116% (was 108). Default stays at 100%. The hand-mapped sp lookup is regenerated for these percentages. scaledSp falls back to integer-rounded formula math instead of throwing on unmapped base sp values, so the helper is safe to call from any fontSize site without first extending the table.		2026-05-28 13:41:54 +02:00
.github	Workaround for resource shrinking w/ split ABIs	2026-05-27 13:56:18 -04:00
app	Display size page polish: tick-slider control, typography lock, richer preview	2026-05-28 13:41:54 +02:00
gradle	Update dependency com.mikepenz.aboutlibraries.plugin.android to v14.2.1 (#1447 )	2026-05-25 08:28:25 -04:00
.editorconfig	Basics for user prefs, logging in, etc	2025-09-21 19:56:40 -04:00
.gitignore	Bump dependency versions, notably media3 (#496 )	2025-12-17 17:00:15 -05:00
.pre-commit-config.yaml	Prefetch trickplay images (#445 )	2025-12-12 22:04:52 -05:00
build.gradle.kts	Upgrade AGP to 9.x (#892 )	2026-02-13 14:49:19 -05:00
CONTRIBUTING.md	Adopt jellyfin's AI/LLM policy	2026-02-02 10:34:30 -05:00
DEVELOPMENT.md	CI & Docs updates (#1284 )	2026-04-20 17:41:31 -04:00
gradle.properties	Enable minify optimizations for release builds (#1437 )	2026-05-23 14:08:38 -04:00
gradlew	Update AGP, Gradle, & other third party dependencies (#1356 )	2026-05-06 18:08:29 -04:00
gradlew.bat	Update AGP, Gradle, & other third party dependencies (#1356 )	2026-05-06 18:08:29 -04:00
LICENSE	Initial commit	2025-09-20 16:31:30 -04:00
README.md	Update readme	2026-05-27 12:38:33 -04:00
renovate.json	Update rennovate settings (#1217 )	2026-04-09 14:42:30 -04:00
settings.gradle.kts	Move native builds to wholphin-extensions (#1172 )	2026-03-31 18:10:40 -04:00

README.md

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.

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

Enable side-loading "unknown" apps
Install the APK on your Android TV device with one of these options:
- Install a browser program such as Downloader, use it to get the latest apk with short code 8668671 or URL: http://aftv.news/8668671
- Download the latest APK release from the releases page or http://aftv.news/8668671
  - Put the APK on an SD Card/USB stick/network share and use a file manager app from the Google Play Store / Amazon AppStore (e.g. FX File Explorer). Android's preinstalled file manager probably will not work!
  - Use Send files to TV from the Google Play Store on your phone & TV
  - (Expert) Use ADB to install the APK from your computer (guide)

Upgrading the app

After the initial install above, the app will automatically check for updates. The updates can be installed in settings.

The first time you attempt an update, the OS should guide you through enabling the required additional permissions for the app to install updates.

Note: if installed via an app store, the app store will handle updates.

Compatibility

Requires Android 6+ (or Fire TV OS 6+) and Jellyfin server 10.10.x or 10.11.x (tested on primarily 10.11).

The app is tested on a variety of Android TV/Fire TV OS devices, but if you encounter issues, please file an issue!

Seerr integration is tested with v3.2.0. Older versions may not work.

Contributions

Issues and pull requests are always welcome! Please check before submitting that your issue or pull request is not a duplicate.

If you plan to contribute, please read the contributing guide!

You can help translate Wholphin!

Acknowledgements

Thanks to the Jellyfin team for creating and maintaining such a great open-source media server
Thanks to the official Jellyfin Android TV client developers, some code for creating the device direct play profile is adapted from there
Thanks to the Jellyfin Kotlin SDK developers for making it easier to interact with the Jellyfin server API
Thanks to numerous other libraries that make app development even possible