justinzeus/Wholphin
1
0
Fork 0
mirror of https://github.com/JustinZeus/Wholphin.git synced 2026-07-08 15:50:16 +02:00
Code Issues Projects Packages Wiki Activity Actions
An OSS Android TV client for Jellyfin
79 commits 23 branches 66 tags 12 MiB
Find a file
Damontecres 005d6b11ce
Yet another rewrite of the playback overlay
2025-10-07 17:51:09 -04:00
app Yet another rewrite of the playback overlay 2025-10-07 17:51:09 -04:00
gradle Updates to series detail page 2025-10-07 14:46:37 -04:00
.editorconfig Basics for user prefs, logging in, etc 2025-09-21 19:56:40 -04:00
.gitignore Initial app creation 2025-09-20 16:36:38 -04:00
.pre-commit-config.yaml Add pre-commit 2025-09-23 18:02:25 -04:00
build.gradle.kts Add pre-commit 2025-09-23 18:02:25 -04:00
gradle.properties Initial app creation 2025-09-20 16:36:38 -04:00
gradlew Initial app creation 2025-09-20 16:36:38 -04:00
gradlew.bat Initial app creation 2025-09-20 16:36:38 -04:00
LICENSE Initial commit 2025-09-20 16:31:30 -04:00
README.md Add UpdateChecker 2025-10-07 15:28:07 -04:00
settings.gradle.kts Dependency bumps 2025-10-02 12:15:45 -04:00

README.md

Dolphin - an OSS Android TV client for Jellyfin

This is an Android TV client for Jellyfin. It aims to provide a more "Plex app"-like app experience for users migrating from Plex to Jellyfin.

This is not a fork of the official client. The user interface and controls have been written completely from scratch.

Motivation

After using Plex and its Android TV app for 10+ years, I found the official Jellyfin client UI/UX to be a barrier for me using Jellyfin more, so if you wish the interface and playback controls were more like Plex's Android TV app, then Dolphin might work for you!

That said, Dolphin does not yet implement every feature in Jellyfin. It is a work in progress that will continue to improve over time.

Distinguishing Features

  • A navigation drawer for quick access to libraries, search, and settings from almost anywhere in the app
  • Show Movie/TV Show titles when browsing libraries
  • Play TV Show theme music, if available
  • "Plex app"-like playback controls, plus other enhancements, such as:
    • Using D-Pad left/right for seeking during playback
    • Subtly show playback position while seeking w/ D-Pad
    • Quickly access video chapters during playback
    • Setting to optionally skip back when resuming playback

Installation

  1. Enable side-loading "unknown" apps
  2. 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 TODO ENTER A VALUE HERE or URL: https://aftv.news/TODOTODO
    • Download the latest APK release from the releases page or https://aftv.news/745800
      • 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 which can then 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.

Compatibility

Dolphin requires Android 7.1+ (or Fire TV OS 6+) and Jellyfin server 10.10.x (tested on primarily 10.10.7).

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

Contributions

Issues and pull requests are always welcome! UI/UX improvements are especially desired!

Please check before submitting that your issue or pull request is not a duplicate.

If you plan to submit a pull request, please read the contributing guide before submitting!

Additional screenshots

TODO