Skip to content

A modern, cross-platform Jellyfin client built with Kotlin Multiplatform and Compose Multiplatform.

License

Notifications You must be signed in to change notification settings

lxwiq/JellyFish

Repository files navigation

JellyFish Logo

JellyFish

A modern, cross-platform Jellyfin client built with Kotlin Multiplatform and Compose Multiplatform.

Kotlin Compose Multiplatform License

Android · iOS · Desktop

Features

Media Browsing

  • Browse your complete Jellyfin library (movies, TV shows, music)
  • Continue watching with resume support
  • Search with history
  • Filter and sort by genre, year, rating

Video Playback

  • Native playback with LibVLC (Android) and platform-specific players
  • Quality selection (1080p, 720p, 480p, direct play)
  • Audio and subtitle track switching
  • Playback speed control
  • Progress sync with Jellyfin server

Offline Support

  • Download movies and episodes for offline viewing
  • Quality selection for downloads
  • Storage management with configurable limits
  • Resume offline playback

Customization

  • Dark theme with Material 3 design
  • Multi-language support (English, French)
  • Streaming and download quality preferences

Administration

  • User management (create, delete users)
  • Library refresh
  • Server logs access

Coming Soon

  • Jellyseerr integration for media requests
  • Music player with queue
  • Chromecast support

Installation

Android

Download the latest APK from the Releases page.

iOS

Coming soon on TestFlight.

Desktop

Download the appropriate installer for your platform from the Releases page:

  • Windows: .msi installer
  • macOS: .dmg image
  • Linux: .deb package

Building from Source

Requirements

  • JDK 17+
  • Android SDK (for Android builds)
  • Xcode 15+ (for iOS builds, macOS only)

Android

./gradlew :composeApp:assembleDebug

Desktop

./gradlew :composeApp:run

iOS

Open the iosApp/ directory in Xcode and run from there.

Roadmap

  • Jellyseerr integration (request movies & TV shows)
  • Music player with queue and background playback
  • Chromecast / AirPlay support
  • Light theme
  • Material You dynamic colors (Android)
  • Full iOS player implementation

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

For translations, see CONTRIBUTING_TRANSLATIONS.md.

License

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

Acknowledgments

About

A modern, cross-platform Jellyfin client built with Kotlin Multiplatform and Compose Multiplatform.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages