Purefin

An open-source Jellyfin client for Android and Android TV, built with modern Android development practices.

Features

• Video Playback & Queue Management - Smooth playback experience with queue management powered by Media3/ExoPlayer
• Continue Watching - Resume your content right where you left off
• User Authentication - Secure login and user account management
• Rich Media Presentation - Beautiful artwork and thumbnails for your media library
• Smart Downloads - Download your favorite content for offline viewing
• Centralized Subtitles Management - Advanced subtitle handling with Jellyfin plugin integration

Screenshots

Coming soon

Tech Stack

• Language: Kotlin
• UI Framework: Jetpack Compose
• Media Playback: Media3 (ExoPlayer)
• Networking: Jellyfin Core SDK, OkHttp
• Dependency Injection: Hilt
• Local Storage: Room Database, DataStore
• Image Loading: Coil
• Navigation: AndroidX Navigation 3
• Serialization: Kotlin Serialization

Requirements

• Android 10 (API 29) or higher
• Android Studio Ladybug or newer
• JDK 11 or higher
• A Jellyfin server instance

Installation

Building from Source

1. Clone the repository:

git clone https://github.com/yourusername/purefin.git
cd purefin

2. Open the project in Android Studio

3. Sync the project with Gradle files

4. Build and run the app:

   • For Android devices: Select your device/emulator and click Run
   • For Android TV: Select an Android TV emulator or device

Download APK

Release builds coming soon

Usage

1. Launch Purefin on your Android device or Android TV
2. Enter your Jellyfin server URL
3. Log in with your Jellyfin credentials
4. Browse and enjoy your media library

Configuration

Connect to your Jellyfin server by providing:

• Server URL (e.g., http://192.168.1.100:8096 or https://jellyfin.example.com)
• Username
• Password

Contributing

We welcome contributions! Here's how you can help:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

Contribution Guidelines

• Follow Kotlin coding conventions
• Use Jetpack Compose for UI components
• Write meaningful commit messages
• Update documentation as needed

Roadmap

• Enhanced subtitle customization
• Chromecast support
• Picture-in-Picture mode
• Live TV support
• Offline library sync
• Multi-user profiles

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

• Jellyfin - The free software media system
• All contributors who help make Purefin better

Support

If you encounter any issues or have questions:

• Open an issue
• Check existing issues for solutions

Disclaimer

This is an unofficial Jellyfin client and is not affiliated with or endorsed by the Jellyfin project.