Skip to content

docs: rework README around the fork's value proposition #47

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
midasvo merged 1 commit into from
Jun 23, 2026
Merged

docs: rework README around the fork's value proposition #47

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
111 changes: 55 additions & 56 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,54 +2,28 @@

# Findroid CE (Community Edition)

A maintained fork of [Findroid](https://github.com/jarnedemeulemeester/findroid), the native Jellyfin Android client.
A community-driven fork of [Findroid](https://github.com/jarnedemeulemeester/findroid) — the native
Jellyfin client for Android — that ships the features you've been waiting for.

## Why this fork?
## Why Findroid CE?

The original Findroid is an excellent Jellyfin client, but many community PRs with useful features aren't being merged. Findroid CE merges select community contributions and keeps dependencies up to date.
Findroid is a great app, but it's maintained by one person in their spare time, so useful community
pull requests can sit unmerged for a long time and releases are infrequent.

## Installing
**Findroid CE picks up where that leaves off:**

### Via Obtainium (recommended)

Add this repo URL in [Obtainium](https://github.com/ImranR98/Obtainium): `https://github.com/midasvo/findroid-ce`

Obtainium will automatically check for new releases and notify you of updates.

### Manual

Download the latest APK from the [Releases](https://github.com/midasvo/findroid-ce/releases) page.

Findroid CE uses a different application ID (`nl.midasvo.findroid.ce`) so it can be installed alongside the original Findroid.

## Screenshots
- 🚀 **Merges good community PRs** that haven't made it into upstream yet.
- 🔧 **Adds CE-only enhancements** — a rewritten download engine, Dolby Vision playback, richer
subtitle support, and more (see below).
- 📦 **Stays current** — dependencies and the Jellyfin SDK are kept up to date via Renovate.
- 🤝 **Tracks upstream** — improvements from Findroid are merged in regularly, so you don't fall behind.
- 📲 **Installs side-by-side** — a separate app ID (`nl.midasvo.findroid.ce`) means you can run it
next to the original without conflicts.

| Home | Library | Movie | Season | Episode |
|------|---------|-------|--------|---------|
| ![Home](fastlane/metadata/android/en-US/images/phoneScreenshots/1_en-US.png) | ![Library](fastlane/metadata/android/en-US/images/phoneScreenshots/2_en-US.png) | ![Movie](fastlane/metadata/android/en-US/images/phoneScreenshots/3_en-US.png) | ![Season](fastlane/metadata/android/en-US/images/phoneScreenshots/4_en-US.png) | ![Episode](fastlane/metadata/android/en-US/images/phoneScreenshots/5_en-US.png) |
If you already use and like Findroid, CE is the same app with the rough edges sanded down and the
backlog of community work actually shipped.

## Features

- Completely native interface
- Supported media: movies, series, seasons, episodes (direct play, no transcoding)
- Offline playback / downloads (including SD card support)
- ExoPlayer
- Video: H.263, H.264, H.265, VP8, VP9, AV1
- Audio: Vorbis, Opus, FLAC, ALAC, PCM, MP3, AAC, AC-3, E-AC-3, DTS, DTS-HD, TrueHD
- Subtitles: SRT, VTT, SSA/ASS, PGSSUB
- mpv
- Containers: mkv, mov, mp4, avi
- Video: H.264, H.265, H.266, VP8, VP9, AV1
- Audio: Opus, FLAC, MP3, AAC, AC-3, E-AC-3, TrueHD, DTS, DTS-HD
- Subtitles: SRT, VTT, SSA/ASS, DVDSUB
- Picture-in-picture mode
- Media chapters (timeline markers, chapter navigation)
- Trickplay (requires Jellyfin 10.9+)
- Media segments with skip button and auto-skip (requires Jellyfin 10.10+)

## What's different from upstream?

Findroid CE adds a lot on top of upstream Findroid. Highlights, grouped by area:
## What you get over stock Findroid

### Downloads

Expand All @@ -59,7 +33,6 @@ Findroid CE adds a lot on top of upstream Findroid. Highlights, grouped by area:
- **Configurable max concurrent downloads** — limit how many episodes download at once (default: 2)
- **Season download status on the show screen** — see "3/10 downloaded" per season in the season selection dialog
- **Redesigned downloads screen** — active downloads with progress on top, completed items below, storage usage at the bottom
- **Download feedback** — toast messages summarizing bulk results (started, skipped, failed)

### Playback & player

Expand All @@ -77,25 +50,51 @@ Findroid CE adds a lot on top of upstream Findroid. Highlights, grouped by area:
- **Long-press to copy text** on the movie/show/episode/season/person detail screens
- **Auto offline mode** — automatically enabled when there is no connectivity

### Diagnostics & maintenance
### Diagnostics

- **Export device profile** from the About screen — useful for debugging playback/transcoding
- **Stability fixes** across startup/offline crashes, picture-in-picture, and player edge cases
- **Dependencies** kept current via Renovate
- **Export device profile** from the About screen — handy for debugging playback/transcoding

For a full release-by-release history, see [CHANGELOG.md](CHANGELOG.md).
See the [changelog](CHANGELOG.md) for the full release-by-release history.

## Upstream sync
## Install

This fork is synced with upstream manually (automatic syncing is disabled). See
[docs/upstream-sync.md](docs/upstream-sync.md) for the procedure.
### Via Obtainium (recommended)

## License
Add this repo URL in [Obtainium](https://github.com/ImranR98/Obtainium):

GPLv3 — same as upstream. See [LICENSE](LICENSE).
```
https://github.com/midasvo/findroid-ce
```

The logo is a combination of the Jellyfin logo and the Android robot. The Android robot is reproduced or modified from work created and shared by Google and used according to terms described in the Creative Commons 3.0 Attribution License.
Obtainium then checks for new releases automatically and notifies you of updates.

## Credits
### Manual

Grab the latest APK from the [Releases](https://github.com/midasvo/findroid-ce/releases) page.

> Findroid CE uses its own application ID (`nl.midasvo.findroid.ce`), so it installs alongside the
> original Findroid rather than replacing it.

## Screenshots

| Home | Library | Movie | Season | Episode |
|------|---------|-------|--------|---------|
| ![Home](fastlane/metadata/android/en-US/images/phoneScreenshots/1_en-US.png) | ![Library](fastlane/metadata/android/en-US/images/phoneScreenshots/2_en-US.png) | ![Movie](fastlane/metadata/android/en-US/images/phoneScreenshots/3_en-US.png) | ![Season](fastlane/metadata/android/en-US/images/phoneScreenshots/4_en-US.png) | ![Episode](fastlane/metadata/android/en-US/images/phoneScreenshots/5_en-US.png) |

## Built on Findroid

Findroid CE is a fork — all the core functionality (the native UI, ExoPlayer & mpv playback, offline
downloads, picture-in-picture, etc.) comes from upstream Findroid. We sync with it regularly; the
process is documented in [docs/upstream-sync.md](docs/upstream-sync.md).

**All credit** to [Jarne Demeulemeester](https://github.com/jarnedemeulemeester) and the
[Findroid contributors](https://github.com/jarnedemeulemeester/findroid/graphs/contributors) for
building the app this fork stands on.

## License

GPLv3 — same as upstream. See [LICENSE](LICENSE).

All credit to [Jarne Demeulemeester](https://github.com/jarnedemeulemeester) and the [Findroid contributors](https://github.com/jarnedemeulemeester/findroid/graphs/contributors).
The logo is a combination of the Jellyfin logo and the Android robot. The Android robot is reproduced
or modified from work created and shared by Google and used according to terms described in the
Creative Commons 3.0 Attribution License.