10000 Release v0.55.0 · navidrome/navidrome · GitHub
[go: up one dir, main page]
More Web Proxy on the site http://driver.im/
Skip to content

v0.55.0
Compare
Choose a tag to compare
@github-actions github-actions released this 09 Mar 23:32
· 148 commits to master since this release
v0.55.0
365df52
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Navidrome 0.55.0 - Big Refactor (BFR) Release Notes

Overview

Navidrome 0.55.0 introduces the highly anticipated Big Refactor (BFR), significantly enhancing core functionalities,
and introducing robust new features. This release brings substantial improvements in handling file management and
metadata usage and customization.

New Features

  • Multiple Artists in Albums and Songs: Navidrome now supports albums and tracks with multiple artists, allowing
    users to group tracks with different artists under a single album. This feature enhances the organization of
    compilation albums and multi-artist collaborations.

  • Contributors and Performers: Composer, conductor, and other contributors can now be added to tracks, providing
    detailed information about the creators and performers involved in the music production process.

  • Album Versions: Support for ALBUMVERSION tag has been added, enabling users to differentiate between standard
    releases, deluxe editions, remasters, and other versions of the same album. This feature enhances album categorization
    and provides a more comprehensive music library experience.

  • Multi-valued Tags: Support for multi-valued tags has been improved, allowing users to store multiple values for
    any single tag. This feature enhances metadata flexibility and enables more detailed categorization.

  • Custom Tags: Support for user-defined custom tags has been added, allowing enhanced metadata flexibility and
    personalized categorization. Learn more.

  • Smart Playlists Enhancements: Smart Playlists supports all newly added tags, including multiple artists,
    contributors, performers, and album versions, as well as custom tags. It also behaves better with multi-valued tags.
    Learn more.

  • Persistent IDs: Tracks and albums now use persistent IDs (PIDs), ensuring stability in playlists, favorites,
    and external integrations, even if your files move or are renamed. PIDs can also be configured to change the way
    Navidrome disambiguates albums and tracks. It is now also possible to group albums by folder,
    bay setting PID.Album="folder". Learn more.

  • Scanner Improvements: Optimized file scanning, with improved handling of file moves and retagging, "watcher" mode
    for real-time updates, resumable scans and enhanced performance during library updates.

  • Improved Handling of Missing Files: Enhanced mechanisms for managing missing files ensure better accuracy and
    easier troubleshooting. Learn more.

  • Beginner-Friendly Tagging Guidelines: A comprehensive tagging guide has been introduced to assist new users in
    properly tagging their music collections. Learn more.

New configuration options

  • PID.Album
  • PID.Track
  • Scanner.Enabled
  • Scanner.Schedule
  • Scanner.WatcherWait
  • Scanner.ScanOnStartup
  • Subsonic.AppendSubtitle
  • Subsonic.ArtistParticipations
  • Subsonic.DefaultReportRealPath
  • Subsonic.LegacyClients
  • Tags

Check the Config Options documentation to learn more.

Deprecated/Changed configuration options:

  • ScanSchedule was renamed to Scanner.Schedule
  • Scanner.Extractor was removed. ffmpeg extractor is not supported anymore and Navidrome will now always use TagLib for metadata extraction.
  • Scanner.GenreSeparators was removed. Use Tags.genre.Split instead. Check the Custom Tags documentation for more information.
  • Scanner.GroupAlbumReleases was removed. Use PID.Album instead.

Check the Configuration Options documentation for
more information.

Breaking Changes

  • Artist favourites and artist ratings will be lost after the upgrade.
  • Albums may move around (change grouping), as the default disambiguation logic is slightly different than the previous version. If you want to keep the same behaviour as before, add this line to your configuration before upgrading:
PID.Album = "album_legacy"

or as env var

ND_PID_ALBUM=album_legacy

Upgrade Instructions

  1. Backup Database: Before upgrading, create a backup of your current Navidrome database.
  2. Stop Navidrome: Ensure Navidrome is not running before proceeding.
  3. Replace Binary: Download and replace the existing Navidrome binary with the latest version (0.55.0).
    If using docker, pull the latest image.
  4. Start Navidrome: Restart Navidrome to automatically migrate the database schema. The upgrade process
    will trigger a full scan of your library, which may take some time depending on the size of your collection. While
    this full scan is in progress, please avoid using Navidrome, as the data will be unstable until the process finishes.
    Please don't report any bugs until this full scan is complete (check the logs)

For detailed discussions and comprehensive insights into this update, refer to
our Big Refactor announcement and the original BFR Pull Request

We appreciate your ongoing support and feedback. Make sure you read the linked new documentation pages and enjoy the
enhanced Navidrome experience!

Changelog

New Features

  • c795bcf: feat(bfr): Big Refactor: new scanner, lots of new fields and tags, improvements and DB schema changes (#2709) (@deluan)
  • 453873f: feat(insights): send scanner options (@deluan)
  • c37583f: feat(server): create M3Us from shares (#3652) (@deluan)
  • 21a5528: feat(server): deprecate Scanner.GroupAlbumReleases config option (@deluan)
  • 8ab2a11: feat(server): group Subsonic config options together (@deluan)
  • dc4e091: feat(server): make appending subtitle to song title configurable (@deluan)
  • 74348a3: feat(server): new option to set the default for ReportRealPath on new players (@deluan)
  • 637c909: feat(server): removed GenreSeparator, replaced with Tag.Genre.Split (@deluan)
  • de37e0f: feat(server): rename ScanSchedule conf to Scanner.Schedule, for consistency (@deluan)
  • f3cb85c: feat(server): warn users of ffmpeg extractor that it is not available anymore (@deluan)
  • 57d3be8: feat(subsonic): rename AppendSubtitle conf to Subsonic.AppendSubtitle, for consistency (@deluan)
  • 5869f7c: feat(subsonic): set sortName for OS AlbumList (#3776) (@kgarner7)
  • aee19e7: feat(ui): Improve Artist Album pagination (#3748) (@kgarner7)
  • f6eee65: feat(ui): Show performer subrole(s) where possible (#3747) (@kgarner7)
  • f34f15b: feat(ui): make need for refresh more visible when upgrading server (@deluan)
  • 31e003e: feat(ui): use webp for login backgrounds (@deluan)

Security updates

  • 09ae41a: sec(subsonic): authentication bypass in Subsonic API with non-existent username (@deluan)

Bug fixes

Build process updates

  • 4156602: build(ci): show English names for changed languages in POEditor PRs (@deluan)

Other work

Full Changelog: v0.54.4...v0.55.0

Helping out

This release is only possible thanks to the support of some awesome people!

Want to be one of them?
You can sponsor, pay me a Ko-fi, or contribute with code.

Where to go next?

Contributors

deluan, mstefarov, and 4 other contributors
Assets 27
Loading
0