Jellyfin Mobile is an Android app built with Cordova.

1. Clone or download this repository.

   git clone https://github.com/jellyfin/jellyfin-android.git
   cd jellyfin-android
   git submodule update --init --recursive --remote

2. Install Cordova and other build dependencies via npm in the project directory.

   npm install

3. Prepare the Cordova platforms.

   npx cordova prepare

If any changes are made to src/, the www/ directory will need to be rebuilt using the following command.

npx gulp

If NODE_ENV=development is set in the environment, then the source files will be copied without being minified.

You can use the -d flag if you want to build a debug version. A release version will need to be signed before it will run.

npx cordova build android

npx cordova run android

Cordova needs that environment vairable set to the location of your Android SDK to build the app. If you are using linux it will be somewhere in your home directory.

Android Studio will write over gradlew occasionally but doesn't set it as executable. Go to platforms/android and set that file as executable to fix the build for Cordova.

Make sure the web source has been properly copied to www using gulp. If you are using Android Studio you have to build with cordova at least once so the files are copied into the android source files.