Finamp (github version) 0.9.20

Hi everyone!
Welcome to the seventh Finamp beta update of the year!
It's been a while since the last update, with many of the core contributors being busy with life. That doesn't mean we don't have some exciting new features and improvements in store for you, though!
Check out the full release notes below for all the details!
Caution
While the brand new Jellyfin version 10.11.x is now out, we heard several reports about
significantly reduced performance
for music libraries. This means slow load times throughout Finamp, and even in the official apps.
Therefore we
urge you not to upgrade to 10.11 yet
. We are certain that these performance issues will be resolved in a short while as testing continues.
The only improvements related to Finamp introduced with 10.11 are word-by-word lyrics highlighting (if you have the necessary files), and the ability to remote-control Finamp sessions through non-admin accounts using the official apps. If these features aren't essential to you, we recommend to wait before upgrading.
We will inform you once our recommendations change. Thank you for your understanding, and honest thanks for the Jellyfin team to following through with this massive undertaking! Even though there are some issues now, we absolutely appreciate the structural improvements made in 10.11 and the effort and passion the whole team poured into this ❤️. This will also affect Finamp's development positively.
TL;DR
New Features:
Edit playlists, including reordering tracks
Redesigned playback options
Custom accent colors
Bug Fixes:
Fixed automatic offline mode not resuming in some scenarios
Fixed playing wrong track when sorting randomly while offline
Fixed gray overlay when reordering tracks
Fixed lyrics not updating during a downloads repair
Fixed various startup errors
Note
Throughout the release notes you will find links marked with the 🔗 icon; these links will open Finamp to the relevant screen, so that you can play around with the new settings right-away!
How to join the Beta (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!
Join the
Finamp Beta Testers Discord server
This step is optional, but since we're looking for feedback, it would be great if you could join!
Alternatively, there's a discussion for the beta right here on GitHub:
Redesign Beta discussion
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
!
Important
We've updated some default settings related to downloading to improve performance while downloads are running. These should decrease lags without slowing down downloads, and we recommend everyone to apply these new defaults.
To do this, open the
🔗 Downloads Screen
, scroll to the bottom, and set "Download Worker count" to
1
and "Max Concurrent Downloads" to
5
.
Alternatively, you could reset all download-related settings to their defaults by tapping the reset button at the top right of the
🔗 Downloads Screen
. This will however reset
all
settings on the downloads screen to their defaults, which you might not want.
Bug Fixes
Fixed
🔗 Automated Offline Mode
not resuming after overriding it once while in "Local Network" mode (thanks
@flloschy
!)
Fixed colored bars appearing at the top and bottom of the screen in some cases when scrolling (thanks
@Komodo5197
!)
Fixed wrong track being played when tapping a track on the "Tracks" tab when using random sorting in offline mode
Fixed gray/white overlay when reordering tracks in the queue (thanks
@Komodo5197
!)
Fixed gain (volume) not resetting properly for tracks without normalization data
Fixed the new "album gain" (for consecutive tracks from the same album, when in "Dynamic" mode) when Finamp is in the background (thanks
@HeroBrine1st
)
Finamp would stop fetching some metadata while in the background, causing the wrong gain to be applied
Fixed download errors after updating media images (thanks
@Komodo5197
!)
Fixed lyrics not updating during a downloads repair
Fixed various startup errors (thanks
@Komodo5197
!)
When user-installed certificates can't be trusted
The database compaction file already exists
Fixed
finamp://
links opening in a broken second instance on Windows
Fixed local server address sometimes not saving after editing it
What's New
Playlist Editing (thanks
@F-4Dev
for the initial implementation!)
One of Finamp's long-standing limitations as a music client has been that it wasn't possible to reorder the tracks of a playlist.
While we've recently added the ability to change the
sorting
of playlists within the apps, this is only temporary and not synced with other clients.
So we're happy to let you know that this is finally possible, using the brand new edit playlist screen!
If your user account is the owner of a playlist (and you're not offline), you should now see a new option in the top bar and menu of playlists that lets you edit the playlist. This will open the playlist in an edit view where you can change its name, visibility, image, and tracks.
You can rearrange tracks, remove them, and also restore them from the bottom if you removed them by accident. In the future we'll also give you a away to easily add more tracks to the playlist, for now you'll have to use the menu of the item you want to add for this.
Keep in mind that in order to update the playlist image, your user account needs to be able to change media metadata in Jellyfin, which is tied to the administrator permission ("Allow this user to manage the server"). The Jellyfin team recommends
not
using admin accounts in normal clients (like Finamp), so you might still want to use the Jellyfin app to manage your playlist images.
New Playback Row Interaction (thanks
@lukaslindnermusic
!)
In a previous update we've simplified Finamp's menus, integrating all options for playback into a single, horizontally-paged row that lets you play, shuffle, and queue up an item.
In this update, we've extended this to the actual album, playlist, artist, and genre screens as well.
Instead of having two large, colorful buttons for play and shuffle, you now get this "Playback Row" that has all former options and more, and will remember the last-used "target" for playback (i.e., adding to queue, to Next Up, or starting playback right away).
As part of this, we've changed the categories for the playback row, from "Play" and "Shuffle" to "New Queue", "Play Next", "Append Next", and "Play Last", with options for playing in order or shuffled in each category.
All of this should make playback options more apparent, make Finamp's design a bit more coherent, and reduce needed taps for frequent actions. The menu button has moved to the top right of the screen as part of this change.
We hope you like this new interaction!
Custom Accent Color (thanks
@likhithpraveenk
!)
While Finamp lives from its adaptive colors based on media images, there are some parts of the app that were always a certain shade of blue. This is Finamp's default accent color.
With this update however you can now change this accent color to whatever color you like! The accent color will then be used to create a cohesive theme that is used in all parts of the app that aren't adaptively themed.
Right now this is limited to one single, static color, but we hope to integrate Android's adaptive "Monet" theming (based on the device wallpaper) down the road. We appreciate any assistance with implementing that :)
Play Individual Discs of Albums (thanks
@HeroBrine1st
!)
Since albums disc are sometimes split into different types of tracks (acoustic versions, instrumental, etc.) we've now added the ability to play just a single disc of an album. The disc header can now be tapped, swiped, or long pressed, just like a track can be. And similar to albums, you can play, shuffle, add to Next Up, and so on!
Word-by-Word Lyrics Highlighting! (thanks
@Maxr1998
!)
This was actually already implemented in 0.9.19, but we're including it here since coincidentally the new Jellyfin update 10.11.x just got released, which is required for this feature to work.
If you have synced lyrics in the required format (with word-level timestamps), Finamp will now use these to highlight the current word in proper Karaoke fashion!
*Please keep in mind that we don't recommend upgrading to 10.11 at this time (see the top of these release notes). However, if you're excited for this feature, it should be working just fine.
When is the Home Screen finally coming?!?
At the end of last release notes we noted that discussion was still ongoing. We've now settled on an improved design, that stays very close to Finamp's existing structure and navigation, while still introducing the home screen as a central hub for browsing suggestions.
So while this update does not, the next update
will
include the new home screen. This will most likely be the last major change before this beta version transitions to the stable channel. Thank you for being patient with us!
Other Changes
Reduced the amount of errors queued up, limiting them to unique errors and silencing some common but unproblematic errors completely
Finamp now correctly reports the transcoding status to the server
Due to some limitations in the Jellyfin API, not all infos (target codec, bitrate, reason) are reported, but it doesn't say "Direct Playing" anymore when it's actually transcoding
Added a setting to toggle favorite state on tap instead of opening the add to playlist menu (thanks
@HeroBrine1st
!)
🔗 "Add to Favorites When Tapping Heart Icon"
Added a setting to automatically start playing restored queues (including on startup!) (thanks
@Komodo5197
!)
🔗 "Automatically Play Restored Queues"
Enable the "Fast Scroller" (alphabet bar) when sorting by album artist on the albums and tracks tabs (thanks
@Maxr1998
!)
Disabled adding items to "Next Up" (or playing them next) on Windows and Linux
This currently isn't working due to a bug in a library we use, and it's causing bugs and confusion
Updated the base volume normalization gain on iOS and desktop, to increase the default volume for most libraries
Finamp now remembers the last state of the previous tracks section in the queue panel, so that the next time you open the queue the previous tracks are still expanded, if they were expanded before you closed the panel
Scroll bars on the lyrics screen are now only shown when manually scrolling (thanks
@ios7jbpro
and
@Komodo5197
!)
External downloads now use an improved directory structure and the original file name for downloaded tracks
This change does not apply to already downloaded media
When trying to add a download location in an unsupported location, Finamp will now warn you about potential issues (thanks
@Komodo5197
!)
Many more improvements to details and performance that you might notice (mostly contributed by
@Komodo5197
, thanks!)
New Settings
Toggle between opening add to playlist menu or adding to favorites when "liking"
The alternative action is always available via long press (or right click)
🔗 Settings > "Interactions" > "Add to Favorites When Tapping Heart Icon"
Default is disabled (unchanged)
Automatically start playing queues that have been restored (manually via "Restore Now Playing", or on startup)
🔗 Settings > "Audio Service" > "Automatically Play Restored Queues"
Default is disabled (unchanged)
Changed Settings
Default of "Base Gain" changed
Default is now
+6.0
(changed from -2.0)
🔗 Settings > "Volume Normalization" > "Base Gain"
You'll have to apply the new defaults
manually
(if you want to use them)
Default of "Show text in grid view" changed
Default is now
off
(changed from on)
🔗 Settings > "Layout & Theme" > "Show text in grid view"
You'll have to apply the new defaults
manually
(if you want to use them)
Default of "Download Worker count" changed
Default is now
1
(changed from 5)
🔗 Settings > "Downloads" > "Download Worker count"
The maximum value has been decreased from 10 to
5
You'll have to apply the new defaults
manually
(if you want to use them)
Default of "Max Concurrent Downloads" changed
Default is now
5
(changed from 10)
🔗 Settings > "Downloads" > "Max Concurrent Downloads"
The maximum value has been decreased from 100 to
25
You'll have to apply the new defaults
manually
(if you want to use them)
Upcoming Features
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
Radio modes for continuous playback
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.
???
You can take a look at the full list and current progress in the
Redesign project
.
We also have a more up-to-date hackathon project board:
https://github.com/users/jmshrv/projects/5
Let's hope we can push out the next update a bit faster, on our way to the finish line of a proper stable release!
We're still looking for new contributors and hope that you'll help us make this app even better!
Thank you for using Finamp!
- Chaphasilor
New Contributors
@ios7jbpro
made their first contribution in
#1371
@likhithpraveenk
made their first contribution in
#1406
Download Links
Google Play:
Join the beta
TestFlight:
Join the beta
Android
.apk
: see below
F-Droid: not available, see above
Flathub:
Download the alpha
macOS
.app
: see below for the alpha version

Hacktoberfest

Ever thought about contributing to Finamp or Open Source in general? Now is the time! It's Hacktober afterall!

There are a lot of things

you

can help with with regard to Finamp:

Design Improvements

Help us redesign some missing screens! We have some mockups to get you started, just ask around here on GitHub or on our

Discord Server

!

Fix visual bugs or improve the UI

Bug Hunting

Fixing bugs

Adding reproduction steps for existing bugs

Finding bugs

Translations

You can look at our

Weblate Project

to add missing translations

You can also add descriptions (i.e., where that string appears in the app) to some older translations strings in

this file

Improving Documentation

User Documentation (Was there anything you struggled with at first when using Finamp? How did you solve it?)

Developer Documentation (Was there anything you struggled with when contribution code to Finamp? Add your solution to

CONTRIBUTING.md

)

Improving the codebase

Optimizations (eg. Finamp currently consumes a lot of battery)

Documentation

Clean up

Support

Help other people on our

Discord Server

Give feedback on

Pull Requests

Spread the word and get your friends to contribute :D

If you like Finamp but don't want to contribute for any reason, you can also contribute

to Jellyfin directly

or to upstream libraries which Finamp uses (

just_audio

,

background_downloader

, etc.).

That way you can help Finamp indirectly and Open Source as a whole! Finamp can't exists without maintained and stable libraries :)

What to do?

There's still a lot left over from our latest "Finamplify" Hackathon! Take a look at the

Finamplify Project Board

or even the full

Redesign Project Board

(the latter is slightly outdated).

You can find an overview of (hopefully) easy to tackle issues

here on GitHub

. For some of those prior programming experience is definitely helpful.

Specifically, here a short list of long awaited features:

Car Play

Metadata editing

Multi user/server support

Various improvements for Finamp Desktop (Fixing shuffle, improved UI, better system integration)

Automatic (Widget) Tests

How to get started

Important

Make sure to check out the

redesign

branch (

git checkout redesign

)! This is where all development happens at the moment!

Start by reading the

"Setting up a Development Environment" section

in our contribution guidelines.

Then, once flutter is working, you can simply do

flutter run

! Any changes you do to the code can be applied via hot-reload by pressing

r

in the terminal. There are also first-party Flute integrations for many editors and IDEs.

If you have any questions, just reach out to us on GitHub or

Discord

!

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.

Transcoded streaming for saving mobile data

Beautiful dynamic colors that adapt to your media

Audio volume normalization ("ReplayGain") (Jellyfin 10.9+)

Lyrics (Jellyfin 10.9+)

Gapless playback

Android Auto support (coming soon™)

Full support for Jellyfin's "Playback Reporting" feature and plugin, letting you keep track of your listening activity

Integration with

AudioMuse

for sonic analysis and improved mixes

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.

Getting Finamp

Note: The F-Droid release may take a day or two to get updates because since

F-Droid only builds once a day

.

The app is also available as an APK from the

releases page

.

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

Translations

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

Better playlist editing

Multiple users/servers

More customization options

Screenshots (Stable Version, outdated)


https://raw.githubusercontent.com/jmshrv/finamp/master/fastlane/metadata/android/en-US/images/phoneScreenshots/1.png

>


https://raw.githubusercontent.com/jmshrv/finamp/master/fastlane/metadata/android/en-US/images/phoneScreenshots/2.png

>


https://raw.githubusercontent.com/jmshrv/finamp/master/fastlane/metadata/android/en-US/images/phoneScreenshots/3.png

>


https://raw.githubusercontent.com/jmshrv/finamp/master/fastlane/metadata/android/en-US/images/phoneScreenshots/4.png

>

Name source:

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