The NetBSD Project

CVS log for pkgsrc/audio/py-beets/PLIST

[BACK] Up to [cvs.NetBSD.org] / pkgsrc / audio / py-beets

Request diff between arbitrary revisions


Keyword substitution: kv
Default branch: MAIN


Revision 1.35: download - view: text, markup, annotated - select for diffs
Tue Sep 8 05:41:37 2026 UTC (2 months, 1 week ago) by adam
Branches: MAIN
CVS tags: pkgsrc-2026Q3-base, pkgsrc-2026Q3, HEAD
Diff to: previous 1.34: preferred, colored
Changes since revision 1.34: +7 -7 lines
py-beets: updated to 2.14.0

2.14.0 (September 07, 2026)

New features

- :doc:`plugins/plexupdate`: Add ``beet plexupdate --auth``, an interactive
  plex.tv login following Plex' traditional PIN authentication flow: the access
  token for the local server is stored in a token file. The manual ``token``
  configuration option is now deprecated.
- :ref:`duplicate_action`: Add an ``upgrade`` option that replaces individual
  duplicate tracks only if the new copy has a higher bitrate, adds any genuinely
  new tracks, and keeps the album together rather than splitting it. The option
  is available both through configuration and from the interactive duplicate
  prompt.
- The interactive import prompt now offers a "Rescan directory" choice for album
  tasks. It re-reads the album's directory from disk and re-runs the match, so
  files can be cleaned up (duplicates, junk) while the import is paused at the
  prompt, without restarting the whole ``beet import`` run.
- :ref:`list-cmd` Add ``-l / --limit LIMIT`` flag to the ``list`` command to
  limit query results.

Bug fixes

- Add ``editor`` config option to allow users to permanently set their preferred
  editor, overriding ``$VISUAL`` and ``$EDITOR`` environment variables.
- ``beet update`` no longer crashes when a plugin-added media field is stored as
  a flexible attribute.
- A date range query written back to front (for example ``added:2024..2020``) no
  longer crashes with an uncaught ``ValueError``. The endpoints are now swapped,
  so such a range means the same as ``added:2020..2024``.
- Deduplicating a file whose name already ends in a counter of two or more
  digits no longer restarts the numbering: ``track.10.mp3`` now yields
  ``track.11.mp3`` instead of ``track.1.mp3``. The counter was matched with
  ``\.(\d)+$``, which captures only the final digit.
- Autotagging distance calculations no longer treat ordinary words containing
  "ft" (such as "draft", "left", "gift", "craft") as a "featuring artist"
  suffix, which was silently making genuinely different titles/artists score as
  near-identical matches.
- :doc:`plugins/lyrics`: ``beet lyrics`` no longer crashes with an
  ``AttributeError`` on tracks that have no stored lyrics when ``force`` is
  enabled; a missing lyrics body is now treated as empty text.
- :doc:`plugins/deezer`: Detect compilations that Deezer credits to a single
  "main" artist instead of "Various Artists", so they are tagged as such rather
  than getting every track artist in the album artist field.
- Flexible attributes whose names contain uppercase characters (for example
  ``beet import --set Tag_With_Uppercase=true``) can now be found by queries.
  Field names are lowercased when a query is parsed, so such attributes could
  never be matched; flexible attribute lookups now fall back to a
  case-insensitive key match.
- :doc:`plugins/deezer`: Singleton searches now use plain free text rather than
  ``<title> artist:"<artist>"``. Deezer discards unquoted free text as soon as a
  query contains any ``field:"value"`` filter, so the old query was evaluated as
  ``artist:"<artist>"`` alone -- every track by the artist, in Deezer's own
  relevance order and truncated to ``search_limit``. For artists with more
  releases than that window, the track being imported was never among the
  candidates offered.
- :doc:`plugins/tidal`: The ``label`` field no longer stores Tidal's raw
  copyright/rights-statement text verbatim. It's now normalized to a concise
  label name, stripping copyright markers, years, and corporate, licensing, and
  territorial boilerplate. Affects both album and track metadata.
- :doc:`plugins/deezer`: Track conversion no longer assumes the API sends both
  ``contributors`` and ``artist``. The fallback to ``artist`` was evaluated even
  when ``contributors`` was present, so a track payload without ``artist``
  raised ``KeyError``. Albums were already guarded; this fixes the remaining
  call site.
- :doc:`plugins/discogs`: Retry a search once when Discogs returns an invalid
  JSON response instead of immediately discarding all Discogs candidates.
- Plugins built on ``SearchApiMetadataSourcePlugin``
  (:doc:`plugins/musicbrainz`, :doc:`plugins/spotify`, :doc:`plugins/deezer` and
  :doc:`plugins/discogs`) no longer send a search request when both the query
  text and the filters are empty.
- :doc:`plugins/ipfs`: Fix ``beet ipfs --play`` option to invoke the Play plugin
  through its command interface.
- :doc:`plugins/lyrics`: LRCLib entries that carry no lyrics text at all, with
  both ``plainLyrics`` and ``syncedLyrics`` null while ``instrumental`` is
  ``False``, are no longer considered matches. Previously such an entry was
  accepted and its null text propagated, raising ``AttributeError: 'NoneType'
  object has no attribute 'splitlines'``. During an import this aborted the
  whole run rather than a single track. A null ``plainLyrics`` now also falls
  back to the synced lyrics instead of discarding them.
- :ref:`modify-cmd`: Fix applying changes when choosing objects in interactive
  select mode.
- :ref:`move-cmd`: Fix moving albums in interactive select/timid mode.
- :doc:`plugins/bpd`: Fix ``search`` command when ``any`` field is used.
- :doc:`plugins/aura`: Prevent multi-valued field filters from crashing with an
  ``sqlite3.InterfaceError``.
- :doc:`plugins/aura`: When sorting by ``field``, do not exclude resources that
  have no value for ``field``.
- :doc:`plugins/scrub`: The scrub plugin now respects the ``--nowrite`` (``-W``)
  flag during import. Previously, ``beet import -W`` with the scrub plugin
  enabled would still remove tags from imported files; the plugin now skips
  scrubbing when ``should_write()`` returns ``False``.
- :doc:`plugins/convert`: Fixed convert plugin not taking into account the new
  format when determining the target path.
- :doc:`plugins/edit`: Item-only fields rejected from the album header remain
  available in per-track documents during interactive import when they are also
  configured in ``itemfields``.
- :doc:`plugins/tidal`: Pass the converted track duration as ``length`` so it
  contributes to the autotagging track-length distance instead of being silently
  stored as a ``duration`` flexible attribute.
- :doc:`plugins/tidal`: Restore catalog searches after TIDAL moved search
  queries from the request path to the required ``filter[query]`` parameter.
- :ref:`import-cmd`: Restore the ability to import from tar and 7z archives.
  Both failed with an ``'... object has no attribute 'infolist'`` error because
  ``tarfile.TarFile`` lost its ``ZipFileCompat`` interface in Python 3 and
  ``py7zr.SevenZipFile`` exposes ``list()`` rather than ``infolist()``.
- :doc:`plugins/listenbrainz` and :doc:`plugins/lastimport`: Play counts are now
  matched more accurately. An exact MusicBrainz recording ID match is preferred
  when one exists, and titles are matched exactly (confirmed by the artist or
  album) before falling back to the previous substring-based matching.
  Previously all queries were combined, so a listen for "Song" also updated
  "Song (inst.)" or any other item whose title only contained the listened
  title.
- :doc:`plugins/limit` Deprecate the ``limit`` plugin in favor of the new ``-l``
  / ``--limit`` flag for the :ref:`list-cmd` command.

Revision 1.34: download - view: text, markup, annotated - select for diffs
Mon Aug 3 17:48:45 2026 UTC (3 months, 1 week ago) by wiz
Branches: MAIN
Diff to: previous 1.33: preferred, colored
Changes since revision 1.33: +4 -0 lines
py-beets: update to 2.13.1.

2.13.1

Bug fixes

    Fixed source distributions not including the bundled man pages. πŸ› (#6882)

2.13.0

New features

    Convert Plugin: Add new configuration option convert.refresh and command-line option --refresh, allowing to force Convert Plugin operation when original file is newer than existing converted file.
    Edit Plugin: The interactive import editor now shows album-level fields (as configured by albumfields) as a YAML header section when editing an album import. Fields that appear in both itemfields and albumfields are shown only in the header, not per-track.
    FetchArt Plugin: Add fetch_for_asis setting that enables fetching album art from online sources even when imported files are not modified by the auto-tagger. Default is no which means FetchArt Plugin looks for art only in the local filesystem when the user (or quiet_fallback) chooses asis.
    FtInTitle Plugin: Apply featured-artist rewriting to fetched metadata before commands such as MBSync Plugin use it. πŸ› (#1153)
    LastGenre Plugin: Add support for normalizing genre spellings and naming variants with a new configuration option aliases. The feature is enabled by default and ships with a built-in list of regex patterns. These patterns can be replaced via the user's configuration. The default whitelist and genre tree were audited against the top 1,000 Last.fm tags: canonical names are now consistent across both files, long-standing mismatches between them have been resolved, and entries align with the built-in alias patterns. πŸ› (#6466)
    Lyrics Plugin: Add lrcmux backend, which aggregates lyrics from various other sources.
    Lyrics Plugin: Added a --no-keep-synced command option to override keep_synced: yes for a single manual lyrics fetch.
    Lyrics Plugin: Added a rest_directory configuration option for specifying a reStructuredText output directory, semantically equivalent to -r, --write-rest. πŸ› (#2806)
    modify command: Support += and -= operators to add or remove individual values from multi-valued fields without replacing the whole field. πŸ› (#6587)
    ReplayGain Plugin: Add a metaflac backend that computes ReplayGain for FLAC files using the metaflac command-line tool. πŸ› (#1203)
    Spotify Plugin: Recognize native Spotify URIs (e.g. spotify:album:<id> and spotify:track:<id>) when extracting release/track IDs, in addition to full open.spotify.com URLs and bare IDs
    Tidal Plugin: Add cover art support. Album metadata now includes cover_art_url from Tidal's coverArt relationship, which the FetchArt Plugin plugin can retrieve.
    A database backup is now automatically created before running schema migrations. Control with the create_backup_before_migrations option (default: yes).

Bug fixes

    Convert Plugin: convert -a with copy_album_art enabled no longer crashes when the stored album art path points to a missing file (for example a multi-disc album whose cover lives in the album root rather than a per-disc directory); the missing art is skipped instead. πŸ› (#4692)
    Edit Plugin: Preserve missing album art paths when editing album metadata, instead of turning artpath: null into a path ending in None. πŸ› (#2438)
    ImportFeeds Plugin: import command no longer aborts the whole run when a symlink cannot be created (e.g. on Windows or a read-only directory); the failure is logged and the import continues. πŸ› (#840)
    Lyrics Plugin: Leave lyrics empty when a source reports an instrumental track, and store that state in lyrics_instrumental flexible attribute. Existing [Instrumental] lyrics are migrated automatically. πŸ› (#6719)
    Missing Plugin: Honor the -f/--format option (and the format_album configuration) when listing missing albums in album mode. πŸ› (#3804)
    Smart Playlist Plugin: splupdate no longer crashes with TypeError: unhashable type: 'list' when a playlist configuration includes a playlist: query. πŸ› (#5354)
    SubsonicUpdate Plugin: Log a clearer error when the Subsonic server returns a non-JSON response. πŸ› (#5635)
    Tidal Plugin: Normalize Tidal album types to lowercase.
    A date query containing a stray | (for example added:2000|2001, as might be typed by a user expecting | to mean "or") now raises a clean "a valid date/time string" error instead of crashing with an uncaught KeyError. A | was being accepted as a relative-date unit due to a regular expression character-class typo.
    Album store no longer copies artpath onto its items as an absolute path, which broke relative-path portability. A database migration removes any such stale artpath attributes left on items by earlier versions. πŸ› (#6756)
    Sorting by a nullable field (for example a flexible attribute with a declared type whose null value is None) that is present on only some items no longer crashes with a TypeError. Missing values are now grouped together, ordered before present ones when sorting ascending and after them when descending. πŸ› (#3461)

Other changes

    Contributing: The project now uses uv for packaging, virtual environment, and dependency management, replacing poetry. The build backend has changed from poetry-core to hatchling. Please see updates in Development Tools and Getting the Source for more information. πŸ› (#5783)
    Installation Add Homebrew to the list of supported package managers in the installation guide.
    Installation: Note that Windows users should run beets in a terminal emulator (such as Windows Terminal or cmder) for output to display correctly. πŸ› (#2848)
    Installation: Switch isolated tool installation guidance and GitHub workflow setup to uv tool commands.
    LastGenre Plugin: Add a new "Choosing the Right Tool" documentation section to guide users in picking the right approach across genre fetching, filtering, and normalization.
    Spotify Plugin: Retry on 503 Service Unavailable responses from the Spotify API instead of immediately aborting, matching the existing 429 rate-limit retry behavior.

Revision 1.33: download - view: text, markup, annotated - select for diffs
Mon Jun 29 06:28:10 2026 UTC (4 months, 2 weeks ago) by wiz
Branches: MAIN
Diff to: previous 1.32: preferred, colored
Changes since revision 1.32: +13 -0 lines
py-beets: fix PLIST for update

While here, clean up and simplify Makefile.

Revision 1.32: download - view: text, markup, annotated - select for diffs
Sun May 10 12:21:47 2026 UTC (6 months, 1 week ago) by wiz
Branches: MAIN
CVS tags: pkgsrc-2026Q2-base, pkgsrc-2026Q2
Diff to: previous 1.31: preferred, colored
Changes since revision 1.31: +13 -1 lines
py-beets: update to 2.11.0.

Release v2.11.0

New features

    Smart Playlist Plugin: The splupdate command output is restructured. The per-playlist summary now includes a track count. Per-track details are shown only when -v flag is provided (beet -v splupdate). The --pretend flag produces the same output but reports "N playlists would be updated" instead of "N playlists updated". The --format option allows customizing the track line format. The --pretend-paths option was removed (use --format='$path' instead). πŸ› (#6183)

    import command: When importing an archive (zip, tar, rar, or 7z) with move: yes, the source archive is now removed after a successful import. Archives are preserved if any file in the archive was not imported (e.g. skipped as a duplicate, or the import was aborted), and in non-move import modes.

    FromFilename Plugin: Support track prefix when parsing the track number from the filename (e.g., track01.m4a).

    Tidal plugin: Introduces a new plugin for fetching metadata from Tidal. It supports album and track lookups by ID, including batch operations via albums_for_ids and tracks_for_ids. It also enables search by query as well as identifier-based retrieval, with support for ISRC codes (tracks) and barcode/EANs (albums).

    This is an initial, relatively minimal implementation, but already fully usable for common metadata workflows. We welcome feedback, improvement ideas, and community contributions to further extend its capabilities.

    See Tidal Plugin for more information.

    Add support for adding or modifying a subtitle (ID3 tag TIT3) field

Bug fixes

    Bad Files Plugin: Respect quiet mode (the --quiet flag or import.quiet: yes config) during import so the corrupt-file prompt is suppressed in non-interactive imports. πŸ› (#4736)
    Discogs Plugin: Prevent duplicate featured artists in track artist fields when the same artist is credited both in artists (for example with Feat. join text) and extraartists as Featuring. πŸ› (#6166)
    import command: Fix duplicate album art files (e.g. cover.2.jpg) being created when re-importing albums with the FetchArt Plugin plugin enabled. Old album art is now properly removed when replacing duplicate albums during import. πŸ› (#1264) πŸ› (#6205)
    import command: Metadata source plugin ID lookups now correctly call each plugin's own lookup method when running in parallel. πŸ› (#6583)
    import command: Multi-disc album detection now recognizes cassette, digital media, and vinyl as disc markers (e.g. vinyl 1, 12 vinyl 2), in addition to the existing disc, disk, and cd markers.
    import command: Tags with a zero distance penalty are no longer shown as differences in the match display. Previously, custom distance_weights could cause fields with no actual mismatch to appear in the β‰  line.
    import command: With original_date: yes, album-level year, month, and day now use the original release date. πŸ› (#6577)
    Lyrics Plugin: Fix apostrophe handling in the musixmatch backend slug. πŸ› (#4759)
    MusicBrainz Plugin: Correctly handle release dates where leading or intermediate components are missing, e.g. 2008-??-02
    Improve DBAccessError messages to help users diagnose database permission issues more easily. The error message now mentions directory missing and file permissions as potential causes. πŸ› (#1676)
    Library path migration now also handles manually edited database rows where item or album-art paths were stored as SQLite TEXT values instead of bytes, so upgrading to the portable-path storage format no longer fails for those libraries. πŸ› (#6561)

Other changes

    Spotify Plugin: Batch spotifysync track and audio-features API requests and deduplicate repeated Spotify track IDs within a run.

Revision 1.31: download - view: text, markup, annotated - select for diffs
Wed Apr 22 08:08:37 2026 UTC (6 months, 3 weeks ago) by adam
Branches: MAIN
Diff to: previous 1.30: preferred, colored
Changes since revision 1.30: +10 -1 lines
py-beets: updated to 2.10.0

2.10.0 (April 19, 2026)

New features

- **Beets library is now made portable**: item and album-art paths are now
  stored relative to the library root in the database while remaining absolute
  in the rest of beets. Path queries continue matching both library-relative
  paths and absolute paths under the currently configured music directory under
  the new storage model. The existing paths in the database are migrated
  automatically the first time you run any ``beet`` command after the update.
  :bug:`133`

  .. warning::

      make sure you run ``beet version`` (or any other command) at least once
      after upgrading to trigger the migration. Only then you can safely move
      the library to a new location.

- :doc:`plugins/inline`: Add access to the ``album`` or ``item`` object as
  ``db_obj`` in inline fields.
- :doc:`plugins/discogs`: Import Discogs remixer, lyricist, composer, and
  arranger credits into the multi-value ``remixers``, ``lyricists``,
  ``composers``, and ``arrangers`` fields. :bug:`6380`
- :doc:`plugins/lyrics`: Add ``keep_synced`` config option and ``--keep-synced``
  CLI flag to skip re-fetching lyrics for tracks that already have synced
  lyrics, even when ``force`` is enabled. :bug:`5249`
- :doc:`plugins/musicbrainz`: Use aliases for artist credit.
- Metadata source plugin searches and lookups are now executed concurrently,
  speeding up lookups when multiple plugins (e.g. MusicBrainz and Spotify) are
  enabled.

Bug fixes

- :ref:`import-cmd` Automatically remux WAV files containing MP3 streams
  (``WAVE_FORMAT_MPEGLAYER3``) to proper MP3 files during import, instead of
  silently importing them with incorrect metadata. :bug:`6455`
- :doc:`plugins/listenbrainz`: Retry listenbrainz requests for temporary
  failures.
- :doc:`plugins/chroma`: Do not produce MusicBrainz-sourced autotagger
  candidates when the :doc:`plugins/musicbrainz` plugin is not enabled. The
  chroma plugin now looks up the musicbrainz plugin through the metadata-source
  registry instead of unconditionally instantiating its own private instance,
  which also restores compatibility with :doc:`plugins/mbpseudo` for
  chroma-triggered lookups. :bug:`6212` :bug:`6441`
- :ref:`import-cmd` Remove clutter from imported album folders. :bug:`5016`
- :doc:`plugins/web`: Fix a stored XSS vulnerability where unescaped metadata
  fields (artist, album, title, comments, lyrics) could execute arbitrary
  JavaScript in the browser. Template tags now use ``<%-`` (escaped
  interpolation) instead of ``<%=`` (raw interpolation).

Revision 1.30: download - view: text, markup, annotated - select for diffs
Wed Apr 15 10:53:40 2026 UTC (7 months ago) by adam
Branches: MAIN
Diff to: previous 1.29: preferred, colored
Changes since revision 1.29: +10 -1 lines
py-beets: updated to 2.9.0

2.9.0 (April 11, 2026)

Beets now officially supports Python 3.14.

New features

- :ref:`import-cmd` Use ffprobe to recognize format of any import music file
  that has no extension. If the file cannot be recognized as a music file, leave
  it alone. :bug:`4881`
- Query: Add ``has_cover_art`` computed field to query items by embedded cover
  art presence. Users can now search for tracks with or without embedded artwork
  using ``beet list has_cover_art:true`` or ``beet list has_cover_art:false``.
- :doc:`plugins/autobpm`: Add ``force`` configuration and CLI option and
  deprecate ``overwrite``.
- :doc:`plugins/autobpm`: The "BPM already exists for item" log message can now
  be hidden with the ``--quiet`` flag.
- :doc:`plugins/smartplaylist`: The list of available playlists shown when an
  unknown playlist name is passed as an argument is now sorted alphabetically
  and printed space-delimited and POSIX shell-quoted when required. This makes
  it easier to copy and paste multiple playlists for further use in the shell.
- :doc:`plugins/chroma`: Add new command ``chromasearch`` to search the local
  library by chromaprint fingerprint.
- Store track remixers, lyricists, composers, and arrangers in the multi-valued
  ``remixers``, ``lyricists``, ``composers``, and ``arrangers`` fields instead
  of the legacy single-value ``remixer``, ``lyricist``, ``composer``, and
  ``arranger`` fields. Existing libraries are migrated automatically, and
  :doc:`plugins/musicbrainz` now preserves each MusicBrainz ``remixer``,
  ``lyricist``, ``composer``, and ``arranger`` relation as a separate value.
- :doc:`plugins/musicbrainz`: Store MBIDs for remixers, lyricists, composers,
  and arrangers in the new multi-valued fields ``remixers_mbid``,
  ``lyricists_mbid``, ``composers_mbid``, and ``arrangers_mbid``. :bug:`5698`
- :doc:`plugins/replaygain`: Conflicting replay gain tags are now removed on
  write. RG_* tags are removed when setting R128_* and vice versa.
- :doc:`plugins/fetchart`: Add support for WebP images.
- :doc:`plugins/lastgenre`: Add support for a user-configurable ignorelist to
  exclude unwanted or incorrect Last.fm (or existing) genres, either per artist
  or globally :bug:`6449`

Bug fixes

- :doc:`plugins/deezer`: Fix Various Artists albums being tagged with a
  localized string instead of the configured ``va_name``. Detection now uses
  Deezer's artist ID rather than the artist name string. :bug:`4956`
- :doc:`plugins/listenbrainz`: Paginate through all ListenBrainz listens instead
  of fetching only 25, aggregate individual listen events into correct play
  counts, use ``recording_mbid`` from the ListenBrainz mapping when available,
  and avoid per-listen MusicBrainz API lookups that caused imports to hang on
  large listen histories. :bug:`6469`
- Correctly handle semicolon-delimited genre values from externally-tagged
  files. :bug:`6450`
- :doc:`plugins/listenbrainz`: Fix ``lbimport`` crashing when ListenBrainz
  tracks are processed through Last.fm-specific play-count import logic.
  Play-count imports now use source-specific fields so
  :doc:`plugins/listenbrainz`, :doc:`plugins/lastimport`, and
  :doc:`plugins/mpdstats` do not clash. :bug:`6469`
- :ref:`import-cmd` Fix ``albumartists_sort`` (and related fields) incorrectly
  prepending the full combined artist credit as the first element for
  multi-artist releases. :bug:`6470`
- :doc:`plugins/discogs`: Store specific Discogs styles in beets ``genres`` and
  broader Discogs genres in the ``style`` field. When
  :conf:`plugins.discogs:append_style_genre` is enabled, the broader Discogs
  genres are also appended to the ``genres`` list. :bug:`6390`
- :doc:`plugins/deezer`: Fix a regression in 2.8.0 where selecting a Deezer
  match during import could crash with ``AttributeError: 'AlbumInfo' object has
  no attribute 'raw_data'`` when Deezer returned numeric artist IDs. :bug:`6503`
- :ref:`modify-cmd` accepts legacy singular field names such as ``genre``,
  ``composer``, ``lyricist``, ``remixer``, and ``arranger`` in assignments,
  rewrites them to the corresponding multi-valued fields, and warns users to
  switch to the plural field names. :ref:`list-cmd`, and query expressions,
  accept the same legacy singular field names and warn users to switch to the
  plural field names. :bug:`6483`
- :doc:`plugins/fetchart`: Error when a configured source does not exist or
  sources configuration is empty. :bug:`6336`
- :doc:`plugins/rewrite` :doc:`plugins/advancedrewrite`: Fix rewriting
  multi-valued fields such as ``genres`` by applying rules to each matching list
  entry. Additionally, apply rewrite rules in config order, so that multiple
  rules can be applied to the same field. :bug:`6515`

Revision 1.29: download - view: text, markup, annotated - select for diffs
Sun Mar 29 17:39:58 2026 UTC (7 months, 2 weeks ago) by wiz
Branches: MAIN
Diff to: previous 1.28: preferred, colored
Changes since revision 1.28: +12 -0 lines
py-beets: update to 2.8.0.

2.8.0 (March 28, 2026)
----------------------

New features
~~~~~~~~~~~~

- :doc:`plugins/discogs`: Add :conf:`plugins.discogs:extra_tags` option to use
  additional tags (such as ``barcode``, ``catalognum``, ``country``, ``label``,
  ``media``, and ``year``) in Discogs search queries.
- :doc:`plugins/smartplaylist`: Add new configuration option ``dest_regen`` to
  regenerate items' path in the generated playlist instead of using those in the
  library. This is useful when items have been imported in don't copy-move (``-C
  -M``) mode in the library but are later passed through the ``convert`` plugin
  which will regenerate new paths according to the Beets path format.
- :doc:`plugins/missing`: When running in missing album mode, allows users to
  specify MusicBrainz release types to show using the ``--release-type`` flag.
  The default behavior is also changed to just show releases of type ``album``.
  :bug:`2661`
- :doc:`plugins/play`: Added ``-R``/``--randomize`` flag to shuffle the playlist
  order before passing it to the player.
- :doc:`plugins/lyrics`: Add ``auto_ignore`` configuration option to skip
  fetching lyrics for items matching a beets query during auto import.

Bug fixes
~~~~~~~~~

- :doc:`plugins/missing`: Fix ``--album`` mode incorrectly reporting albums
  already in the library as missing. The comparison now correctly uses
  ``mb_releasegroupid``.
- :ref:`replace`: Made ``drive_sep_replace`` regex logic more precise to prevent
  edge-case mismatches (e.g., a song titled "1:00 AM" would incorrectly be
  considered a Windows drive path).
- :doc:`plugins/fish`: Fix AttributeError. :bug:`6340`
- :ref:`import-cmd` Autotagging by explicit release or recording IDs now keeps
  candidates from all enabled metadata sources instead of dropping matches when
  different providers share the same ID. :bug:`6178` :bug:`6181`
- :doc:`plugins/mbsync` and :doc:`plugins/missing` now use each item's stored
  ``data_source`` for ID lookups, with a fallback to ``MusicBrainz``.
- :doc:`plugins/musicbrainz`: Use ``va_name`` config for ``albumartist_sort``,
  ``albumartists_sort``, ``albumartist_credit``, ``albumartists_credit``, and
  ``albumartists`` on VA releases instead of hardcoded "Various Artists".
  :bug:`6316`
- :doc:`plugins/beatport`: Use ``va_name`` config for the album artist on VA
  releases instead of hardcoded "Various Artists". :bug:`6316`
- :ref:`config-cmd` on Windows now uses ``cmd /c start ""`` for the default
  editor fallback so ``beet config -e`` works when ``VISUAL`` and ``EDITOR`` are
  unset. :bug:`6436`
- :doc:`plugins/lastimport`: Rename flexible field ``play_count`` to
  ``lastfm_play_count`` to avoid conflicts with :doc:`plugins/mpdstats`.
  **Migration**: This cannot be migrated automatically because of the field
  clash. If you use ``lastimport`` without ``mpdstats``, migrate manually with
  ``beet modify lastfm_play_count='$play_count'``.
- :ref:`import-cmd` Simplify autotag metadata application for albums and
  singletons, fixing null-overwrite handling and keeping singular/plural artist
  metadata fields in sync during tagging.

For plugin developers
~~~~~~~~~~~~~~~~~~~~~

- :py:func:`beets.metadata_plugins.album_for_id` and
  :py:func:`beets.metadata_plugins.track_for_id` now require a ``data_source``
  argument and query only that provider.
- Colorisation, diff and layout utility helpers previously imported from
  :mod:`beets.ui` now live in :mod:`beets.util.color`, :mod:`beets.util.diff`,
  and :mod:`beets.util.layout`. Update external imports accordingly.
- The lastgenre ``tunelog`` helper was generalized into
  :py:meth:`beets.logging.BeetsLogger.extra_debug`, which emits ``DEBUG``
  messages only at verbosity level 3 or higher (for example ``-vvv``). Plugin
  authors can use it via ``self._log.extra_debug(...)``.

Other changes
~~~~~~~~~~~~~

- Deprecate the :doc:`plugins/beatport` and :doc:`plugins/bpsync` plugins.
  Beatport has retired the API these plugins rely on, making them
  non-functional. :bug:`3862`
- API-backed metadata source plugins can now use
  :py:class:`~beets.metadata_plugins.SearchApiMetadataSourcePlugin` for shared
  search orchestration. Implement provider behavior in
  :py:meth:`~beets.metadata_plugins.SearchApiMetadataSourcePlugin.get_search_query_with_filters`
  and
  :py:meth:`~beets.metadata_plugins.SearchApiMetadataSourcePlugin.get_search_response`.
- :doc:`guides/installation`: Remove redundant macOS section from the
  installation guide. :bug:`5993`
- :doc:`guides/installation`: Update installation guide to document plugin
  management with pipx and move package manager instructions to the FAQ.
- :doc:`guides/main`: Update quick installation section to reflect current
  installation guide structure.
- :doc:`guides/installation`: Update pipx installation guide link
- :doc:`contributing`: Update pipx installation guide link

Revision 1.28: download - view: text, markup, annotated - select for diffs
Mon Mar 9 16:52:24 2026 UTC (8 months, 1 week ago) by wiz
Branches: MAIN
CVS tags: pkgsrc-2026Q1-base, pkgsrc-2026Q1
Diff to: previous 1.27: preferred, colored
Changes since revision 1.27: +6 -0 lines
py-beets: update to 2.7.1.

2.7.1

Tests that depend on the optional langdetect package are now skipped when the package is not installed. πŸ› (#6421)

Revision 1.27: download - view: text, markup, annotated - select for diffs
Mon Feb 9 12:44:18 2026 UTC (9 months ago) by wiz
Branches: MAIN
Diff to: previous 1.26: preferred, colored
Changes since revision 1.26: +79 -13 lines
py-beets: update to 2.6.1.

2.6.1 (February 02, 2026)
-------------------------

Bug fixes:

- Make ``packaging`` a required dependency. :bug:`6332`

2.6.0 (February 01, 2026)
-------------------------

Beets now requires Python 3.10 or later since support for EOL Python 3.9 has
been dropped.

New features:

- :doc:`plugins/fetchart`: Added config setting for a fallback cover art image.
- :doc:`plugins/ftintitle`: Added argument for custom feat. words in ftintitle.
- :doc:`plugins/ftintitle`: Added album template value ``album_artist_no_feat``.
- :doc:`plugins/musicbrainz`: Allow selecting tags or genres to populate the
  genres tag.
- :doc:`plugins/ftintitle`: Added argument to skip the processing of artist and
  album artist are the same in ftintitle.
- :doc:`plugins/play`: Added `$playlist` marker to precisely edit the playlist
  filepath into the command calling the player program.
- :doc:`plugins/lastgenre`: For tuning plugin settings ``-vvv`` can be passed to
  receive extra verbose logging around last.fm results and how they are
  resolved. The ``extended_debug`` config setting and ``--debug`` option have
  been removed.
- :doc:`plugins/importsource`: Added new plugin that tracks original import
  paths and optionally suggests removing source files when items are removed
  from the library.
- :doc:`plugins/mbpseudo`: Add a new `mbpseudo` plugin to proactively receive
  MusicBrainz pseudo-releases as recommendations during import.
- Added support for Python 3.13.
- :doc:`/plugins/convert`: ``force`` can be passed to override checks like
  no_convert, never_convert_lossy_files, same format, and max_bitrate
- :doc:`plugins/titlecase`: Add the `titlecase` plugin to allow users to resolve
  differences in metadata source styles.
- :doc:`plugins/spotify`: Added support for multi-artist albums and tracks,
  saving all contributing artists to the respective fields.
- :doc:`plugins/fetchart`: Fix colorized output text.
- :doc:`plugins/ftintitle`: Featured artists are now inserted before brackets
  containing remix/edit-related keywords (e.g., "Remix", "Live", "Edit") instead
  of being appended at the end. This improves formatting for titles like "Song 1
  (Carol Remix) ft. Bob" which becomes "Song 1 ft. Bob (Carol Remix)". A variety
  of brackets are supported and a new ``bracket_keywords`` configuration option
  allows customizing the keywords. Setting ``bracket_keywords`` to an empty list
  matches any bracket content regardless of keywords.
- :doc:`plugins/discogs`: Added support for multi value fields. :bug:`6068`
- :doc:`plugins/embedart`: Embedded arts can now be cleared during import with
  the ``clearart_on_import`` config option. Also, ``beet clearart`` is only
  going to update the files matching the query and with an embedded art, leaving
  untouched the files without.
- :doc:`plugins/fish`: Filenames are now completed in more places, like after
  ``beet import``.
- :doc:`plugins/random`: Added ``--field`` option to specify which field to use
  for equal-chance sampling (default: ``albumartist``).

Bug fixes:

- :doc:`/plugins/lastgenre`: Canonicalize genres when ``force`` and
  ``keep_existing`` are ``on``, yet no genre info on lastfm could be found.
  :bug:`6303`
- Handle potential OSError when unlinking temporary files in ArtResizer.
  :bug:`5615`
- :doc:`/plugins/spotify`: Updated Spotify API credentials. :bug:`6270`
- :doc:`/plugins/smartplaylist`: Fixed an issue where multiple queries in a
  playlist configuration were not preserving their order, causing items to
  appear in database order rather than the order specified in the config.
  :bug:`6183`
- :doc:`plugins/inline`: Fix recursion error when an inline field definition
  shadows a built-in item field (e.g., redefining ``track_no``). Inline
  expressions now skip self-references during evaluation to avoid infinite
  recursion. :bug:`6115`
- When hardlinking from a symlink (e.g. importing a symlink with hardlinking
  enabled), dereference the symlink then hardlink, rather than creating a new
  (potentially broken) symlink :bug:`5676`
- :doc:`/plugins/spotify`: The plugin now gracefully handles audio-features API
  deprecation (HTTP 403 errors). When a 403 error is encountered from the
  audio-features endpoint, the plugin logs a warning once and skips audio
  features for all remaining tracks in the session, avoiding unnecessary API
  calls and rate limit exhaustion.
- Running `beet --config <mypath> config -e` now edits `<mypath>` rather than
  the default config path. :bug:`5652`
- :doc:`plugins/lyrics`: Accepts strings for lyrics sources (previously only
  accepted a list of strings). :bug:`5962`
- Fix a bug introduced in release 2.4.0 where import from any valid
  import-log-file always threw a "none of the paths are importable" error.
- :doc:`/plugins/web`: repair broken `/item/values/…` and `/albums/values/…`
  endpoints. Previously, due to single-quotes (ie. string literal) in the SQL
  query, the query eg. `GET /item/values/albumartist` would return the literal
  "albumartist" instead of a list of unique album artists.
- Sanitize log messages by removing control characters preventing terminal
  rendering issues.
- When using :doc:`plugins/fromfilename` together with :doc:`plugins/edit`,
  temporary tags extracted from filenames are no longer lost when discarding or
  cancelling an edit session during import. :bug:`6104`
- :ref:`update-cmd` :doc:`plugins/edit` fix display formatting of field changes
  to clearly show added and removed flexible fields.
- :doc:`plugins/lastgenre`: Fix the issue where last.fm doesn't return any
  result in the artist genre stage because "concatenation" words in the artist
  name (like "feat.", "+", or "&") prevent it. Using the albumartists list field
  and fetching a genre for each artist separately improves the chance of
  receiving valid results in that stage.
- :doc:`/plugins/ftintitle`: Fixed artist name splitting to prioritize explicit
  featuring tokens (feat, ft, featuring) over generic separators (&, and),
  preventing incorrect splits when both are present.
- :doc:`reference/cli`: Fix 'from_scratch' option for singleton imports: delete
  all (old) metadata when new metadata is applied. :bug:`3706`
- :doc:`/plugins/convert`: ``auto_keep`` now respects ``no_convert`` and
  ``never_convert_lossy_files`` when deciding whether to copy/transcode items,
  avoiding extra lossy duplicates.
- :doc:`plugins/discogs`: Fixed unexpected flex attr from the Discogs plugin.
  :bug:`6177`
- Errors in metadata plugins during autotage process will now be logged but
  won't crash beets anymore. If you want to raise exceptions instead, set the
  new configuration option ``raise_on_error`` to ``yes`` :bug:`5903`,
  :bug:`4789`.

For plugin developers:

- A new plugin event, ``album_matched``, is sent when an album that is being
  imported has been matched to its metadata and the corresponding distance has
  been calculated.
- Added a reusable requests handler which can be used by plugins to make HTTP
  requests with built-in retry and backoff logic. It uses beets user-agent and
  configures timeouts. See :class:`~beetsplug._utils.requests.RequestHandler`
  for documentation.
- Replaced dependency on ``python-musicbrainzngs`` with a lightweight custom
  MusicBrainz client implementation and updated relevant plugins accordingly:

  - :doc:`plugins/listenbrainz`
  - :doc:`plugins/mbcollection`
  - :doc:`plugins/mbpseudo`
  - :doc:`plugins/missing`
  - :doc:`plugins/musicbrainz`
  - :doc:`plugins/parentwork`

  See :class:`~beetsplug._utils.musicbrainz.MusicBrainzAPI` for documentation.

For packagers:

- The minimum supported Python version is now 3.10.
- An unused dependency on ``mock`` has been removed.

Other changes:

- The documentation chapter :doc:`dev/paths` has been moved to the "For
  Developers" section and revised to reflect current best practices (pathlib
  usage).
- Refactored the ``beets/ui/commands.py`` monolithic file (2000+ lines) into
  multiple modules within the ``beets/ui/commands`` directory for better
  maintainability.
- :doc:`plugins/bpd`: Raise ImportError instead of ValueError when GStreamer is
  unavailable, enabling ``importorskip`` usage in pytest setup.
- Finally removed gmusic plugin and all related code/docs as the Google Play
  Music service was shut down in 2020.
- Updated color documentation with ``bright_*`` and ``bg_bright_*`` entries.
- Moved `beets/random.py` into `beetsplug/random.py` to cleanup core module.
- dbcore: Allow models to declare SQL indices; add an ``items.album_id`` index
  to speed up ``album.items()`` queries. :bug:`5809`

Revision 1.26: download - view: text, markup, annotated - select for diffs
Sun Oct 19 18:42:55 2025 UTC (12 months, 3 weeks ago) by wiz
Branches: MAIN
CVS tags: pkgsrc-2025Q4-base, pkgsrc-2025Q4
Diff to: previous 1.25: preferred, colored
Changes since revision 1.25: +0 -3 lines
py-beets: update to 2.5.1.

New features

    Zero Plugin: Add new configuration option, omit_single_disc, to allow zeroing the disc number on write for single-disc albums. Defaults to False.

Bug fixes

    beets.plugins.BeetsPlugin: load the last plugin class defined in the plugin namespace. πŸ› (#6093)

For packagers

    Fixed issue with legacy metadata plugins not copying properties from the base class.
    Reverted the following: When installing beets via git or locally the version string now reflects the current git branch and commit hash. πŸ› (#6089)

Other changes

    Removed outdated mailing list contact information from the documentation πŸ› (#5462).
    Getting Started: Modernized the Getting Started guide with tabbed sections and dropdown menus. Installation instructions have been streamlined, and a new subpage now provides additional setup details.

Revision 1.25: download - view: text, markup, annotated - select for diffs
Tue Oct 14 15:16:39 2025 UTC (13 months ago) by wiz
Branches: MAIN
Diff to: previous 1.24: preferred, colored
Changes since revision 1.24: +12 -6 lines
py-beets: update to 2.5.0.

New features

    Convert Plugin: Add a config option to disable writing metadata to converted files.
    Discogs Plugin Added support for featured artists. πŸ› (#6038)
    Discogs Plugin New configuration option featured_string to change the default string used to join featured artists. The default string is Feat..
    Discogs Plugin Support for artist_credit in Discogs tags. πŸ› (#3354)
    Discogs Plugin Support for name variations and config options to specify where the variations are written. πŸ› (#3354)
    Discogs Plugin: New config option strip_disambiguation to toggle stripping discogs numeric disambiguation on artist and label fields.
    LastGenre Plugin: Add a --pretend option to preview genre changes without storing or writing them.

Bug fixes

    Metadata source plugins: Fixed data source penalty calculation that was incorrectly applied during import matching. The source_weight configuration option has been renamed to data_source_mismatch_penalty to better reflect its purpose. πŸ› (#6066)
    Chromaprint/Acoustid Plugin BPSync Plugin Fix plugin loading issue caused by an import of another beets.plugins.BeetsPlugin class. πŸ› (#6033)
    Discogs Plugin Fixed inconsistency in stripping disambiguation from artists but not labels. πŸ› (#5366)
    FromFilename Plugin: Fix πŸ› (#5218), improve the code (refactor regexps, allow for more cases, add some logging), add tests.
    MusicBrainz Plugin Refresh flexible MusicBrainz metadata on reimport so format changes are applied. πŸ› (#6036)
    Spotify Plugin Ensure spotifysync keeps popularity, ISRC, and related fields current even when audio features requests fail. πŸ› (#6061)
    Spotify Plugin Fixed an issue where candidate lookup would not find matches due to query escaping (single vs double quotes).
    Spotify Plugin Fixed an issue where track matching and lookups could return incorrect or misleading results when using the Spotify plugin. The problem occurred primarily when no album was provided or when the album field was an empty string. πŸ› (#5189)
    Spotify Plugin Removed old and undocumented config options artist_field, album_field and track that were causing issues with track matching. πŸ› (#5189)

Other changes

    Moved art.py utility module from beets into beetsplug namespace as it is not used in the core beets codebase. It can now be found in beetsplug._utils.
    Moved vfs.py utility module from beets into beetsplug namespace as it is not used in the core beets codebase. It can now be found in beetsplug._utils.
    When installing beets via git or locally the version string now reflects the current git branch and commit hash. πŸ› (#4448)
    Autotagger Matching Options: match.distance_weights.source configuration has been renamed to match.distance_weights.data_source for consistency with the name of the field it refers to.
    FAQ: Add check for musicbrainz plugin if auto-tagger can't find a match πŸ› (#6020)
    Plugins: Clarify that musicbrainz must be mentioned if plugin list modified πŸ› (#6020)
    Using the Auto-Tagger: Section on no matching release found, related to possibly disabled musicbrainz plugin πŸ› (#6020)
    beets.metadata_plugin.MetadataSourcePlugin: Remove discogs specific disambiguation stripping.

For developers and plugin authors

    Metadata source plugins are now registered globally when instantiated, which makes their handling slightly more efficient.
    The track_distance() and album_distance() methods have been removed from MetadataSourcePlugin. Distance calculation for data source mismatches is now handled automatically by the core matching logic. This change simplifies the plugin architecture and fixes incorrect penalty calculations. πŸ› (#6066)
    Typing improvements in beets/logging.py: getLogger now returns BeetsLogger when called with a name, or RootLogger when called without a name.

Revision 1.24: download - view: text, markup, annotated - select for diffs
Mon Sep 22 20:32:13 2025 UTC (13 months, 3 weeks ago) by wiz
Branches: MAIN
Diff to: previous 1.23: preferred, colored
Changes since revision 1.23: +1 -1 lines
py-beets: fix PLIST for latest poetry-core and depend on it

Revision 1.23: download - view: text, markup, annotated - select for diffs
Sun Sep 21 15:17:23 2025 UTC (13 months, 3 weeks ago) by wiz
Branches: MAIN
Diff to: previous 1.22: preferred, colored
Changes since revision 1.22: +50 -10 lines
py-beets: update to 2.4.0.

2.4.0 (September 13, 2025)
--------------------------

New features:

- :doc:`plugins/musicbrainz`: The MusicBrainz autotagger has been moved to a
  separate plugin. The default :ref:`plugins-config` includes ``musicbrainz``,
  but if you've customized your ``plugins`` list in your configuration, you'll
  need to explicitly add ``musicbrainz`` to continue using this functionality.
  Configuration option ``musicbrainz.enabled`` has thus been deprecated.
  :bug:`2686` :bug:`4605`
- :doc:`plugins/web`: Show notifications when a track plays. This uses the Media
  Session API to customize media notifications.
- :doc:`plugins/discogs`: Add configurable ``search_limit`` option to limit the
  number of results returned by the Discogs metadata search queries.
- :doc:`plugins/discogs`: Implement ``track_for_id`` method to allow retrieving
  singletons by their Discogs ID. :bug:`4661`
- :doc:`plugins/replace`: Add new plugin.
- :doc:`plugins/duplicates`: Add ``--remove`` option, allowing to remove from
  the library without deleting media files. :bug:`5832`
- :doc:`plugins/playlist`: Support files with the ``.m3u8`` extension.
  :bug:`5829`
- :doc:`plugins/mbcollection`: When getting the user collections, only consider
  collections of releases, and ignore collections of other entity types.
- :doc:`plugins/mpdstats`: Add new configuration option,
  ``played_ratio_threshold``, to allow configuring the percentage the song must
  be played for it to be counted as played instead of skipped.
- :doc:`plugins/web`: Display artist and album as part of the search results.
- :doc:`plugins/spotify` :doc:`plugins/deezer`: Add new configuration option
  ``search_limit`` to limit the number of results returned by search queries.

Bug fixes:

- :doc:`plugins/musicbrainz`: fix regression where user configured
  ``extra_tags`` have been read incorrectly. :bug:`5788`
- tests: Fix library tests failing on Windows when run from outside ``D:/``.
  :bug:`5802`
- Fix an issue where calling ``Library.add`` would cause the ``database_change``
  event to be sent twice, not once. :bug:`5560`
- Fix ``HiddenFileTest`` by using ``bytestring_path()``.
- tests: Fix tests failing without ``langdetect`` (by making it required).
  :bug:`5797`
- :doc:`plugins/musicbrainz`: Fix the MusicBrainz search not taking into account
  the album/recording aliases
- :doc:`/plugins/spotify`: Fix the issue with that every query to spotify was
  ascii encoded. This resulted in bad matches for queries that contained special
  e.g. non latin characters as η›—δ½œ. If you want to keep the legacy behavior set
  the config option ``spotify.search_query_ascii: yes``. :bug:`5699`
- :doc:`plugins/discogs`: Beets will no longer crash if a release has been
  deleted, and returns a 404.
- :doc:`plugins/lastgenre`: Fix the issue introduced in Beets 2.3.0 where
  non-whitelisted last.fm genres were not canonicalized to parent genres.
  :bug:`5930`
- :doc:`plugins/chroma`: AcoustID lookup HTTP requests will now time out after
  10 seconds, rather than hanging the entire import process.
- :doc:`/plugins/deezer`: Fix the issue with that every query to deezer was
  ascii encoded. This resulted in bad matches for queries that contained special
  e.g. non latin characters as η›—δ½œ. If you want to keep the legacy behavior set
  the config option ``deezer.search_query_ascii: yes``. :bug:`5860`
- Fixed regression with :doc:`/plugins/listenbrainz` where the plugin could not
  be loaded :bug:`5975`

For packagers:

- Optional ``extra_tags`` parameter has been removed from
  ``BeetsPlugin.candidates`` method signature since it is never passed in. If
  you override this method in your plugin, feel free to remove this parameter.
- Loosened ``typing_extensions`` dependency in pyproject.toml to apply to every
  python version.

For plugin developers:

- The ``fetchart`` plugins has seen a few changes to function signatures and
  source registration in the process of introducing typings to the code. Custom
  art sources might need to be adapted.
- We split the responsibilities of plugins into two base classes

  1. :class:`beets.plugins.BeetsPlugin` is the base class for all plugins, any
     plugin needs to inherit from this class.
  2. :class:`beets.metadata_plugin.MetadataSourcePlugin` allows plugins to act
     like metadata sources. E.g. used by the MusicBrainz plugin. All plugins in
     the beets repo are opted into this class where applicable. If you are
     maintaining a plugin that acts like a metadata source, i.e. you expose any
     of ``track_for_id``, ``album_for_id``, ``candidates``, ``item_candidates``,
     ``album_distance``, ``track_distance`` methods, please update your plugin
     to inherit from the new baseclass, as otherwise your plugin will stop
     working with the next major release.

- Several definitions have been moved:

  - ``BLOB_TYPE`` constant, ``PathQuery`` and ``SingletonQuery`` queries have
    moved from ``beets.library`` to ``beets.dbcore.query`` module
  - ``DateType``, ``DurationType``, ``PathType`` types and ``MusicalKey`` class
    have moved from ``beets.library`` to ``beets.dbcore.types`` module.
  - ``Distance`` has moved from ``beets.autotag`` to ``beets.autotag.distance``
    module.
  - ``beets.autotag.current_metadata`` has been renamed to
    ``beets.util.get_most_common_tags``.

  Old imports are now deprecated and will be removed in version ``3.0.0``.

- ``beets.ui.decargs`` is deprecated and will be removed in version ``3.0.0``.
- Beets is now PEP 561 compliant, which means that it provides type hints for
  all public APIs. This allows IDEs to provide better autocompletion and type
  checking for downstream users of the beets API.
- ``plugins.find_plugins`` function does not anymore load plugins. You need to
  explicitly call ``plugins.load_plugins()`` to load them.
- ``plugins.load_plugins`` function does not anymore accept the list of plugins
  to load. Instead, it loads all plugins that are configured by
  :ref:`plugins-config` configuration.
- Flexible fields, which can be used by plugins to store additional metadata,
  now also support list values. Previously, beets would throw an error while
  storing the data in the SQL database due to missing type conversion.
  :bug:`5698`

Other changes:

- Refactor: Split responsibilities of Plugins into MetaDataPlugins and general
  Plugins.
- Documentation structure for auto generated API references changed slightly.
  Autogenerated API references are now located in the ``docs/api`` subdirectory.
- :doc:`/plugins/substitute`: Fix rST formatting for example cases so that each
  case is shown on separate lines.
- Refactored library.py file by splitting it into multiple modules within the
  beets/library directory.
- Added a test to check that all plugins can be imported without errors.
- :doc:`/guides/main`: Add instructions to install beets on Void Linux.
- :doc:`plugins/lastgenre`: Refactor loading whitelist and canonicalization
  file. :bug:`5979`
- :doc:`plugins/lastgenre`: Updated and streamlined the genre whitelist and
  canonicalization tree :bug:`5977`
- UI: Update default ``text_diff_added`` color from **bold red** to **bold
  green.**
- UI: Use ``text_diff_added`` and ``text_diff_removed`` colors in **all** diff
  comparisons, including case differences.

Revision 1.22: download - view: text, markup, annotated - select for diffs
Wed May 14 13:33:05 2025 UTC (18 months ago) by adam
Branches: MAIN
CVS tags: pkgsrc-2025Q3-base, pkgsrc-2025Q3, pkgsrc-2025Q2-base, pkgsrc-2025Q2
Diff to: previous 1.21: preferred, colored
Changes since revision 1.21: +4 -4 lines
py-beets: updated to 2.3.1

2.3.1 (May 14, 2025)

Bug fixes:
* :doc:`/reference/pathformat`: Fixed a regression where path legalization
  incorrectly removed parts of user-configured path formats that followed a dot
  (**.**).
  :bug:`5771`

For packagers:
* Force ``poetry`` version below 2 to avoid it mangling file modification times
  in ``sdist`` package.
  :bug:`5770`


2.3.0 (May 07, 2025)

Beets now requires Python 3.9 or later since support for EOL Python 3.8 has
been dropped.

New features:

* :doc:`plugins/lastgenre`: The new configuration option, ``keep_existing``,
  provides more fine-grained control over how pre-populated genre tags are
  handled. The ``force`` option now behaves in a more conventional manner.
  :bug:`4982`
* :doc:`plugins/lyrics`: Add new configuration option ``dist_thresh`` to
  control the maximum allowed distance between the lyrics search result and the
  tagged item's artist and title. This is useful for preventing false positives
  when fetching lyrics.
* :doc:`plugins/lyrics`: Rewrite lyrics translation functionality to use Azure
  AI Translator API and add relevant instructions to the documentation.
* :doc:`plugins/missing`: Add support for all metadata sources.
* :doc:`plugins/mbsync`: Add support for all metadata sorces.

Bug fixes:

* :doc:`plugins/thumbnails`: Fix API call to GIO on big endian architectures
  (like s390x) in thumbnails plugin.
  :bug:`5708`
* :doc:`plugins/listenbrainz`: Fix rST formatting for URLs of Listenbrainz API Key documentation and config.yaml.
* :doc:`plugins/listenbrainz`: Fix ``UnboundLocalError`` in cases where 'mbid' is not defined.
* :doc:`plugins/fetchart`: Fix fetchart bug where a tempfile could not be deleted due to never being
  properly closed.
  :bug:`5521`
* :doc:`plugins/lyrics`: LRCLib will fallback to plain lyrics if synced lyrics
  are not found and `synced` flag is set to `yes`.
* Synchronise files included in the source distribution with what we used to
  have before the introduction of Poetry.
  :bug:`5531`
  :bug:`5526`
* :ref:`write-cmd`: Fix the issue where for certain files differences in
  ``mb_artistid``, ``mb_albumartistid`` and ``albumtype`` fields are shown on
  every attempt to write tags. Note: your music needs to be reimported with
  ``beet import -LI`` or synchronised with ``beet mbsync`` in order to fix
  this!
  :bug:`5265`
  :bug:`5371`
  :bug:`4715`
* :ref:`import-cmd`: Fix ``MemoryError`` and improve performance tagging large
  albums by replacing ``munkres`` library with ``lap.lapjv``.
  :bug:`5207`
* :ref:`query-sort`: Fix a bug that would raise an exception when sorting on
  a non-string field that is not populated in all items.
  :bug:`5512`
* :doc:`plugins/lastgenre`: Fix track-level genre handling. Now when an album-level
  genre is set already, single tracks don't fall back to the album's genre and
  request their own last.fm genre. Also log messages regarding what's been
  tagged are now more polished.
  :bug:`5582`
* Fix ambiguous column name ``sqlite3.OperationalError`` that occured in album
  queries that filtered album track titles, for example ``beet list -a keyword
  title:foo``.
* :doc:`plugins/lyrics`: Rewrite lyrics tests using pytest to provide isolated
  configuration for each test case. This fixes the issue where some tests
  failed because they read developers' local lyrics configuration.
  :bug:`5133`
* :doc:`plugins/lyrics`: Do not attempt to search for lyrics if either the
  artist or title is missing and ignore ``artist_sort`` value if it is empty.
  :bug:`2635`
* :doc:`plugins/lyrics`: Fix fetching lyrics from ``lrclib`` source. If we
  cannot find lyrics for a specific album, artist, title combination, the
  plugin now tries to search for the artist and title and picks the most
  relevant result. Update the default ``sources`` configuration to prioritize
  ``lrclib`` over other sources since it returns reliable results quicker than
  others.
  :bug:`5102`
* :doc:`plugins/lyrics`: Fix the issue with ``genius`` backend not being able
  to match lyrics when there is a slight variation in the artist name.
  :bug:`4791`
* :doc:`plugins/lyrics`: Fix plugin crash when ``genius`` backend returns empty
  lyrics.
  :bug:`5583`
* ImageMagick 7.1.1-44 is now supported.
* :doc:`plugins/parentwork`: Only output parentwork changes when running in verbose mode.

For packagers:

* The minimum supported Python version is now 3.9.
* External plugin developers: ``beetsplug/__init__.py`` file can be removed
  from your plugin as beets now uses native/implicit namespace package setup.

Other changes:

* Release workflow: fix the issue where the new release tag is created for the
  wrong (outdated) commit. Now the tag is created in the same workflow step
  right after committing the version update.
  :bug:`5539`
* :doc:`/plugins/smartplaylist`: URL-encode additional item `fields` within generated
  EXTM3U playlists instead of JSON-encoding them.
* typehints: `./beets/importer.py` file now has improved typehints.
* typehints: `./beets/plugins.py` file now includes typehints.
* :doc:`plugins/ftintitle`: Optimize the plugin by avoiding unnecessary writes
  to the database.
* Database models are now serializable with pickle.

Revision 1.21: download - view: text, markup, annotated - select for diffs
Mon Jan 27 11:25:02 2025 UTC (21 months, 2 weeks ago) by wiz
Branches: MAIN
CVS tags: pkgsrc-2025Q1-base, pkgsrc-2025Q1
Diff to: previous 1.20: preferred, colored
Changes since revision 1.20: +3 -1 lines
py-beets: install man pages

The manual way, since they are not in the wheel.

Bump PKGREVISION.

Revision 1.20: download - view: text, markup, annotated - select for diffs
Tue Jan 14 09:15:24 2025 UTC (22 months ago) by wiz
Branches: MAIN
Diff to: previous 1.19: preferred, colored
Changes since revision 1.19: +1 -3 lines
py-beets: fix PLIST for latest poetry-core

Bump PKGREVISION

Revision 1.19: download - view: text, markup, annotated - select for diffs
Thu Jan 2 10:21:02 2025 UTC (22 months, 1 week ago) by adam
Branches: MAIN
Diff to: previous 1.18: preferred, colored
Changes since revision 1.18: +3 -8 lines
py-beets: updated to 2.2.0

2.2.0

New features

/plugins/substitute: Allow the replacement string to use capture groups from the match. It is thus possible to create more general rules, applying to many different artists at once.

Bug fixes

Bring back test files and the manual to the source distribution tarball.
Fix bug where matcher doesn't consider medium number when importing. This makes it difficult to import hybrid SACDs and other releases with duplicate tracks.
Check if running python from the Microsoft Store and provide feedback to install from python.org.

Other changes

Changed bitesize label to good first issue. Our contribute page is now automatically populated with these issues.

Revision 1.18: download - view: text, markup, annotated - select for diffs
Wed Jun 12 15:42:29 2024 UTC (2 years, 5 months ago) by adam
Branches: MAIN
CVS tags: pkgsrc-2024Q4-base, pkgsrc-2024Q4, pkgsrc-2024Q3-base, pkgsrc-2024Q3, pkgsrc-2024Q2-base, pkgsrc-2024Q2
Diff to: previous 1.17: preferred, colored
Changes since revision 1.17: +37 -9 lines
py-beets: updated to 2.0.0

Release v2.0.0

Major new features

The beets importer UI received a major overhaul. Several new configuration options are available for customizing layout and colors: ui_options.

New features

edit: Prefer editor from VISUAL environment variable over EDITOR.
config: Prefer editor from VISUAL environment variable over EDITOR.
listenbrainz: Add initial support for importing history and playlists from ListenBrainz
mbsubmit: add new prompt choices helping further to submit unmatched tracks to MusicBrainz faster.
spotify: We now fetch track's ISRC, EAN, and UPC identifiers from Spotify when using the spotifysync command.
discogs: supply a value for the cover_art_url attribute, for use by fetchart.
update: added `-e` flag for excluding fields from being updated.
deezer: Import rank and other attributes from Deezer during import and add a function to update the rank of existing items.
resolve transl-tracklisting relations for pseudo releases and merge data with the actual release
Fetchart: Use the right field (spotify_album_id) to obtain the Spotify album id
Prevent reimporting album if it is permanently removed from Spotify
Added option to use cover_art_url as an album art source in the fetchart plugin.
fetchart: The plugin can now get album art from spotify.
Added option to specify a URL in the embedart plugin.
list singleton:true queries have been made faster
list singleton:1 and singleton:0 can now alternatively be used in queries, same as comp
--from-logfile now parses log files using a UTF-8 encoding in beets/beets/ui/commands.py.
bareasc lookups have been made faster
list lookups using the pattern operator :: have been made faster
Added additional error handling for spotify plugin.
We now import the remixer field from Musicbrainz into the library.
mbsubmit: Added a new mbsubmit command to print track information to be submitted to MusicBrainz after initial import.
Added spotify_updated field to track when the information was last updated.
We now import and tag the album information when importing singletons using Spotify source.
spotify: The plugin now provides an additional command spotifysync that allows getting track popularity and audio features information from Spotify.
spotify: The plugin now records Spotify-specific IDs in the spotify_album_id, spotify_artist_id, and spotify_track_id fields.
Create the parental directories for database if they do not exist.
musicbrainz-config: a new musicbrainz.enabled option allows disabling the MusicBrainz metadata source during the autotagging process
kodiupdate: Now supports multiple kodi instances
Add the item fields bitrate_mode, encoder_info and encoder_settings.
Add query prefixes = and ~.
A new configuration option, duplicate_keys, lets you change which fields the beets importer uses to identify duplicates.
Add exact match <exact-match> queries, using the prefixes = and =~.
discogs: Permit appending style to genre.
discogs: Implement item_candidates for matching singletons.
discogs: Check for compliant discogs_client module.
convert: Add a new auto_keep option that automatically converts files but keeps the originals in the library.
Added a -P (or --disable-plugins) flag to specify one/multiple plugin(s) to be disabled at startup.
import-options: Add support for re-running the importer on paths in log files that were created with the -l (or --logfile) argument.
Preserve mtimes from archives
Add %sunique{} <sunique> template to disambiguate between singletons.
Add a new import.ignored_alias_types config option to allow for specific alias types to be skipped over when importing items/albums.
smartplaylist: A new --pretend option lets the user see what a new or changed smart playlist saved in the config is actually returning.
fromfilename: Add debug log messages that inform when the plugin replaced bad (missing) artist, title or tracknumber metadata.
musicbrainz-config: MusicBrainz release pages often link to related metadata sources like Discogs, Bandcamp, Spotify, Deezer and Beatport. When enabled via the musicbrainz.external_ids options, release ID's will be extracted from those URL's and imported to the library.
convert: Add support for generating m3u8 playlists together with converted media files.
Fetch the release_group_title field from MusicBrainz. πŸ› 4809
discogs: Add support for applying album information on singleton imports. πŸ› 4716
smartplaylist: During explicit runs of the splupdate command, the log message "Creating playlist ..."" is now displayed instead of hidden in the debug log, which states some form of progress through the UI.
subsonicupdate: Updates are now triggered whenever either the beets database is changed or a smart playlist is created/updated. πŸ› 4862
importfeeds: Add a new output format allowing to save a playlist once per import session. πŸ› 4863
Make ArtResizer work with PIL/pillow 10.0.0 removals.
A new configuration option, duplicate_verbose_prompt, allows changing how duplicates are presented during import. πŸ› 4866
embyupdate: Add handling for private users by adding userid config option.
substitute: Add the new plugin substitute as an alternative to the rewrite plugin. The main difference between them being that rewrite modifies files' metadata and substitute does not.
Add support for artists and albumartists multi-valued tags.
autobpm: Add the autobpm plugin which uses Librosa to calculate the BPM of the audio.
fetchart: Fix the error with CoverArtArchive where the maxwidth option would not be used to download a pre-sized thumbnail for release groups, as is already done with releases.
fetchart: Fix the error with CoverArtArchive where no cover would be found when the maxwidth option matches a pre-sized thumbnail size, but no thumbnail is provided by CAA. We now fallback to the raw image.
advancedrewrite: Add an advanced version of the rewrite plugin which allows to replace fields based on a given library query.
lyrics: Add LRCLIB as a new lyrics provider and a new synced option to prefer synced lyrics over plain lyrics.
import: Expose import.quiet_fallback as CLI option.
import: Expose import.incremental_skip_later as CLI option.
smartplaylist: Expose config options as CLI options.
smartplaylist: Add new option smartplaylist.output.
smartplaylist: Add new option smartplaylist.uri_format.
Sorted the default configuration file into categories.
convert: Don't treat WAVE (.wav) files as lossy anymore when using the never_convert_lossy_files option. They will get transcoded like the other lossless formats.
Add support for barcode field.
smartplaylist: Add new config option smartplaylist.fields.

Bug fixes

lastimport: Improve error handling in the process_tracks function and enable it to be used with other plugins.
spotify: Improve handling of ConnectionError.
deezer: Improve Deezer plugin error handling and set requests timeout to 10 seconds.
spotify: Add bad gateway (502) error handling.
spotify: Add a limit of 3 retries, instead of retrying endlessly when the API is not available.
Fix a crash when the Spotify API timeouts or does not return a Retry-After interval.
scrub: Fixed the import behavior where scrubbed database tags were restored to newly imported tracks with config settings scrub.auto: yes and import.write: no.
deezer: Fixed the error where Deezer plugin would crash if non-Deezer id is passed during import.
fetchart: Fix fetching from Cover Art Archive when the maxwidth option is set to one of the supported Cover Art Archive widths.
convert: Set default max_bitrate value to None to avoid transcoding when this parameter is not set.
replaygain: Avoid a crash when errors occur in the analysis backend.
We now use Python's defaults for command-line argument encoding, which should reduce the chance for errors and "file not found" failures when invoking other command-line tools, especially on Windows.
We now respect the Spotify API's rate limiting, which avoids crashing when the API reports code 429 (too many requests).
Fix implicit paths OR queries (e.g. beet list /path/ , /other-path/) which have previously been returning the entire library.
The Discogs release ID is now populated correctly to the discogs_albumid field again (it was no longer working after Discogs changed their release URL format).
The autotagger no longer considers all matches without a MusicBrainz ID as duplicates of each other.
convert: Resize album art when embedding
deezer: Fix auto tagger pagination issues (fetch beyond the first 25 tracks of a release).
spotify: Fix auto tagger pagination issues (fetch beyond the first 50 tracks of a release).
lyrics: Fix Genius search by using query params instead of body.
unimported: The new ignore_subdirectories configuration option added in 1.6.0 now has a default value if it hasn't been set.
deezer: Tolerate missing fields when searching for singleton tracks.
replaygain: The type of the internal r128_track_gain and r128_album_gain fields was changed from integer to float to fix loss of precision due to truncation.
Fix a regression in the previous release that caused a TypeError when moving files across filesystems.
convert: Deleting the original files during conversion no longer logs output when the quiet flag is enabled.
web: Fix handling of "query" requests. Previously queries consisting of more than one token (separated by a slash) always returned an empty result.
discogs: Skip Discogs query on insufficiently tagged files (artist and album tags missing) to prevent arbitrary candidate results.
lyrics: Fixed issues with the Tekstowo.pl and Genius backends where some non-lyrics content got included in the lyrics
limit: Better header formatting to improve index
replaygain: Correctly handle the overwrite config option, which forces recomputing ReplayGain values on import even for tracks that already have the tags.
embedart: Fix a crash when using recent versions of ImageMagick and the compare_threshold option.
lyrics: Fixed issue with Genius header being included in lyrics, added test case of up-to-date Genius html
importadded: Fix a bug with recently added reflink import option that causes a crash when ImportAdded plugin enabled.
convert: Fix a bug with the wma format alias.
web: Fix get file from item.
lastgenre: Fix a duplicated entry for trip hop in the default genre list.
lyrics: Fixed issue with Tekstowo backend not actually checking if the found song matches.
embedart: Add support for ImageMagick 7.1.1-12
fromfilename: Fix failed detection of <track> <title> filename patterns.
Fix issue where deletion of flexible fields on an album doesn't cascade to items
Fix issue where beet write continuously retags the albumtypes metadata field in files. Additionally broken data could have been added to the library when the tag was read from file back into the library using beet update. It is required for all users to check if such broken data is present in the library. Following the instructions described here, a sanity check and potential fix is easily possible.
Fix updating "data_source" on re-imports and improve logging when flexible attributes are being re-imported.
fetchart: Correctly select the cover art from fanart.tv with the highest number of likes
lyrics: Fix a crash with the Google backend when processing some web pages.
Modifying flexible attributes of albums now cascade to the individual album tracks, similar to how fixed album attributes have been cascading to tracks already. A new option --noinherit/-I to modify <modify-cmd> allows changing this behaviour.
Fix bug where an interrupted import process poisons the database, causing a null path that can't be removed.
discogs: Fix bug where empty artist and title fields would return None instead of an empty list.
Fix bug regarding displaying tracks that have been changed not being displayed unless the detail configuration is enabled.
web: Fix range request support, allowing to play large audio/ opus files using e.g. a browser/firefox or gstreamer/mopidy directly.
Fix bug where zsh completion script made assumptions about the specific variant of awk installed and required specific settings for sqlite3 and caching in zsh.

Remove unused functions

Fix bug where all media types are reported as the first media type when importing with MusicBrainz as the data source
Fix bug where unimported plugin would not ignore children directories of ignored directories.

For plugin developers

beets now explicitly prevents multiple plugins to define replacement functions for the same field. When previously defining template_fields for the same field in two plugins, the last loaded plugin would silently overwrite the function defined by the other plugin. Now, beets will raise an exception when this happens.
Allow reuse of some parts of beets' testing components. This may ease the work for externally developed plugins or related software (e.g. the beets plugin for Mopidy), if they need to create an in-memory instance of a beets music library for their tests.

For packagers

As noted above, the minimum Python version is now 3.7.
We fixed a version for the dependency on the Confuse library.
The minimum required version of mediafile is now 0.9.0.

Other changes

Add sphinx and sphinx_rtd_theme as dependencies for a new docs extra
absubmit: Deprecate the absubmit plugin since AcousticBrainz has stopped accepting new submissions.
acousticbrainz: Deprecate the acousticbrainz plugin since the AcousticBrainz project has shut down.
limit: Limit query results to head or tail (lslimit command only)
fish: Add --output option.
lyrics: Remove Musixmatch from default enabled sources as they are currently blocking requests from the beets user agent.
/faq: multidisc: Elaborated the multi-disc FAQ
/faq: src: Removed some long lines.
Refactor the test cases to avoid test smells.

Revision 1.17: download - view: text, markup, annotated - select for diffs
Tue Mar 7 20:19:17 2023 UTC (3 years, 8 months ago) by adam
Branches: MAIN
CVS tags: pkgsrc-2024Q1-base, pkgsrc-2024Q1, pkgsrc-2023Q4-base, pkgsrc-2023Q4, pkgsrc-2023Q3-base, pkgsrc-2023Q3, pkgsrc-2023Q2-base, pkgsrc-2023Q2, pkgsrc-2023Q1-base, pkgsrc-2023Q1
Diff to: previous 1.16: preferred, colored
Changes since revision 1.16: +4 -1 lines
py-beets: updated to 1.6.0

1.6.0 (November 27, 2021)
-------------------------

This release is our first experiment with time-based releases! We are aiming
to publish a new release of beets every 3 months. We therefore have a healthy
but not dizzyingly long list of new features and fixes.

With this release, beets now requires Python 3.6 or later (it removes support
for Python 2.7, 3.4, and 3.5). There are also a few other dependency
changes---if you're a maintainer of a beets package for a package manager,
thank you for your ongoing efforts, and please see the list of notes below.

Major new features:

* When fetching genres from MusicBrainz, we now include genres from the
  release group (in addition to the release). We also prioritize genres based
  on the number of votes.
  Thanks to :user:`aereaux`.
* Primary and secondary release types from MusicBrainz are now stored in a new
  ``albumtypes`` field.
  Thanks to :user:`edgars-supe`.
  :bug:`2200`
* An accompanying new :doc:`/plugins/albumtypes` includes some options for
  formatting this new ``albumtypes`` field.
  Thanks to :user:`edgars-supe`.

Other new things:

* :doc:`/plugins/permissions`: The plugin now sets cover art permissions to
  match the audio file permissions.
* :doc:`/plugins/unimported`: A new configuration option supports excluding
  specific subdirectories in library.
* :doc:`/plugins/info`: Add support for an ``--album`` flag.
* :doc:`/plugins/export`: Similarly add support for an ``--album`` flag.
* ``beet move`` now highlights path differences in color (when enabled).
* When moving files and a direct rename of a file is not possible (for
  example, when crossing filesystems), beets now copies to a temporary file in
  the target folder first and then moves to the destination instead of
  directly copying the target path. This gets us closer to always updating
  files atomically.
  Thanks to :user:`catap`.
  :bug:`4060`
* :doc:`/plugins/fetchart`: Add a new option to store cover art as
  non-progressive image. This is useful for DAPs that do not support
  progressive images. Set ``deinterlace: yes`` in your configuration to enable
  this conversion.
* :doc:`/plugins/fetchart`: Add a new option to change the file format of
  cover art images. This may also be useful for DAPs that only support some
  image formats.
* Support flexible attributes in ``%aunique``.
  :bug:`2678` :bug:`3553`
* Make ``%aunique`` faster, especially when using inline fields.
  :bug:`4145`

Bug fixes:

* :doc:`/plugins/lyrics`: Fix a crash when Beautiful Soup is not installed.
  :bug:`4027`
* :doc:`/plugins/discogs`: Support a new Discogs URL format for IDs.
  :bug:`4080`
* :doc:`/plugins/discogs`: Remove built-in rate-limiting because the Discogs
  Python library we use now has its own rate-limiting.
  :bug: `4108`
* :doc:`/plugins/export`: Fix some duplicated output.
* :doc:`/plugins/aura`: Fix a potential security hole when serving image
  files.
  :bug:`4160`

For plugin developers:

* :py:meth:`beets.library.Item.destination` now accepts a `replacements`
  argument to be used in favor of the default.
* The `pluginload` event is now sent after plugin types and queries are
  available, not before.
* A new plugin event, `album_removed`, is called when an album is removed from
  the library (even when its file is not deleted from disk).

Here are some notes for packagers:

* As noted above, the minimum Python version is now 3.6.
* We fixed a flaky test, named `test_album_art` in the `test_zero.py` file,
  that some distributions had disabled. Disabling this test should no longer
  be necessary.
  :bug:`4037` :bug:`4038`
* This version of beets no longer depends on the `six`_ library.
  :bug:`4030`
* The `gmusic` plugin was removed since Google Play Music has been shut down.
  Thus, the optional dependency on `gmusicapi` does not exist anymore.
  :bug:`4089`

Revision 1.16: download - view: text, markup, annotated - select for diffs
Thu Nov 25 19:41:22 2021 UTC (4 years, 11 months ago) by bsiegert
Branches: MAIN
CVS tags: pkgsrc-2022Q4-base, pkgsrc-2022Q4, pkgsrc-2022Q3-base, pkgsrc-2022Q3, pkgsrc-2022Q2-base, pkgsrc-2022Q2, pkgsrc-2022Q1-base, pkgsrc-2022Q1, pkgsrc-2021Q4-base, pkgsrc-2021Q4
Diff to: previous 1.15: preferred, colored
Changes since revision 1.15: +26 -4 lines
Update py-beets to 1.5.0, PR pkg/56378.

This long overdue release of beets includes far too many exciting and useful
features than could ever be satisfactorily enumerated.
As a technical detail, it also introduces two new external libraries:
MediaFile and Confuse used to be part of beets but are now reusable
dependencies---packagers, please take note.
Finally, this is the last version of beets where we intend to support Python
2.x and 3.5; future releases will soon require Python 3.6.

Revision 1.15: download - view: text, markup, annotated - select for diffs
Fri Jan 3 08:42:32 2020 UTC (6 years, 10 months ago) by adam
Branches: MAIN
CVS tags: pkgsrc-2021Q3-base, pkgsrc-2021Q3, pkgsrc-2021Q2-base, pkgsrc-2021Q2, pkgsrc-2021Q1-base, pkgsrc-2021Q1, pkgsrc-2020Q4-base, pkgsrc-2020Q4, pkgsrc-2020Q3-base, pkgsrc-2020Q3, pkgsrc-2020Q2-base, pkgsrc-2020Q2, pkgsrc-2020Q1-base, pkgsrc-2020Q1
Diff to: previous 1.14: preferred, colored
Changes since revision 1.14: +2 -2 lines
py-beets: mark as incompatible with Python 2.7; add dash to binary

Revision 1.14: download - view: text, markup, annotated - select for diffs
Sun Dec 29 16:31:03 2019 UTC (6 years, 10 months ago) by adam
Branches: MAIN
Diff to: previous 1.13: preferred, colored
Changes since revision 1.13: +179 -179 lines
py-beets: sort PLIST

Revision 1.13: download - view: text, markup, annotated - select for diffs
Sun Dec 29 15:57:24 2019 UTC (6 years, 10 months ago) by sevan
Branches: MAIN
Diff to: previous 1.12: preferred, colored
Changes since revision 1.12: +183 -171 lines
Update py-beets to 1.4.9

Beets 1.4.9
This small update is part of our attempt to release new versions more often! There are a few important fixes, and we're clearing the deck for a change to beets' dependencies in the next version.

The new feature is:

    You can use the NO_COLOR environment variable to disable terminal colors. #3273

There are some fixes in this release:

    Fix a regression in the last release that made the image resizer fail to detect older versions of ImageMagick. #3269
    gmusic: The oauth_file config option now supports more flexible path values, including ~ for the home directory. #3270
    gmusic: Fix a crash when using version 12.0.0 or later of the gmusicapi module. #3270
    Fix an incompatibility with Python 3.8's AST changes. #3278

Here's a note for packagers:

    pathlib is now an optional test dependency on Python 3.4+, removing the need for a Debian patch. #3275

Beets 1.4.8
This release is far too long in coming, but it's a good one. There is the usual torrent of new features and a ridiculously long line of fixes, but there are also some crucial maintenance changes. We officially support Python 3.7 and 3.8, and some performance optimizations can (anecdotally) make listing your library more than three times faster than in the previous version.

The new core features are:

    A new config-aunique configuration option allows setting default options for the aunique template function.
    The albumdisambig field no longer includes the MusicBrainz release group disambiguation comment. A new releasegroupdisambig field has been added. #3024
    The modify command now allows resetting fixed attributes. For example, beet modify -a artist:beatles artpath! resets artpath attribute from matching albums back to the default value. #2497
    A new importer option, ignore_data_tracks, lets you skip audio tracks contained in data files. #3021

There are some new plugins:

    The playlist can query the beets library using M3U playlists. Thanks to @Holzhaus and @Xenopathic. #123 #3145
    The loadext allows loading of SQLite extensions, primarily for use with the ICU SQLite extension for internationalization. #3160 #3226
    The subsonicupdate can automatically update your Subsonic library. Thanks to @maffo999. #3001

And many improvements to existing plugins:

    lastgenre: Added option -A to match individual tracks and singletons. #3220 #3219
    play: The plugin can now emit a UTF-8 BOM, fixing some issues with foobar2000 and Winamp. Thanks to @mz2212. #2944
    gmusic:
        Add a new option to automatically upload to Google Play Music library on track import. Thanks to @shuaiscott.
        Add new options for Google Play Music authentication. Thanks to @thetarkus. #3002
    replaygain: albumpeak on large collections is calculated as the average, not the maximum. #3008 #3009
    chroma:
        Now optionally has a bias toward looking up more relevant releases according to the preferred configuration options. Thanks to @Archer4499. #3017
        Fingerprint values are now properly stored as strings, which prevents strange repeated output when running beet write. Thanks to @Holzhaus. #3097 #2942
    convert: The plugin now has an id3v23 option that allows you to override the global id3v23 option. Thanks to @Holzhaus. #3104
    spotify:
        The plugin now uses OAuth for authentication to the Spotify API. Thanks to @rhlahuja. #2694 #3123
        The plugin now works as an import metadata provider: you can match tracks and albums using the Spotify database. Thanks to @rhlahuja. #3123
    ipfs: The plugin now supports a nocopy option which passes that flag to ipfs. Thanks to @wildthyme.
    discogs: The plugin now has rate limiting for the Discogs API. #3081
    mpdstats, mpdupdate: These plugins now use the MPD_PORT environment variable if no port is specified in the configuration file. #3223
    bpd:
        MPD protocol commands consume and single are now supported along with updated semantics for repeat and previous and new fields for status. The bpd server now understands and ignores some additional commands. #3200 #800
        MPD protocol command idle is now supported, allowing the MPD version to be bumped to 0.14. #3205 #800
        MPD protocol command decoders is now supported. #3222
        The plugin now uses the main beets logging system. The special-purpose --debug flag has been removed. Thanks to @arcresu. #3196
    mbsync: The plugin no longer queries MusicBrainz when either the mb_albumid or mb_trackid field is invalid. See also the discussion on Google Groups Thanks to @arogl.
    export: The plugin now also exports path field if the user explicitly specifies it with -i parameter. This only works when exporting library fields. #3084
    acousticbrainz: The plugin now declares types for all its fields, which enables easier querying and avoids a problem where very small numbers would be stored as strings. Thanks to @rain0r. #2790 #3238

Some improvements have been focused on improving beets' performance:

    Querying the library is now faster:
        We only convert fields that need to be displayed. Thanks to @pprkut. #3089
        We now compile templates once and reuse them instead of recompiling them to print out each matching object. Thanks to @SimonPersson. #3258
        Querying the library for items is now faster, for all queries that do not need to access album level properties. This was implemented by lazily fetching the album only when needed. Thanks to @SimonPersson. #3260
    absubmit, badfiles: Analysis now works in parallel (on Python 3 only). Thanks to @bemeurer. #2442 #3003
    mpdstats: Use the currentsong MPD command instead of playlist to get the current song, improving performance when the playlist is long. Thanks to @ray66. #3207 #2752

Several improvements are related to usability:

    The disambiguation string for identifying albums in the importer now shows the catalog number. Thanks to @8h2a. #2951
    Added whitespace padding to missing tracks dialog to improve readability. Thanks to @jams2. #2962
    The move command now lists the number of items already in-place. Thanks to @RollingStar. #3117
    Modify selection can now be applied early without selecting every item. #3083
    Beets now emits more useful messages during startup if SQLite returns an error. The SQLite error message is now attached to the beets message. #3005
    Fixed a confusing typo when the convert plugin copies the art covers. #3063

Many fixes have been focused on issues where beets would previously crash:

    Avoid a crash when archive extraction fails during import. #3041
    Missing album art file during an update no longer causes a fatal exception (instead, an error is logged and the missing file path is removed from the library). #3030
    When updating the database, beets no longer tries to move album art twice. #3189
    Fix an unhandled exception when pruning empty directories. #1996 #3209
    fetchart: Added network connection error handling to backends so that beets won't crash if a request fails. Thanks to @Holzhaus. #1579
    badfiles: Avoid a crash when the underlying tool emits undecodable output. #3165
    beatport: Avoid a crash when the server produces an error. #3184
    bpd: Fix crashes in the bpd server during exception handling. #3200
    bpd: Fix a crash triggered when certain clients tried to list the albums belonging to a particular artist. #3007 #3215
    replaygain: Avoid a crash when the bs1770gain tool emits malformed XML. #2983 #3247

There are many fixes related to compatibility with our dependencies including addressing changes interfaces:

    On Python 2, pin the jellyfish requirement to version 0.6.0 for compatibility.
    Fix compatibility with Python 3.7 and its change to a name in the re module. #2978
    Fix several uses of deprecated standard-library features on Python 3.7. Thanks to @arcresu. #3197
    Fix compatibility with pre-release versions of Python 3.8. #3201 #3202
    web: Fix an error when using more recent versions of Flask with CORS enabled. Thanks to @rveachkc. #2979: #2980
    Avoid some deprecation warnings with certain versions of the MusicBrainz library. Thanks to @zhelezov. #2826 #3092
    Restore iTunes Store album art source, and remove the dependency on python-itunes, which had gone unmaintained and was not Python-3-compatible. Thanks to @ocelma for creating python-itunes in the first place. Thanks to @nathdwek. #2371 #2551 #2718
    lastgenre, edit: Avoid a deprecation warnings from the PyYAML library by switching to the safe loader. Thanks to @translit and @sbraz. #3192 #3225
    Fix a problem when resizing images with PIL/pillow on Python 3. Thanks to @architek. #2504 #3029

And there are many other fixes:

    R128 normalization tags are now properly deleted from files when the values are missing. Thanks to @autrimpo. #2757
    Display the artist credit when matching albums if the artist_credit configuration option is set. #2953
    With the from_scratch configuration option set, only writable fields are cleared. Beets now no longer ignores the format your music is saved in. #2972
    The %aunique template function now works correctly with the -f/--format option. #3043
    Fixed the ordering of items when manually selecting changes while updating tags Thanks to @TaizoSimpson. #3501
    The %title template function now works correctly with apostrophes. Thanks to @GuilhermeHideki. #3033
    lastgenre: It's now possible to set the prefer_specific option without also setting canonical. #2973
    fetchart: The plugin now respects the ignore and ignore_hidden settings. #1632
    hook: Fix byte string interpolation in hook commands. #2967 #3167
    the: Log a message when something has changed, not when it hasn't. Thanks to @arcresu. #3195
    lastgenre: The force config option now actually works. #2704 #3054
    Resizing image files with ImageMagick now avoids problems on systems where there is a convert command that is not ImageMagick's by using the magick executable when it is available. Thanks to @ababyduck. #2093 #3236

There is one new thing for plugin developers to know about:

    In addition to prefix-based field queries, plugins can now define named queries that are not associated with any specific field. For example, the new playlist supports queries like playlist:name although there is no field named playlist. See extend-query for details.

And some messages for packagers:

    Note the changes to the dependencies on jellyfish and munkres.
    The optional python-itunes dependency has been removed.
    Python versions 3.7 and 3.8 are now supported.

Revision 1.12: download - view: text, markup, annotated - select for diffs
Mon Jul 9 08:06:18 2018 UTC (8 years, 4 months ago) by adam
Branches: MAIN
CVS tags: pkgsrc-2019Q4-base, pkgsrc-2019Q4, pkgsrc-2019Q3-base, pkgsrc-2019Q3, pkgsrc-2019Q2-base, pkgsrc-2019Q2, pkgsrc-2019Q1-base, pkgsrc-2019Q1, pkgsrc-2018Q4-base, pkgsrc-2018Q4, pkgsrc-2018Q3-base, pkgsrc-2018Q3
Diff to: previous 1.11: preferred, colored
Changes since revision 1.11: +4 -1 lines
py-beets: updated to 1.4.7

1.4.7:

This new release includes lots of new features in the importer and the
metadata source backends that it uses.
We've changed how the beets importer handles non-audio tracks listed in
metadata sources like MusicBrainz:

* The importer now ignores non-audio tracks (namely, data and video tracks)
  listed in MusicBrainz. Also, a new option, :ref:ignore_video_tracks, lets
  you return to the old behavior and include these video tracks.
* A new importer option, :ref:ignored_media, can let you skip certain media
  formats.

There are other subtle improvements to metadata handling in the importer:
* In the MusicBrainz backend, beets now imports the
  musicbrainz_releasetrackid field. This is a first step toward
* A new importer configuration option, :ref:artist_credit, will tell beets
  to prefer the artist credit over the artist when autotagging.

And there are even more new features:
* :doc:/plugins/replaygain: The beet replaygain command now has
  --force, --write and --nowrite options.
* A new importer configuration option, :ref:incremental_skip_later, lets you
  avoid recording skipped directories to the list of "processed" directories
  in :ref:incremental mode. This way, you can revisit them later with
  another import.
* :doc:/plugins/fetchart: The configuration options now support
  finer-grained control via the sources option. You can now specify the
  search order for different *matching strategies* within different backends.
* :doc:/plugins/web: A new cors_supports_credentials configuration
  option lets in-browser clients communicate with the server even when it is
  protected by an authorization mechanism (a proxy with HTTP authentication
  enabled, for example).
* A new :doc:/plugins/sonosupdate plugin automatically notifies Sonos
  controllers to update the music library when the beets library changes.
* :doc:/plugins/discogs: The plugin now stores master release IDs into
  mb_releasegroupid. It also "simulates" track IDs using the release ID
  and the track list position.
* :doc:/plugins/discogs: Fetch the original year from master releases.

There are lots and lots of fixes

Revision 1.11: download - view: text, markup, annotated - select for diffs
Sun Jul 23 19:04:10 2017 UTC (9 years, 3 months ago) by adam
Branches: MAIN
CVS tags: pkgsrc-2018Q2-base, pkgsrc-2018Q2, pkgsrc-2018Q1-base, pkgsrc-2018Q1, pkgsrc-2017Q4-base, pkgsrc-2017Q4, pkgsrc-2017Q3-base, pkgsrc-2017Q3
Diff to: previous 1.10: preferred, colored
Changes since revision 1.10: +11 -2 lines
1.4.5:

Version 1.4.5 adds some oft-requested features. When you're importing files,
you can now manually set fields on the new music. Date queries have gotten
much more powerful: you can write precise queries down to the second, and we
now have *relative* queries like ``-1w``, which means *one week ago*.

Here are the new features:

* You can now set fields to certain values during :ref:`import-cmd`, using
  either a ``--set field=value`` command-line flag or a new :ref:`set_fields`
  configuration option under the `importer` section.
* :ref:`Date queries <datequery>` can now include times, so you can filter
  your music down to the second.
* :ref:`Date queries <datequery>` can also be *relative*. You can say
  ``added:-1w..`` to match music added in the last week, for example.
* A new :doc:`/plugins/gmusic` lets you interact with your Google Play Music
  library.
* :doc:`/plugins/replaygain`: We now keep R128 data in separate tags from
  classic ReplayGain data for formats that need it (namely, Ogg Opus). A new
  `r128` configuration option enables this behavior for specific formats.
* The :ref:`move-cmd` command gained a new ``--export`` flag, which copies
  files to an external location without changing their paths in the library
  database.

There are also some bug fixes:

* :doc:`/plugins/lastgenre`: Fix a crash when using the `prefer_specific` and
  `canonical` options together.
* :doc:`/plugins/web`: Fix a crash on Windows under Python 2 when serving
  non-ASCII filenames.
* :doc:`/plugins/metasync`: Fix a crash in the Amarok backend when filenames
  contain quotes.
* More informative error messages are displayed when the file format is not
  recognized.

Revision 1.10: download - view: text, markup, annotated - select for diffs
Tue May 9 13:29:21 2017 UTC (9 years, 6 months ago) by leot
Branches: MAIN
CVS tags: pkgsrc-2017Q2-base, pkgsrc-2017Q2
Diff to: previous 1.9: preferred, colored
Changes since revision 1.9: +55 -3 lines
Update audio/beets to 1.4.3

pkgsrc changes:
 - Update MASTER_SITES to MASTER_SITE_PYPI
 - Update HOMEPAGE
 - Get rid of PYTHON_VERSIONS_INCOMPATIBLE
   (beets is now compatible with Python 3 too)
 - Misc cosmetic fixes and simplifications

Changes:
1.4.3 (January 9, 2017)
-----------------------

Happy new year! This new version includes a cornucopia of new features from
contributors, including new tags related to classical music and a new
:doc:`/plugins/absubmit` for performing acoustic analysis on your music. The
:doc:`/plugins/random` has a new mode that lets you generate time-limited
music---for example, you might generate a random playlist that lasts the
perfect length for your walk to work. We also access as many Web services as
possible over secure connections now---HTTPS everywhere!

1.4.2 (December 16, 2016)
-------------------------

This is just a little bug fix release. With 1.4.2, we're also confident enough
to recommend that anyone who's interested give Python 3 a try: bugs may still
lurk, but we've deemed things safe enough for broad adoption. If you can,
please install beets with ``pip3`` instead of ``pip2`` this time and let us
know how it goes!

1.4.1 (November 25, 2016)
-------------------------

Version 1.4 has **alpha-level** Python 3 support. Thanks to the heroic efforts
of :user:`jrobeson`, beets should run both under Python 2.7, as before, and
now under Python 3.4 and above. The support is still new: it undoubtedly
contains bugs, so it may replace all your music with Limp Bizkit---but if
you're brave and you have backups, please try installing on Python 3. Let us
know how it goes.


1.3.19 (June 25, 2016)
----------------------

This is primarily a bug fix release: it cleans up a couple of regressions that
appeared in the last version. But it also features the triumphant return of the
:doc:`/plugins/beatport` and a modernized :doc:`/plugins/bpd`.

It's also the first version where beets passes all its tests on Windows! May
this herald a new age of cross-platform reliability for beets.


1.3.18 (May 31, 2016)
---------------------

This update adds a new :doc:`/plugins/hook` that lets you integrate beets with
command-line tools and an :doc:`/plugins/export` that can dump data from the
beets database as JSON. You can also automatically translate lyrics using a
machine translation service.

The ``echonest`` plugin has been removed in this version because the API it
used is `shutting down`_. You might want to try the
:doc:`/plugins/acousticbrainz` instead.

.. _shutting down: https://developer.spotify.com/news-stories/2016/03/29/api-improvements-update/


1.3.17 (February 7, 2016)
-------------------------

This release introduces one new plugin to fetch audio information from the
`AcousticBrainz`_ project and another plugin to make it easier to submit your
handcrafted metadata back to MusicBrainz.
The importer also gained two oft-requested features: a way to skip the initial
search process by specifying an ID ahead of time, and a way to *manually*
provide metadata in the middle of the import process (via the
:doc:`/plugins/edit`).

Also, as of this release, the beets project has some new Internet homes! Our
new domain name is `beets.io`_, and we have a shiny new GitHub organization:
`beetbox`_.


1.3.16 (December 28, 2015)
--------------------------

The big news in this release is a new :doc:`interactive editor plugin
</plugins/edit>`. It's really nifty: you can now change your music's metadata
by making changes in a visual text editor, which can sometimes be far more
efficient than the built-in :ref:`modify-cmd` command. No more carefully
retyping the same artist name with slight capitalization changes.

This version also adds an oft-requested "not" operator to beets' queries, so
you can exclude music from any operation. It also brings friendlier formatting
(and querying!) of song durations.


1.3.15 (October 17, 2015)
-------------------------

This release adds a new plugin for checking file quality and a new source for
lyrics. The larger features are:

* A new :doc:`/plugins/badfiles` helps you scan for corruption in your music
  collection. Thanks to :user:`fxthomas`. :bug:`1568`
* :doc:`/plugins/lyrics`: You can now fetch lyrics from Genius.com.
  Thanks to :user:`sadatay`. :bug:`1626` :bug:`1639`
* :doc:`/plugins/zero`: The plugin can now use a "whitelist" policy as an
  alternative to the (default) "blacklist" mode. Thanks to :user:`adkow`.
  :bug:`1621` :bug:`1641`


1.3.14 (August 2, 2015)
-----------------------

This is mainly a bugfix release, but we also have a nifty new plugin for
`ipfs`_ and a bunch of new configuration options.


1.3.13 (April 24, 2015)
-----------------------

This is a tiny bug-fix release. It copes with a dependency upgrade that broke
beets.


1.3.12 (April 18, 2015)
-----------------------

This little update makes queries more powerful, sorts music more
intelligently, and removes a performance bottleneck. There's an experimental
new plugin for synchronizing metadata with music players.

Packagers should also note a new dependency in this version: the `Jellyfish`_
Python library makes our text comparisons (a big part of the auto-tagging
process) go much faster.


1.3.11 (April 5, 2015)
----------------------

In this release, we refactored the logging system to be more flexible and more
useful. There are more granular levels of verbosity, the output from plugins
should be more consistent, and several kinds of logging bugs should be
impossible in the future.

There are also two new plugins: one for filtering the files you import and an
evolved plugin for using album art as directory thumbnails in file managers.
There's a new source for album art, and the importer now records the source of
match data. This is a particularly huge release---there's lots more below.

There's one big change with this release: **Python 2.6 is no longer
supported**. You'll need Python 2.7. Please trust us when we say this let us
remove a surprising number of ugly hacks throughout the code.

Revision 1.9: download - view: text, markup, annotated - select for diffs
Tue Jan 6 19:50:43 2015 UTC (11 years, 10 months ago) by drochner
Branches: MAIN
CVS tags: pkgsrc-2017Q1-base, pkgsrc-2017Q1, pkgsrc-2016Q4-base, pkgsrc-2016Q4, pkgsrc-2016Q3-base, pkgsrc-2016Q3, pkgsrc-2016Q2-base, pkgsrc-2016Q2, pkgsrc-2016Q1-base, pkgsrc-2016Q1, pkgsrc-2015Q4-base, pkgsrc-2015Q4, pkgsrc-2015Q3-base, pkgsrc-2015Q3, pkgsrc-2015Q2-base, pkgsrc-2015Q2, pkgsrc-2015Q1-base, pkgsrc-2015Q1
Diff to: previous 1.8: preferred, colored
Changes since revision 1.8: +12 -6 lines
update to 1.3.10
changes:
-The import command now has a --pretend flag that lists the files that
 will be imported
-The config command can now be used to edit the configuration even when
 it has syntax errors
-plugin additions and updates
-bugfixes
-Fix a new crash with the latest version of Mutagen (1.26)

Revision 1.8: download - view: text, markup, annotated - select for diffs
Fri Oct 17 16:04:24 2014 UTC (12 years, 1 month ago) by drochner
Branches: MAIN
CVS tags: pkgsrc-2014Q4-base, pkgsrc-2014Q4
Diff to: previous 1.7: preferred, colored
Changes since revision 1.7: +21 -0 lines
update to 1.3.8
changes:
-Queries now support sorting
-user-defined fields can now have types
-plugin improvements

Revision 1.7: download - view: text, markup, annotated - select for diffs
Thu Apr 17 12:29:34 2014 UTC (12 years, 7 months ago) by wiz
Branches: MAIN
CVS tags: pkgsrc-2014Q3-base, pkgsrc-2014Q3, pkgsrc-2014Q2-base, pkgsrc-2014Q2
Diff to: previous 1.6: preferred, colored
Changes since revision 1.6: +19 -2 lines
Update to 1.3.5:

1.3.5 (April 15, 2014)
----------------------

This is a short-term release that adds some great new stuff to beets. There's
support for tracking and calculating musical keys, the ReplayGain plugin was
expanded to work with more music formats via GStreamer, we can now import
directly from compressed archives, and the lyrics plugin is more robust.

One note for upgraders and packagers: this version of beets has a new
dependency in `enum34`_, which is a backport of the new `enum`_ standard
library module.

The major new features are:

* Beets can now import `zip`, `tar` and `rar` archives. Just type ``beet
  import music.zip`` to have beets transparently extract the files to import.
* :doc:`/plugins/replaygain`: Added support for calculating ReplayGain values
  with GStreamer as well the mp3gain program. This enables ReplayGain
  calculation for any audio format. Thanks to Yevgeny Bezman.
* :doc:`/plugins/lyrics`: Lyrics should now be found for more songs. Searching
  is now sensitive to featured artists and parenthesized title suffixes.
  When a song has multiple titles, lyrics from all the named songs are now
  concatenated. Thanks to Fabrice Laporte and Paul Phillips.

In particular, a full complement of features for supporting musical keys are
new in this release:

* A new `initial_key` is available in the database and files' tags. You can
  set the field manually using a command like ``beet modify
  initial_key=Am``.
* The :doc:`/plugins/echonest` sets the `initial_key` field if the data is
  available.
* A new :doc:`/plugins/keyfinder` runs a command-line tool to get the key from
  audio data and store it in the `initial_key` field.

There are also many bug fixes and little enhancements:

* :doc:`/plugins/echonest`: Truncate files larger than 50MB before uploading for
  analysis.
* :doc:`/plugins/fetchart`: Fix a crash when the server does not specify a
  content type. Thanks to Lee Reinhardt.
* :doc:`/plugins/convert`: The ``--keep-new`` flag now works correctly
  and the library includes the converted item.
* The importer now logs a message instead of crashing when errors occur while
  opening the files to be imported.
* :doc:`/plugins/embedart`: Better error messages in exceptional conditions.
* Silenced some confusing error messages when searching for a non-MusicBrainz
  ID. Using an invalid ID (of any kind---Discogs IDs can be used there too) at
  the "Enter ID:" importer prompt now just silently returns no results. More
  info is in the verbose logs.
* :doc:`/plugins/mbsync`: Fix application of album-level metadata. Due to a
  regression a few releases ago, only track-level metadata was being updated.
* On Windows, paths on network shares (UNC paths) no longer cause "invalid
  filename" errors.
* :doc:`/plugins/replaygain`: Fix crashes when attempting to log errors.
* The :ref:`modify-cmd` command can now accept query arguments that contain =
  signs. An argument is considered a query part when a : appears before any
  =s. Thanks to mook.

.. _enum34: https://pypi.python.org/pypi/enum34
.. _enum: https://docs.python.org/3.4/library/enum.html


1.3.4 (April 5, 2014)
---------------------

This release brings a hodgepodge of medium-sized conveniences to beets. A new
:ref:`config-cmd` command manages your configuration, we now have :ref:`bash
completion <completion>`, and the :ref:`modify-cmd` command can delete
attributes. There are also some significant performance optimizations to the
autotagger's matching logic.

One note for upgraders: if you use the :doc:`/plugins/fetchart`, it has a new
dependency, the `requests`_ module.

New stuff:

* Added a :ref:`config-cmd` command to manage your configuration. It can show
  you what you currently have in your config file, point you at where the file
  should be, or launch your text editor to let you modify the file. Thanks to
  geigerzaehler.
* Beets now ships with a shell command completion script! See
  :ref:`completion`. Thanks to geigerzaehler.
* The :ref:`modify-cmd` command now allows removing flexible attributes. For
  example, ``beet modify artist:beatles oldies!`` deletes the ``oldies``
  attribute from matching items. Thanks to brilnius.
* Internally, beets has laid the groundwork for supporting multi-valued
  fields. Thanks to geigerzaehler.
* The importer interface now shows the URL for MusicBrainz matches. Thanks to
  johtso.
* :doc:`/plugins/smartplaylist`: Playlists can now be generated from multiple
  queries (combined with "or" logic). Album-level queries are also now
  possible and automatic playlist regeneration can now be disabled. Thanks to
  brilnius.
* :doc:`/plugins/echonest`: Echo Nest similarity now weights the tempo in
  better proportion to other metrics. Also, options were added to specify
  custom thresholds and output formats. Thanks to Adam M.
* Added the :ref:`after_write <plugin_events>` plugin event.
* :doc:`/plugins/lastgenre`: Separator in genre lists can now be
  configured. Thanks to brilnius.
* We now only use "primary" aliases for artist names from MusicBrainz. This
  eliminates some strange naming that could occur when the `languages` config
  option was set. Thanks to Filipe Fortes.
* The performance of the autotagger's matching mechanism is vastly improved.
  This should be noticeable when matching against very large releases such as
  box sets.
* The :ref:`import-cmd` command can now accept individual files as arguments
  even in non-singleton mode. Files are imported as one-track albums.

Fixes:

* Error messages involving paths no longer escape non-ASCII characters (for
  legibility).
* Fixed a regression that made it impossible to use the :ref:`modify-cmd`
  command to add new flexible fields. Thanks to brilnius.
* :doc:`/plugins/echonest`: Avoid crashing when the audio analysis fails.
  Thanks to Pedro Silva.
* :doc:`/plugins/duplicates`: Fix checksumming command execution for files
  with quotation marks in their names. Thanks again to Pedro Silva.
* Fix a crash when importing with both of the :ref:`group_albums` and
  :ref:`incremental` options enabled. Thanks to geigerzaehler.
* Give a sensible error message when ``BEETSDIR`` points to a file. Thanks
  again to geigerzaehler.
* Fix a crash when reading WMA files whose boolean-valued fields contain
  strings. Thanks to johtso.
* :doc:`/plugins/fetchart`: The plugin now sends "beets" as the User-Agent
  when making scraping requests. This helps resolve some blocked requests. The
  plugin now also depends on the `requests`_ Python library.
* The :ref:`write-cmd` command now only shows the changes to fields that will
  actually be written to a file.
* :doc:`/plugins/duplicates`: Spurious reports are now avoided for tracks with
  missing values (e.g., no MBIDs). Thanks to Pedro Silva.
* The default :ref:`replace` sanitation options now remove leading whitespace
  by default. Thanks to brilnius.
* :doc:`/plugins/importfeeds`: Fix crash when importing albums
  containing ``/`` with the ``m3u_multi`` format.
* Avoid crashing on Mutagen bugs while writing files' tags.
* :doc:`/plugins/convert`: Display a useful error message when the FFmpeg
  executable can't be found.

.. _requests: http://www.python-requests.org/


1.3.3 (February 26, 2014)
-------------------------

Version 1.3.3 brings a bunch changes to how item and album fields work
internally. Along with laying the groundwork for some great things in the
future, this brings a number of improvements to how you interact with beets.
Here's what's new with fields in particular:

* Plugin-provided fields can now be used in queries. For example, if you use
  the :doc:`/plugins/inline` to define a field called ``era``, you can now
  filter your library based on that field by typing something like
  ``beet list era:goldenage``.
* Album-level flexible attributes and plugin-provided attributes can now be
  used in path formats (and other item-level templates).
* :ref:`Date-based queries <datequery>` are now possible. Try getting every
  track you added in February 2014 with ``beet ls added:2014-02`` or in the
  whole decade with ``added:2010..``. Thanks to Stig Inge Lea BjΓΈrnsen.
* The :ref:`modify-cmd` command is now better at parsing and formatting
  fields. You can assign to boolean fields like ``comp``, for example, using
  either the words "true" or "false" or the numerals 1 and 0. Any
  boolean-esque value is normalized to a real boolean. The :ref:`update-cmd`
  and :ref:`write-cmd` commands also got smarter at formatting and colorizing
  changes.

For developers, the short version of the story is that Item and Album objects
provide *uniform access* across fixed, flexible, and computed attributes. You
can write ``item.foo`` to access the ``foo`` field without worrying about
where the data comes from.

Unrelated new stuff:

* The importer has a new interactive option (*G* for "Group albums"),
  command-line flag (``--group-albums``), and config option
  (:ref:`group_albums`) that lets you split apart albums that are mixed
  together in a single directory. Thanks to geigerzaehler.
* A new ``--config`` command-line option lets you specify an additional
  configuration file. This option *combines* config settings with your default
  config file. (As part of this change, the ``BEETSDIR`` environment variable
  no longer combines---it *replaces* your default config file.) Thanks again
  to geigerzaehler.
* :doc:`/plugins/ihate`: The plugin's configuration interface was overhauled.
  Its configuration is now much simpler---it uses beets queries instead of an
  ad-hoc per-field configuration. This is *backwards-incompatible*---if you
  use this plugin, you will need to update your configuration. Thanks to
  BrainDamage.

Other little fixes:

* :doc:`/plugins/echonest`: Tempo (BPM) is now always stored as an integer.
  Thanks to Heinz Wiesinger.
* Fix Python 2.6 compatibility in some logging statements in
  :doc:`/plugins/chroma` and :doc:`/plugins/lastgenre`.
* Prevent some crashes when things go really wrong when writing file metadata
  at the end of the import process.
* New plugin events: ``item_removed`` (thanks to Romuald Conty) and
  ``item_copied`` (thanks to Stig Inge Lea BjΓΈrnsen).
* The ``pluginpath`` config option can now point to the directory containing
  plugin code. (Previously, it awkwardly needed to point at a directory
  containing a ``beetsplug`` directory, which would then contain your code.
  This is preserved as an option for backwards compatibility.) This change
  should also work around a long-standing issue when using ``pluginpath`` when
  beets is installed using pip. Many thanks to geigerzaehler.
* :doc:`/plugins/web`: The ``/item/`` and ``/album/`` API endpoints now
  produce full details about albums and items, not just lists of IDs. Thanks
  to geigerzaehler.
* Fix a potential crash when using image resizing with the
  :doc:`/plugins/fetchart` or :doc:`/plugins/embedart` without ImageMagick
  installed.
* Also, when invoking ``convert`` for image resizing fails, we now log an
  error instead of crashing.
* :doc:`/plugins/fetchart`: The ``beet fetchart`` command can now associate
  local images with albums (unless ``--force`` is provided). Thanks to
  brilnius.
* :doc:`/plugins/fetchart`: Command output is now colorized. Thanks again to
  brilnius.
* The :ref:`modify-cmd` command avoids writing files and committing to the
  database when nothing has changed. Thanks once more to brilnius.
* The importer now uses the album artist field when guessing existing
  metadata for albums (rather than just the track artist field). Thanks to
  geigerzaehler.
* :doc:`/plugins/fromfilename`: Fix a crash when a filename contained only a
  track number (e.g., ``02.mp3``).
* :doc:`/plugins/convert`: Transcoding should now work on Windows.
* :doc:`/plugins/duplicates`: The ``move`` and ``copy`` destination arguments
  are now treated as directories. Thanks to Pedro Silva.
* The :ref:`modify-cmd` command now skips confirmation and prints a message if
  no changes are necessary. Thanks to brilnius.
* :doc:`/plugins/fetchart`: When using the ``remote_priority`` config option,
  local image files are no longer completely ignored.
* :doc:`/plugins/echonest`: Fix an issue causing the plugin to appear twice in
  the output of the ``beet version`` command.
* :doc:`/plugins/lastgenre`: Fix an occasional crash when no tag weight was
  returned by Last.fm.
* :doc:`/plugins/mpdstats`: Restore the ``last_played`` field. Thanks to
  Johann KlΓ€hn.
* The :ref:`modify-cmd` command's output now clearly shows when a file has
  been deleted.
* Album art in files with Vorbis Comments is now marked with the "front cover"
  type. Thanks to Jason Lefley.

Revision 1.6: download - view: text, markup, annotated - select for diffs
Wed Jan 15 16:17:23 2014 UTC (12 years, 10 months ago) by drochner
Branches: MAIN
CVS tags: pkgsrc-2014Q1-base, pkgsrc-2014Q1
Diff to: previous 1.5: preferred, colored
Changes since revision 1.5: +6 -0 lines
update to 1.3.2
changes:
-new "echonest" and "mpdstats" plugins
-improvements to "duplicates", "lastgenre" and "lyrics" plugins
-fixes

Revision 1.5: download - view: text, markup, annotated - select for diffs
Wed Dec 4 16:58:17 2013 UTC (12 years, 11 months ago) by drochner
Branches: MAIN
CVS tags: pkgsrc-2013Q4-base, pkgsrc-2013Q4
Diff to: previous 1.4: preferred, colored
Changes since revision 1.4: +6 -0 lines
update to 1.3.1
changes:
-database can contain arbitrary attributes now
-Add Opus audio support
-You can now transcode files to any audio format, rather than just MP3
-can guess tags from the filenames during import
-new id3v23 config option, writed tags in old format

Revision 1.4: download - view: text, markup, annotated - select for diffs
Wed Jun 12 20:29:21 2013 UTC (13 years, 5 months ago) by drochner
Branches: MAIN
CVS tags: pkgsrc-2013Q3-base, pkgsrc-2013Q3, pkgsrc-2013Q2-base, pkgsrc-2013Q2
Diff to: previous 1.3: preferred, colored
Changes since revision 1.3: +12 -0 lines
update to 1.2.0
changes:
-allow additional data sources to augment the matches from MusicBrainz
-New Duplicates Plugin, Missing Plugin
-more feature additions and fixes

Revision 1.3: download - view: text, markup, annotated - select for diffs
Sat May 4 13:27:22 2013 UTC (13 years, 6 months ago) by drochner
Branches: MAIN
Diff to: previous 1.2: preferred, colored
Changes since revision 1.2: +21 -8 lines
update to 1.1.0
changes:
-configuration file is YAML now, many new and changed options
-new and renamed plugins
-improved support for mp3g4/aac/asf files
-many fixes and improvements

pkgsrc change: installs without python version specific prefix/suffix

Revision 1.2: download - view: text, markup, annotated - select for diffs
Thu Mar 14 21:36:19 2013 UTC (13 years, 8 months ago) by drochner
Branches: MAIN
CVS tags: pkgsrc-2013Q1-base, pkgsrc-2013Q1
Diff to: previous 1.1: preferred, colored
Changes since revision 1.1: +2 -2 lines
fix for Python!=2.7, needs sqlite3

Revision 1.1: download - view: text, markup, annotated - select for diffs
Thu Mar 14 13:57:54 2013 UTC (13 years, 8 months ago) by wiz
Branches: MAIN
Import py-beets-1.0.0 as audio/py-beets.

Beets is the best command-line tool for viewing, querying, renaming,
and updating your music collection.

The purpose of beets is to get your music collection right once
and for all. It catalogs your collection, automatically improving
its metadata as it goes using the MusicBrainz database. (It also
downloads cover art for albums it imports.) Then it provides a
bouquet of tools for manipulating and accessing your music.

Because beets is designed as a library, it can do almost anything
you can imagine for your music collection. Via plugins, beets
becomes a panacea:

  * Embed and extract album art from files' tags.
  * Listen to your library with a music player that speaks the MPD
    protocol and works with a staggering variety of interfaces.
  * Fetch lyrics for all your songs from databases on the Web.
  * Manage your MusicBrainz music collection.
  * Analyze music files' metadata from the command line.
  * Clean up crufty tags left behind by other, less-awesome tools.
  * Browse your music library graphically through a Web browser
    and play it in any browser that supports HTML5 Audio.

Diff request

This form allows you to request diffs between any two revisions of a file. You may select a symbolic revision name using the selection box or you may type in a numeric name using the type-in text box.

Log view options

CVSweb <webmaster@jp.NetBSD.org>