You can subscribe to release announcements by:

Subscribing to the following Atom feed: https://dev.funkwhale.audio/funkwhale/funkwhale/commits/develop?format=atom&search=Merge+tag

This changelog is viewable on the web at https://docs.funkwhale.audio/changelog.html.

Fixed domains table hidden controls when no domains are found (#1198)

Fixed broken search when using (, ” or & chars (#1196)

Ensure search page reloads if another search is submitted in the sidebar (#1197)

Fixed an issue with search pages where results would not appear after navigating to another page

Fix random radio so that podcast content is not picked up (#1140)

[plugin, scrobbler] Use last.fm API v2 for scrobbling if API key and secret are provided

Users can now update their email address (#292)

Play button now replace current queue instead of appending to it (#1083)

More consistent search UX on /albums, /artists, /radios and /playlists (#1131)

Do not include tracks in album API representation (#1102)

Confirm email without requiring the user to validate the form manually (#407)

Can now launch server import from the UI (#1105)

Allow users to hide compilation artists on the artist search page (#1053)

API Authentication using JWT is deprecated and will be removed in Funkwhale 1.0. Please use OAuth or application tokens and refer to our API documentation at https://docs.funkwhale.audio/swagger/ for guidance.

If you want to retrieve tracks for an album, you can query /api/v1/tracks/?album=<albumid> .

To increase performance, querying /api/v1/albums doesn’t return album tracks anymore. This caused some performance issues, especially as some albums and series have dozens or even hundreds of tracks.

If you are consuming the API via a third-party client and need to retrieve your libraries, use the scope parameter, like this: GET /api/v1/libraries?scope=me

Now, it returns all the accessible libraries (including ones from other users and pods).

Before, it returned only libraries owned by the current user.

To allow easier crawling of public libraries on a pod,we had to make a slight breaking change to the behaviour of GET /api/v1/libraries .

If you don’t want to regenerate thumbnails, you can keep the old ones by adding THUMBNAIL_JPEG_RESIZE_QUALITY=70 to your .env file.

run python manage.py fw media generate-thumbnails to regenerate thumbnails with the enhanced quality

delete the __sized__ directory in your MEDIA_ROOT directory

Because of this change, existing thumbnails will not load, and you will need to:

Default quality for JPEG thumbnails was increased from 70 to 95, as 70 was producing visible artifacts in resized images.

If it returns 3.5 , you will need to upgrade your Python version/Host, then recreate your virtual environment:

If it returns 3.6 or higher, you have nothing to do.

With Funkwhale 1.0, we’re dropping support for Python 3.5. Before upgrading, ensure python3 --version returns 3.6 or higher.

Upgrade instructions are available at https://docs.funkwhale.audio/admin/upgrading.html

Fixed player crash when using Funkwhale as a PWA (#1157)

Fixed crash with null help text in admin (#1161)

Use role=alert on forms/toast message to improve accessibility (#1134)

Can now filter subscribed content through API (#1116)

Added a new ?related=obj_id filter for artists, albums and tracks, based on tags

Upgrade instructions are available at https://docs.funkwhale.audio/admin/upgrading.html

If you are consuming the API via a third-party client and need to retrieve your libraries, use the scope parameter, like this: GET /api/v1/libraries?scope=me

Now, it returns all the accessible libraries (including ones from other users and pods).

Before, it returned only libraries owned by the current user.

To allow easier crawling of public libraries on a pod,we had to make a slight breaking change to the behaviour of GET /api/v1/libraries .

Include tracks by album artist when filtering by artist on /api/v1/tracks (#1078)

Fixed page not refreshing when switching between My Library and Explore sections (#1091)

Fixed mimetype detection issue that broke transcoding on some tracks (#1093). Run python manage.py fix_uploads --mimetype to set proper mimetypes on existing uploads.

Ensure tracks linked to skipped upload can be pruned (#1011)

Ensure player doesn’t disappear when last queue track is removed manually (#1092)

Added safeguard to ensure local uploads are never purged from cache (#1086)

Updated the /api/v1/libraries endpoint to support listing public libraries from other users/pods (#1151)

Support for specifying itunes:email and itunes:name in channels for compatibiliy with third-party platforms (#1154)

Fix HTML <title> not including instance name in some situations (#1107)

Support a –watch mode with import_files to automatically add, update and remove files when filesystem is updated (#721)

Upgrade instructions are available at https://docs.funkwhale.audio/admin/upgrading.html

This 0.21 release is dedicated to Agate, to thank her, for both having created the Funkwhale project, being the current lead developer, and for her courage of coming out. Thank you Agate from all the members of the Funkwhale community <3

We are truly grateful as well to the dozens of people who contributed to this release with translations, development, documentation, reviews, design, testing, feedback, financial support, third-party projects and integrations… You made it possible!

Upgrade instructions are available at https://docs.funkwhale.audio/admin/upgrading.html, there are also additional operations you need to execute, listed in the changelog below (search “Manual action”).

Channels and podcasts¶ Funkwhale 0.21 includes a brand new feature: Channels! Channels can be used as a replacement to public libraries, to publish audio content, both musical and non-musical. They federate with other Funkwhale pods, but also other fediverse software, in particular Mastodon, Pleroma, Friendica and Reel2Bits, meaning people can subscribe to your channel from any of these software. To get started with publication, simply visit your profile and create a channel from there. Each Funkwhale channel also comes with RSS feed that is compatible with existing podcasting applications, like AntennaPod on Android and, within Funkwhale, you can also subscribe to any podcast from its RSS feed! Many, many thanks to the numerous people who helped with the feature design, development and testing, and in particular to the members of the working group who met every week for months in order to get this done, and the members of other third-party projects who took the time to work with us to ensure compatibility.

Redesigned navigation, player and queue¶ This release includes a full redesign of our navigation, player and queue. Overall, it should provide a better, less confusing experience, especially on mobile devices. This redesign was suggested 14 months ago, and took a while, but thanks to the involvement and feedback of many people, we got it done!

Improved search bar for searching remote objects¶ The search bar now support fetching arbitrary objects using a URL. In particular, you can use this to quickly: Subscribe to a remote library via its URL

Listen a public track from another pod

Subscribe to a channel

Screening for sign-ups and custom sign-up form¶ Instance admins can now configure their pod so that registrations required manual approval from a moderator. This is especially useful on private or semi-private pods where you don’t want to close registrations completely, but don’t want spam or unwanted users to join your pod. When this is enabled and a new user register, their request is put in a moderation queue, and moderators are notified by email. When the request is approved or refused, the user is also notified by email. In addition, it’s also possible to customize the sign-up form by: Providing a custom help text, in markdown format

Including additional fields in the form, for instance to ask the user why they want to join. Data collected through these fields is included in the sign-up request and viewable by the mods

Federated reports¶ It’s now possible to send a copy of a report to the server hosting the reported object, in order to make moderation easier and more distributed. This feature is inspired by Mastodon’s current design, and should work with at least Funkwhale and Mastodon servers.

Improved search performance¶ Our search engine went through a full rewrite to make it faster. This new engine is enabled by default when using the search bar, or when searching for artists, albums and tracks. It leverages PostgreSQL full-text search capabilities. During our tests, we observed huge performance improvements after the switch, by an order of magnitude. This should be especially perceptible on pods with large databases, more modest hardware or hard drives. We plan to remove the old engine in an upcoming release. In the meantime, if anything goes wrong, you can switch back by setting USE_FULL_TEXT_SEARCH=false in your .env file.

Enforced email verification¶ The brand new ACCOUNT_EMAIL_VERIFICATION_ENFORCE setting can be used to make email verification mandatory for your users. It defaults to false , and doesn’t apply to superuser accounts created through the CLI. If you enable this, ensure you have a SMTP server configured too.

More reliable CLI importer [manual action required]¶ Our CLI importer is now more reliable and less prone to Out-of-Memory issues, especially when scanning large libraries. (hundreds of GB or bigger) We’ve also improved the directory crawling logic, so that you don’t have to use glob patterns or specify extensions when importing. As a result, the syntax for providing directories to the command as changed slightly. If you use the import_files command, this means you should replace scripts that look like this: python api/manage.py import_files $LIBRARY_ID "/srv/funkwhale/data/music/**/*.ogg" "/srv/funkwhale/data/music/**/*.mp3" --recursive --noinput By this: python api/manage.py import_files $LIBRARY_ID "/srv/funkwhale/data/music/" --recursive --noinput And Funkwhale will happily import any supported audio file from the specified directory.

User management through the server CLI¶ We now support user creation (incl. non-admin accounts), update and removal directly from the server CLI. Typical use cases include: Changing a user password from the command line

Creating or updating users from deployments scripts or playbooks

Removing or granting permissions or upload quota to multiple users at once

Marking multiple users as inactive All user-related commands are available under the python manage.py fw users namespace. Please refer to the Admin documentation for more information and instructions. Progressive web app [Manual action sugFull list of changes ^^^^^^^^^^^^^^^^^^^^gested, non-docker only] ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ We’ve made Funkwhale’s Web UI a Progressive Web Application (PWA), in order to improve the user experience during offline use, and on mobile devices. In order to fully benefit from this change, if your pod isn’t deployed using Docker, ensure the following instruction is present in your nginx configuration: location / front / { # Add the following line in the /front/ location add_header Service - Worker - Allowed "/" ; }

Postgres docker changed environment variable [manual action required, docker multi-container only]¶ If you’re running with docker and our multi-container setup, there was a breaking change starting in the 11.7 postgres image (https://github.com/docker-library/postgres/pull/658) You need to add this to your .env file: POSTGRES_HOST_AUTH_METHOD=trust Newer deployments aren’t affected.

Upgrade from Postgres 10 to 11 [manual action required, docker all-in-one only]¶ With our upgrade to Alpine 3.10, the funkwhale/all-in-one image now includes PostgreSQL 11. In order to update to Funkwhale 0.21, you will first need to uprade Funkwhale’s PostgreSQL database, following the steps below: # open a shell as the Funkwhale user sudo -u funkwhale -H bash # move to the funkwhale data directory # (replace this with your own if you used a different path) cd /srv/funkwhale/data # stop the funkwhale container docker stop funkwhale # backup the database files cp -r data/ ../postgres.bak # Upgrade the database docker run --rm \ -v $(pwd)/data:/var/lib/postgresql/10/data \ -v $(pwd)/upgraded-postgresql:/var/lib/postgresql/11/data \ -e PGUSER=funkwhale \ -e POSTGRES_INITDB_ARGS="-U funkwhale --locale C --encoding UTF8" \ tianon/postgres-upgrade:10-to-11 # replace the Postgres 10 files with Postgres 11 files mv data/ postgres-10 mv upgraded-postgresql/ data Once you have completed the Funkwhale upgrade with our regular instructions and everything works properly, you can remove the backups/old files: sudo - u funkwhale - H bash cd / srv / funkwhale / data rm - rf ../ postgres . bak rm - rf postgres - 10