Dart MPL-2.0

finamp

An open source Jellyfin music player

F

finamp-app

Dernière activité 26 sept. 2026
finamp-app/finamp

4,3 k

étoiles

305

forks

388

issues ouvertes

flutterhacktoberfestjellyfinjellyfin-clientmusic

Ce README est souvent en anglais.

Several screenshots of Finamp, featuring various screens in the app on desktop, Android, and iOS

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 design that should feel familiar right-away, a few customizations and of course privacy!

Important

You need access to a Jellyfin server or you won't be able to use Finamp at all.
(Navidrome and 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 for sonic analysis and improved mixes
  • Desktop support
  • Support for the tracking your listening via the Playback Reporting plugin, even when you are offline!
  • And more for you to explore, e.g. via our 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

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

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 and Discussions functionality here on GitHub, you could also join our Finamp Beta Discord server!
We post release notes and announcements there too, and you'll likely get a reply more quickly there compared to GitHub.

Installing Finamp

Android

Windows

Since the app is not available via the Microsoft Store yet, you'll have to install a self-signed certificate before you can install the .msix file attached to each release. You'll only have to do this once!

  1. Download the latest .msix file from the release page, then navigate to the folder you downloaded it to in File Explorer
  2. Right-click the package and select Properties
  3. Properties: Switch to the Digital Signatures tab, then select Finamp under Signature list (or Embedded Signatures), then click Details
  4. Digital Signature Details: click View Certificate
  5. Certificate: click Install Certificate...
  6. Certificate Import Wizard: set Store Location to Local Machine, click Next, then Place ... in the following store and browse to Trusted People, then Next and Finish
  7. You can now close all the popups and open the MSIX file to install it!

Alternatively, you could download the plain zip archive and manually drag it into the correct place. This is however not a portable installation, since it will still create the database in your user directory.

Mac

Linux

Contributing

Code

Just like any FOSS software Finamp also relies on your contributions! If you are interested you can consult the Contribution Guidelines to get stated. Anything helps!

If you have any questions, just reach out to us on GitHub or Discord (#contributing)`!

Translations

You can also help out by translating Finamp using our weblate page. Here is the current state of translations:

FAQ - Frequently Asked Questions

Do you accept donations?

Contributions and donations of any kind are welcome, but you can't donate to Finamp directly. So, if you see some new feature or fix in the release notes that you like, feel free to check if the person that contributed that accepts donations!

Which formats/codecs does Finamp support?

Most. Generally speaking if Jellyfin and your device support a format, Finamp will too! In case a format doesn't work you can always enable transcoding (Finamp can transcode lossless transcoding to FLAC!).

Does Finamp support Android Auto / Apple CarPlay?

Yes! Both are supported, but if you want to use Android Auto, you'll have to install the app via the Play Store.

Yes. Finamp is a tool that lets you interface with a Jellyfin server. Finamp does not come with any music, and will not connect to streaming services other than Jellyfin.
You will need to bring your own media and add it to Jellyfin, by purchasing music online or ripping discs. This often also directly supports your favorite artists!

Bugs, Problems and Feature Requests

If you encounter any errors, issues, accessibility problems or the likes please check our issue tracker first, and open a new issue if there isn't one already.

Shoutout

  • Thanks to all the Contributors and Maintainer (see bellow) who helped to make, fix and improve Finamp! Without you Finamp wouldn't be Finamp. ❤️
  • Thanks to the Jellyfin Contributors without whom Finamp wouldn't exists in the first place and thanks for making self-hosting and privacy easier!
  • Thanks to all the Developers who created and maintain packages Finamp uses!
  • And thank you for using Finamp!

Name source: https://www.reddit.com/r/jellyfin/comments/hjxshn/jellyamp_crossplatform_desktop_music_player/fwqs5i0/


Info For Advanced Users

Dynamic Theming On Linux

On Linux, Finamp registers itself with the DBus system, which means you can send messages locally to Finamp! This system allows you keep Finamp's color theme up to date with your dynamic color theme without restarting the app. There are two color related "endpoints" you can call:

  1. Reload the system accent color from GTK (Settings > Layout & Theme > "Use System Accent" needs to be enabled)
gdbus call \
    --session \
    --dest 'com.unicornsonlsd.FinampSettings' \
    --object-path '/com/unicornsonlsd/Finamp' \
    --method 'com.unicornsonlsd.Finamp.updateAccentColor'
  1. Overwrite the accent color (Settings > Layout & Theme > "Use System Accent" needs to be disabled)
    Only works when Finamp is running.
gdbus call \
    --session \
    --dest 'com.unicornsonlsd.FinampSettings' \
    --object-path '/com/unicornsonlsd/Finamp' \
    --method 'com.unicornsonlsd.Finamp.setAccentColor' \
    '#ff0000' # you can also send "default" to clear the accent color

Projets similaires

A modern self-hosted music player.

TypeScriptjellyfinmusic-playernavidrome
Jjeffvli
10 k étoiles547

🎧 Open source music streaming app! Available for both desktop & mobile!

Dartandroidandroid-clientandroid-music-player
Tteam-spotube
49,5 k étoiles2,3 k

A lightweight & elegant music interface for Jellyfin.

TypeScriptjellyfinmusic
SStannnnn
272 étoiles12