Jellyfin Android

Jan 31, 2024 | Programming

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

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 is 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 from July to August 2020, and replaces the old Cordova-based client, which can still be found in the archives.

Build Process

Dependencies

  • Android SDK

Building the App

  1. Clone or download this repository:
  2. git clone https://github.com/jellyfin/jellyfin-android.git
    cd jellyfin-android
  3. Open the project in Android Studio and run it from there or build an APK directly through Gradle:
  4. ./gradlew assembleDebug

Deploy to Device/Emulator

./gradlew installDebug

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

Release Flavors

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

  • The proprietary version comes with Google Chromecast support.
  • The libre version comes without Google Chromecast support.

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.

Troubleshooting

If you run into issues during the build or deployment process, here are some ideas to help you diagnose the problems:

  • Make sure you have the required Android SDK installed and properly configured.
  • Check your internet connection if you are facing issues with cloning the repository.
  • Verify that your system meets the necessary hardware requirements for running Android Studio.

For more insights, updates, or to collaborate on AI development projects, stay connected with fxis.ai.

At fxis.ai, we believe that such advancements are crucial for the future of AI, as they enable more comprehensive and effective solutions. Our team is continually exploring new methodologies to push the envelope in artificial intelligence, ensuring that our clients benefit from the latest technological innovations.

Understanding the Code: An Analogy

Think of the Jellyfin Android app like a restaurant. The clone/download step is akin to selecting the ingredients you need from a store to make your favorite dish. You can’t cook without having the right supplies! Once you have the ingredients, opening the project in Android Studio is like entering the kitchen where you will prepare your meal. Running it or building an APK is comparable to cooking; you’re putting everything together to create something delectable.

When you deploy to a device/emulator, it’s like serving the meal to your table. Each flavor of Jellyfin can be seen as the choice between a vegetarian plate and a meat dish; they may use similar ingredients but deliver a unique taste experience for the customers. And if you encounter any kitchen mishaps, you can troubleshoot by checking recipes (documentation) or refining your cooking methods (code fixes).

Stay Informed with the Newest F(x) Insights and Blogs

Tech News and Blog Highlights, Straight to Your Inbox