finamp

![Several screenshots of Finamp, featuring various screens in the app on desktop, Android, and iOS](<images/GitHub_Banner.png>)

<div align="center">
  <a href="https://play.google.com/store/apps/details?id=com.unicornsonlsd.finamp"><img src="assets/app-store-badges/play-store.png"
      alt="Get it on Google Play"
      height="80"></a>
  <a href="https://apps.apple.com/us/app/finamp/id1574922594"><img src="assets/app-store-badges/app-store.svg"
      alt="Download on the App Store"
      height="80"></a>
  <a href="https://f-droid.org/packages/com.unicornsonlsd.finamp/"><img src="assets/app-store-badges/fdroid.png"
    alt="Get it on F-Droid"
    height="80"></a>
  <br />
  <i><a href="#installing-finamp">Alternative ways to get Finamp</a></i>
</div>

## TL;DR

Finamp is a **free** Jellyfin music player for Android, iOS and Desktop. It allows you to stream and download the music you own. It has a modern but **thought-through** design, a ton of features, is customizable, and respects your **privacy**!

> [!IMPORTANT]
> You **need** access to a [Jellyfin](https://jellyfin.org) server or you **won't be able to use Finamp at all**.  
> ([Navidrome](https://github.com/navidrome/navidrome/releases/tag/v0.64.0) and [Lyra](https://github.com/lyra-org/lyra) also work, but aren't actively supported)

## Features

Finamp comes with a bunch of features, but here are the ones we think are **most interesting**:

- Gapless playback
- Download music to listen offline
- Transcoded streaming for reduced mobile data usage
- Dynamic colors based on the current track & your device's theme
- Lyrics Support
- Audio volume normalization (aka "ReplayGain")
- Android Auto & CarPlay support
- Integration with [AudioMuse](https://github.com/NeptuneHub/AudioMuse-AI) for sonic analysis and improved mixes
- [Desktop support](#other-installation-methods)
- Support for the tracking your listening via the [Playback Reporting](https://jellyfin.org/docs/general/server/plugins/#playback-reporting) plugin, even when you are offline!
- *And more for you to explore, e.g. via [our Wiki](https://github.com/finamp-app/finamp/wiki)!*

## Screenshots

![Banner with screenshots of Finamp, showing the player screen, light mode, dark mode & adaptive theme colors, and the downloads screen. It includes the following text: Stream your music from your server, or download it for offline playback. Light & dark mode with adaptive theme](images/GitHub_Screenshots_1.png)

![Banner with screenshots of Finamp, showing the queue panel, home & library tabs, and lyrics screen. It includes the following text: Powerful queue with advanced Next Up, dedicated home tab and library browsing, time-synced lyrics support](<images/GitHub_ Screenshots_2.png>)

## Community & Discussions

Have a simple question about Finamp, or struggling with setting up your Jellyfin correctly?  
Just want someone to talk to and share your favorite music with?  
Aside from using the [Issues](https://github.com/jmshrv/finamp/issues)