About this project

Finamp is an open-source music player client for Jellyfin, available for Android and iOS. It aims to provide a streaming-service-like listening experience for music hosted on a user's own Jellyfin server. The project is community-driven and free to use. Key features described in the README include a modern user interface, downloading files for offline listening, transcoded downloads and streaming to save mobile data, dynamic colors that adapt to media, audio volume normalization (ReplayGain, Jellyfin 10.9+), lyrics (Jellyfin 10.9+), gapless playback, support for Jellyfin's Playback Reporting feature, and integration with AudioMuse for sonic analysis and improved mixes. Android Auto support is listed as coming soon. Finamp requires a self-hosted Jellyfin server; it does not include music or connect to other streaming services. It can be installed from Google Play, F-Droid, the Apple App Store, or as an APK from the releases page. A redesign beta is available via Google Play and Apple TestFlight. The README also covers contribution opportunities such as design improvements, bug hunting, translations via Weblate, documentation, codebase improvements, and community support. Known issues include queue reordering while shuffle is enabled and performance concerns on very large libraries or older devices. Planned features include improved Android Auto/Apple CarPlay support, a full redesign, better playlist editing, multiple users/servers, and more customization. Advanced users on Linux can control dynamic theming through DBus calls.