mirror of
https://github.com/bbara04/Purefin.git
synced 2026-03-31 17:10:08 +02:00
118 lines
3.1 KiB
Markdown
118 lines
3.1 KiB
Markdown
|
|
# 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:
|
|
```bash
|
|
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](LICENSE) file for details.
|
|
|
|
## Acknowledgments
|
|
|
|
- [Jellyfin](https://jellyfin.org/) - The free software media system
|
|
- All contributors who help make Purefin better
|
|
|
|
## Support
|
|
|
|
If you encounter any issues or have questions:
|
|
- Open an [issue](https://github.com/yourusername/purefin/issues)
|
|
- Check existing issues for solutions
|
|
|
|
## Disclaimer
|
|
|
|
This is an unofficial Jellyfin client and is not affiliated with or endorsed by the Jellyfin project.
|