hi, i'm rob

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 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

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

• Google Play
• F-Droid
• .apk: see the latest GitHub release

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

• .app: see the GitHub release

Linux

• Flathub
• AUR
  • Install via yay -S finamp

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 started. 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.

Is Finamp legal?

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