It looks like you're using an ad blocker, so you'll have to wait 15 more sec. Hide ads with Premium to skip the wait and help us pay for bandwidth, hosting, and other bills.
Or please add this site to your allowlist (AdBlock Plus,
uBlock Origin)
This release was previously available through Testflight for a few hours before we pulled it due to upgrade issues for some users. We hope that the issues have now been resolved, but if you experience startup errors after upgrading, please make sure to save the logs and then open an issue here on GitHub to let us know about it! Without logs it's extremely difficult to diagnose what went wrong :)
Hi everyone!
As you might have heard, we recently held Finamp's first Hackathon, "Finamplify". The hackathon was a success, and we received many contributions from both long-standing and new contributors alike! That's why there are a ton of new features and improvements in this release, so a huge thanks to everyone who participated! Many long-standing bugs and issues were resolved as well, making this a very well-rounded update! To learn about everything new, read on! And have fun trying it out!
If you're not using the beta yet (how to join) (click to expand)
The beta is free and open to everyone, but we'd like to get as much feedback as possible. So please do try it out and then let us know what you think!
Take note of your current Finamp settings, since this is a beta it could happen that the update changes some of them.
Downloads should be migrated, but since the new download system is completely different, there might be inconsistencies.
On Android, join the beta on Google Play or download the APK file from below. On iOS, join the beta on TestFlight.
We're currently not able to offer a beta on F-Droid (more info here), but you can use an app like Obtainium to automatically download the latest APK from GitHub.
Open Finamp and enjoy!
Keep in mind that not all of the text in the beta has been translated yet. If you're missing a translation, you can now contribute it on Weblate!
Bug Fixes
Finally fixed the "hanging/freezing on splash screen" issue! Huge thanks @corngood!
@corngood also fixed resuming from the media notification when Finamp was killed in the background (on Android)
Fixed the parent album opening after deleting a track (thanks @flloschy!)
Fixed library downloads missing from the downloads screen (thanks @Komodo5197!)
Prevent Finamp starting to play right-away on desktop (thanks @Komodo5197!)
Don't show sync button for media that hasn't been downloaded yet (thanks @Komodo5197!)
Tried to fix missing album art in media notification
What's New
Proper Differentiation Between Album Artists and Performing Artists (thanks @lukaslindnermusic!)
For a while now Finamp hasn't properly handled artists. Online mode showed performing artists, offline mode showed album artists, but there was no clear distinction between the two. This has now been fixed, and you can now choose between browsing/searching (performing) artists and album artists on the artists tab, both in online and offline mode! As part of this change, performing artists now have a section with albums which they appear on, but aren't an album artist. This matches Jellyfin's "Appears On" secion.
Note
Since previously only performing artists were downloaded, you'll need to run an automatic "repair" of the downloads in order for album artists to show up in offline mode. For that, go to the Downloads screen, and then click the little hammer/tools icon at the top right (the center icon of the three). The repair might take a few minutes to complete.
Additionally, it's now possible to collapse the various sections (top tracks, albums, appears on) on the artist screen.
Shoutout to @Komodo5197 for assisting with the offline mode integration!
Finamp will now automatically enable offline mode if all network connectivity is lost (WiFi *and mobile data). This will behave just like the regular offline mode, aside from automatically returning back to online mode once connectivity becomes available again. If you manually enable offline mode, it will still active indefinitely.
There is a new setting (see below) that lets you choose in which scenarios offline mode should be enabled. You can choose between all connectivity being lost, WiFi/Ethernet connection being lost, or never switching automatically.
This should be a nice improvement for anyone who hasn't exposed their Jellyfin server to the internet or via a VPN, or who does lives in an area with poor reception.
Keep in mind that the queue will not be reloaded when toggling offline mode, so if you start playback during online mode, Finamp will still fetch your media from the server, even in offline mode. That is of course unless you have the tracks downloaded already, since Finamp currently always prefers downloaded media.
Ever since its humble beginnings, Finamp supported transcoding to AAC when streaming from the server. Now it is finally possible to choose alternative formats to transcode to, enabling not only more flexibility, but much more efficient transcoding with modern codecs such as OPUS. We even have support for transcoding to FLAC now, for all you HiFi lovers out there who want to stay as lossless as possible while staying compatible with all kinds of devices. This should now allow Finamp to play virtually any source format without suffering an immense loss in quality compared to the original media.
For lossless target formats, such as FLAC, it's not possible to choose a bit rate.
Shoutout to @em1lyy for trying to add this over three years ago! Jellyfin and the mobile OSs simply weren't ready for it back then...
A while ago we added a setting to change what happens when swiping left or right on a track within an album or playlist. We have now enhanced this feature, allowing different actions for different directions, adding more possible actions, and also allowing to disable the swipe gesture for one or both directions completely. The latter should help to avoid accidentally adding a track to the queue when using gesture-based navigation.
You can customize this in the "Interactions" settings.
Support for Remote Controlling Finamp via 'Play On' (thanks @pinsarda!)
We added partial support for Jellyfin's 'Play On' feature! This means you can now control Finamp remotely from other Jellyfin clients which support this feature, like the official (web) apps! Playback controls will now also show up on the admin dashboard. You can even send a message to Finamp 🤯 The feature is enabled by default but can be disabled if desired.
Now, you might be asking yourself: "Why? What's the use in controlling a mobile app?" There are several reasons:
We agree that the more useful feature would be using Finamp to control other clients, like the headless Jellyfin mpv Shim, or the Android TV app. This uses the same technical foundation, but is more complicated to support in Finamp, so we decided to start with the easier part.
Finamp has (alpha) support for desktop platforms. You could theoretically have a media center PC connected to your stereo, or even just an old Android tablet. With Play On support, you can controll playback on either the player device itself or remotely via your phone or laptop.
Consistency and feature parity is important to us. We don't want the Jellyfin client ecosystem to become even more fragmented, with each client supporting some features but not others. That's why we're trying to implement any existing Jellyfin features that apply to a music-only client.
We are also trying to add support for the inverse direction (using Finamp to control other clients) soon, but don't have a concrete timeline yet.
Caveats
Play On is a complex feature, and since only a few clients support it, the documentation and compatibility aren't great. We did our best to provide you with a pleasant experience, but there are some things you should keep in mind:
You can simply click on the first track in the playlist; this will result in the correct order. Shuffle works in any case.
If Finamp is suspended in the background to save battery, you won't be able to connect to it
If you want Play On to work reliably and don't mind additional battery drain, turn off "Enable low-priority state on pause" in Finamp's "Audio Service" settings, and disable any battery optimizations for the Finamp app in your system settings.
Sometimes the remote control / playback info doesn't show up right-away when connecting from another client. It should show up eventually, and any controls should still work fine
Some buttons might not work yet, for example toggling the loop and shuffle modes or removing tracks from the queue
If you notice anything else that doesn't seem to work, please let us know!
Volume Control & New Output Menu
Together with support for the 'Play On' feature, we also added an internal volume for Finamp that lets you reduce playback volume independently of the system volume if needed. This is also used to allow controlling the volume remotely via Play On.
The volume slider can be found in the new Output menu, which you can access via the "Output" button in the lower left corner of the player screen. The cast/AirPlay button was also moved into this menu for consistency.
On Android, the output menu has some additional tricks up its sleeve. It shows available output devices, and you can switch between these directly from within Finamp (e.g. switching between Bluetooth headphones and the device's loudspeaker). There's also a button to connect to more devices, which currently opens the Bluetooth settings.
Fading In and Out on Play and Pause (thanks @fmuehlis!)
You can now configure durations for gradually increasing the volume when resuming or lowering it when pausing. You can set two different durations for fade in and fade out.
While the volume is being faded, a small animation will be shown around the play/pause button.
New Settings
Added settings for configuring fade in / fade out durations
Default is "Disconnected" (when no network connection is available at all) (changed, previous behavior equivalent to the "Disabled" option)
Added settings for configuring what happens when swiping tracks left and right
Settings > "Interactions" > "Swipe to Right Action" and "Swipe to Left Action"
Default is "Add to Next Up" when swiping left (unchanged), and "Disbled" when swiping right (changed, previous behavior equivalent to the "Add to Next Up" option)
Added settings category for "Playback Reporting & Play On"
We have a lot of features planned for the future, and we're always open to new ideas. Here are some of the things that we're planning to add:
A proper home screen
Redesign of more menus and screens
Separate server addresses for home networks
Sleep timer improvements
More contrast and accent color improvements
Desktop Support
This is now in a "soft release" stage, where it might already be available for your platform. An official release will happen in the future, but is currently not a priority.
Wow, that was a lot! But we're not done yet: this update doesn't include all the improvements from Finamplify, so stay tuned for another big beta update in a bit! We're now ramping up the development pace, with hopes to bring all the recent improvements to the stable version of Finamp very soon. And it would be awesome if you would like to help us with that!
From Saturday, March 29th (2025-03-29) until the end of Sunday, April 6th (2025-04-06), we are holding Finamp's first hackathon - called Finamplify. This is 9 days of intensive work on Finamp, by new and existing contributors!
Here are the most important infos:
The Hackathon is about making progress on Finamp's redesign, which is currently in beta. Therefore, please make sure to base your changes on the redesign branch when working on new features or fixes!. We won't accept new features targeting the main branch, as the branches have diverged quite a bit.
We would like to send out stickers to everyone who contributed to Finamp during this Hackathon! We'll mail the stickers to you for free, and this is entirely optional. Only significant contributions will be counted, so simply fixing a typo will not qualify you, sorry! To send you the stickers we'll need your physical address. Here's a survey where you can enter your details: TODO Please make sure to include your GitHub and/or Discord user name so we can ensure you actually contributed :)
The Hackathon is happening here on GitHub and on our Finamp Beta Testers Discord server. Ideally you should participate on both platforms, but either works. For any code contributions you'll have to contribute on GitHub though, via a regular Pull Request. Design contributions a fine via Discord.
And be sure to take a look at CONTRIBUTING.md to learn everything you need to start working on Finamp!
Redesign Beta
We're currently in the process of redesigning Finamp to transform it into a modern, beautiful, and feature-rich music player made specifically for Jellyfin. You can join the beta on Google Play and Apple TestFlight, or download the latest beta APK from the releases page. Please note that the beta is still work-in-progress, so the UI and functionality might be inconsistent or incomplete, and is not final. However, the beta is fully functional and should be stable enough for daily use.
Finamp is a Jellyfin music player for Android and iOS. It's meant to give you a similar listening experience as traditional streaming services such as Spotify and Apple Music, but for the music that you already own. It's free, open-source software, just like Jellyfin itself. Some of its features include:
A welcoming user interface that looks modern & unique, but still familiar
Downloading files for offline listening and saving mobile data. Can use transcoded downloads to save even more space.
Full support for Jellyfin's "Playback Reporting" feature and plugin, letting you keep track of your listening activity
You need your own Jellyfin server to use Finamp. If you don't have one yet, take a look at Jellyfin's website to learn more about it and how to set it up.
The SHA-256 fingerprint of Finamp's signing certificate is 20:61:C5:C9:28:9C:00:02:08:81:B7:E5:33:4D:93:A0:2D:FA:4B:E9:80:AF:20:C0:5D:B4:E5:29:C8:DA:5B:54. Google Play releases and provided APKs will be signed with this certificate. F-Droid releases will be signed with F-Droid's own signing certificates.
Frequently Asked Questions
Before Installing
Is Finamp free?
Absolutely! It costs nothing to use. We do appreciate voluntary contributions of any kind though, be that bug reports, code, designs, or ideas for new features. You can also donate to some of the developers to show your appreciation <3
How can I install Finamp?
On Android, Finamp can be installed from the Google Play Store, F-Droid store, or directly by installing the APK file from GitHub. On iOS, you can install Finamp through Apple's App Store. Just click on the buttons above.
Does Finamp support my media formats?
Finamp should support all formats supported by Jellyfin. Some more advanced formats could cause issues for regular playback, but transcoding should fix these issues.
Does Finamp support Android Auto / Apple CarPlay?
Theoretically, but not yet. There is an issue for this that contains a proof of concept for Android Auto in there, but it hasn't been tested yet. Maybe you could help out!
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, for example by purchasing music online. This often also directly supports your favorite artists!
After Installing
I'm having trouble with Finamp, where can I find help?
If you're experiencing software bugs or other issues with Finamp, be sure to take a look at Finamp's issue tracker, especially the pinned issues at the top of the page. If you can't find anything related to your specific problem, please create a new issue (you will need a GitHub account).
Contributing
Finamp is a community-driven project and relies on people like you and their contributions. To learn how you could help out with making Finamp even better, take a look at our Contribution Guidelines
Tranlations
You can also contribute by helping to translate Finamp! This is done through our Weblate instance here: https://hosted.weblate.org/engage/finamp/. The current translation status is this:
Known Issues
This app is still a work in progress, and has some bugs/issues that haven't been fixed yet. Here is a list of currently known issues:
Reordering the queue while shuffle is enabled is not possible at the moment. It seems like this is an issue with a dependency of Finamp (just_audio), and is being tracked here
If you have a very large library or an older phone, performance might not be great in some places
Planned Features
Improved Android Auto / Apple CarPlay support
Full redesign, adding more features and a home screen. See this issue for more info
This APK com.unicornsonlsd.finamp_0.9.16-117_minAPI21(arm64-v8a,armeabi-v7a,x86,x86_64)(nodpi)_apkmirror.com.apk is signed by jmshrv and upgrades your existing app.
Verify the file you downloaded is not corrupt and was not tampered with using the file hashes above.
Why Can't I Download This APK?
While APKMirror strives to provide APK downloads for as many popular apps as possible, sometimes app developers ask us to
take their apps down and link to an official download source instead, such as the Google Play Store. Please understand that
we have to respect such decisions and therefore cannot offer a direct APK download for this app right now.
Premium
