jellyfin / jellyfin-android

Android Client for Jellyfin
https://jellyfin.org
GNU General Public License v2.0
1.57k stars 251 forks source link
android java jellyfin kotlin

Jellyfin Android

Part of the Jellyfin Project


Logo Banner

GPL 2.0 License Current Release Translation Status
Donate Feature Requests Chat on Matrix Join our Subreddit
Jellyfin on Google Play Jellyfin on Amazon Appstore Jellyfin on F-Droid
Download archive

Jellyfin Mobile is an Android app that connects to Jellyfin instances and integrates with the official web client. We welcome all contributions and pull requests! If you have a larger feature in mind please open an issue so we can discuss the implementation before you start. Even though the client is only a web wrapper there are still lots of improvements and bug fixes that can be accomplished with Android and Kotlin knowledge.

Most of the translations can be found in the web client since it's the base for the Android client as well. Translations for the app can also be improved very easily from our Weblate instance. Look through the following graphic to see if your native language could use some work!

Detailed Translation Status

This client was rewritten from scratch with a fresh git history in July to August 2020, and replaces the old Cordova-based client, which can still be found in the archives.

Build Process

Dependencies

Build

  1. Clone or download this repository

    git clone https://github.com/jellyfin/jellyfin-android.git
    cd jellyfin-android
  2. Open the project in Android Studio and run it from there or build an APK directly through Gradle:

    ./gradlew assembleDebug

Deploy to device/emulator

   ./gradlew installDebug

You can also replace the "Debug" with "Release" to get an optimized release binary.

Release Flavors

There are two flavors (variants) of the Jellyfin Android app:

The proprietary version is available on Google Play and the Amazon Appstore, while the libre version is available on F-Droid. Additionally, beta releases exist for both flavors, but only the proprietary version is published to a beta track on Google Play. If you'd like to test the beta outside of Google Play, you can simply download it from the GitHub releases.