nightly-4746d852-ls288

CI Report:

https://ci-tests.linuxserver.io/linuxserver/beets/nightly-4746d852-ls288/index.html

LinuxServer Changes:

Full Changelog: nightly-aa33b1cb-ls287...nightly-4746d852-ls288

Remote Changes:

core/structure: create a separate module for sorting in dbcore (#6644)

This PR moves all sorting-related classes from beets.dbcore.query into
a new dedicated module, beets.dbcore.sort. All references and imports
throughout the codebase and tests are updated to use the new module. No
functional changes are introduced - this is a mechanical refactor to
improve code organization and separation of concerns.

High-level impact:

• Sorting logic is now isolated in beets.dbcore.sort, making the
  architecture clearer.
• All code using sort classes (e.g., Sort, FixedFieldSort,
  MultipleSort, etc.) now imports them from beets.dbcore.sort instead
  of beets.dbcore.query.
• No changes to public APIs or behavior; only import paths and module
  boundaries are affected.

This change lays groundwork for future maintainability and makes the
codebase easier to navigate for contributors.

nightly-fc9c02a4-ls287

CI Report:

https://ci-tests.linuxserver.io/linuxserver/beets/nightly-fc9c02a4-ls287/index.html

LinuxServer Changes:

No changes

Remote Changes:

Fix command desc formatting in help (#6646)

No impact on core logic, only on CLI help output formatting.

This PR fixes the formatting of command descriptions in the CLI help
output.

• Command descriptions had historically been printed inline, however
  9352a79 introduced a bug which moved them to the next line, making the
  help output very verbose.
• Now, descriptions again appear inline with the command name (e.g.,
  config show or edit the user configuration), improving readability and
  consistency.
• A regression test (test_help) is included to verify the new output
  format and prevent future breakage.

High-level impact: CLI help output is more user-friendly, with no effect
on core logic or APIs.

Before

After

nightly-aa33b1cb-ls287

CI Report:

https://ci-tests.linuxserver.io/linuxserver/beets/nightly-aa33b1cb-ls287/index.html

LinuxServer Changes:

Full Changelog: nightly-44f7bf80-ls286...nightly-aa33b1cb-ls287

Remote Changes:

fix: duplicate album merge broken in threaded import mode (#6623)

Fixes #6601

Added import contextvars and changed _extend_pipeline to capture the
current context and run the inner pipeline within it to ensure the
music_dir context variable is available when the inner pipeline
resolves paths, preventing the relative-path bug that caused could not
get filesize errors and removing 0 old duplicated items during merge.

Works perfectly after the fix:

arsaboo@arsmusic:~$ beet import -m -I -t ~/shared/music/ --set genre="Filmi" --search-id 7MwKD3kEFMov4LQqyhnmzL

/home/arsaboo/shared/music (1 items)

  Match (75.2%):
  King - Lukkhe
  ≠ artist, tracks
  Spotify, None, 2026, None, Warner Music India, None, None
  https://open.spotify.com/album/7MwKD3kEFMov4LQqyhnmzL
  ≠ Artist: King; OAFF; Savera; Sunny M.R. -> King
  * Album: Lukkhe
     ≠ (#2) Khamoshiyaan (3:03) -> (#2) Khamoshiyaan (feat. Romy & Manreet Khara) (3:03)
Missing tracks (13/14 - 92.9%):
 ! Bulletproof (#1) (3:09)
 ! Jee Lenge (#3) (3:25)
 ! Headshot (#4) (3:10)
 ! Ruh Teri (feat. Manreet Khara & Agrim Joshi) (#5) (2:31)
 ! Roobaroo (#6) (3:17)
 ! Savere (#7) (2:29)
 ! Haal (#8) (3:29)
 ! Haal (The Journey) (#9) (6:13)
 ! Nachdi Shaam (#10) (2:22)
 ! Hoga Bada Mera Naam (#11) (1:58)
 ! All Eyes On Us (#12) (3:13)
 ! Swan Song (Hoya Azaad) (#13) (3:17)
 ! Bhaari Pangey (#14) (2:19)
➜ [A]pply, More candidates, Skip, Use as-is, as Tracks, Group albums,
Enter search, enter Id, aBort, eDit, edit Candidates, Print tracks,
Open files with Picard? a
This album is already in the library!
Old: 3 items, MP3, 320kbps, 9:45, 22.9 MiB
New: 1 items, MP3, 320kbps, 3:03, 7.8 MiB
➜ [S]kip new, Keep all, Remove old, Merge all? m

/home/arsaboo/shared/music
/data/music/Hindi Music/L/Lukkhe [30718] (2026)/Lukkhe (2026) - Bulletproof.mp3
/data/music/Hindi Music/L/Lukkhe [30718] (2026)/Lukkhe (2026) - Headshot.mp3
/data/music/Hindi Music/L/Lukkhe [30718] (2026)/Lukkhe (2026) - Jee Lenge.mp3 (4 items)

  Match (82.6%):
  King - Lukkhe
  ≠ artist, tracks
  Spotify, None, 2026, None, Warner Music India, None, None
  https://open.spotify.com/album/7MwKD3kEFMov4LQqyhnmzL
  ≠ Artist: OAFF; Savera; Ruaa Kayy; Romy; Manreet Khara -> King
  * Album: Lukkhe
     * (#1) Bulletproof (3:09)
     ≠ (#2) Khamoshiyaan (3:03) -> (#2) Khamoshiyaan (feat. Romy & Manreet Khara) (3:03)
     * (#3) Jee Lenge (3:25)
     * (#4) Headshot (3:10)
Missing tracks (10/14 - 71.4%):
 ! Ruh Teri (feat. Manreet Khara & Agrim Joshi) (#5) (2:31)
 ! Roobaroo (#6) (3:17)
 ! Savere (#7) (2:29)
 ! Haal (#8) (3:29)
 ! Haal (The Journey) (#9) (6:13)
 ! Nachdi Shaam (#10) (2:22)
 ! Hoga Bada Mera Naam (#11) (1:58)
 ! All Eyes On Us (#12) (3:13)
 ! Swan Song (Hoya Azaad) (#13) (3:17)
 ! Bhaari Pangey (#14) (2:19)
➜ [A]pply, More candidates, Skip, Use as-is, as Tracks, Group albums,
Enter search, enter Id, aBort, eDit, edit Candidates, Print tracks,
Open files with Picard? a

nightly-d741a464-ls286

CI Report:

https://ci-tests.linuxserver.io/linuxserver/beets/nightly-d741a464-ls286/index.html

LinuxServer Changes:

Full Changelog: nightly-5df37abc-ls285...nightly-d741a464-ls286

Remote Changes:

core/structure: move UserError to beets.exceptions (#6643)

Update all references in core, plugins, and tests to import UserError
from the new location. This centralizes exception handling and improves
code organization.

nightly-44f7bf80-ls286

CI Report:

https://ci-tests.linuxserver.io/linuxserver/beets/nightly-44f7bf80-ls286/index.html

LinuxServer Changes:

No changes

Remote Changes:

Fix path format queries for multi-valued fields (#6635)

Fixes #6598.

the issue was that path format queries are evaluated against an
in-memory Item using query.match(), where multi-valued fields such as
genres are represented as lists, e.g. ["Classical"]. Before this change,
string/exact matching treated that list as one whole value, so a path
rule like genres:=~Classical: _Classical/... failed to match and fell
back to the default path format, even though beet list
genres:=~Classical worked through the database query path. This change
updates in-memory matching so sequence-like field values are matched
element by element, while excluding strings and byte-like values from
sequence handling. I added regression tests for genres:=~Classical,
genres:=Classical, avoiding a false positive for Neoclassical, and
direct query.match() behavior on multi-valued fields. Manual
verification showed the original version returned match: False and
destination: ...\one\two, while the fixed version returns match: True
and destination: ...\one\three.

Summary

This fixes path format selection for multi-valued fields such as
genres.

Path format queries are evaluated against an in-memory Item via
query.match().
For multi-valued fields, the in-memory value is a list, for example:

genres = ["Classical"]

2.11.0-ls331

CI Report:

https://ci-tests.linuxserver.io/linuxserver/beets/2.11.0-ls331/index.html

LinuxServer Changes:

Full Changelog: 2.11.0-ls330...2.11.0-ls331

Remote Changes:

Updating PIP version of beets to 2.11.0

nightly-5df37abc-ls285

CI Report:

https://ci-tests.linuxserver.io/linuxserver/beets/nightly-5df37abc-ls285/index.html

LinuxServer Changes:

Full Changelog: nightly-5df37abc-ls284...nightly-5df37abc-ls285

Remote Changes:

Update deps (#6632)

We have a vulnerability in urllib3 so here's an upgrade to all deps.

Fixes #6633

nightly-5df37abc-ls284

CI Report:

https://ci-tests.linuxserver.io/linuxserver/beets/nightly-5df37abc-ls284/index.html

LinuxServer Changes:

Full Changelog: nightly-03090964-ls283...nightly-5df37abc-ls284

Remote Changes:

Update deps (#6632)

We have a vulnerability in urllib3 so here's an upgrade to all deps.

Fixes #6633

nightly-544d45a1-ls283

CI Report:

https://ci-tests.linuxserver.io/linuxserver/beets/nightly-544d45a1-ls283/index.html

LinuxServer Changes:

No changes

Remote Changes:

fix(mbsync): do not clear metadata if import.from_scratch is set (#6625)

if import.from_scratch was set in the config, runnning mbsync would
clear any metadata not provided by MBz (replay gain, lyrics, genres...).
we now ignore this setting when running mbsync to preserve metadata.

Fixes: #6613

nightly-03090964-ls283

CI Report:

https://ci-tests.linuxserver.io/linuxserver/beets/nightly-03090964-ls283/index.html

LinuxServer Changes:

Full Changelog: nightly-7c50f94c-ls282...nightly-03090964-ls283

Remote Changes:

fix(duplicates): output format (#6622)

• The pugin used an empty format string unless --count was provided,
  resulting in outputs like : 1. It now correctly displays duplicated
  items.
• --count was ignored (aside from above bug), and item count was
  always appended to output.

Fixes: beetbox/beets#6476