Up to [cvs.NetBSD.org] / pkgsrc / audio / py-beets
Request diff between arbitrary revisions
Keyword substitution: kv
Default branch: MAIN
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.
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.
py-beets: fix PLIST for update While here, clean up and simplify Makefile.
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.
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).
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`
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
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)
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`
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.
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.
py-beets: fix PLIST for latest poetry-core and depend on it
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.
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.
py-beets: install man pages The manual way, since they are not in the wheel. Bump PKGREVISION.
py-beets: fix PLIST for latest poetry-core Bump PKGREVISION
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.
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.
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`
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.
py-beets: mark as incompatible with Python 2.7; add dash to binary
py-beets: sort PLIST
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.
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
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.
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.
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)
update to 1.3.8 changes: -Queries now support sorting -user-defined fields can now have types -plugin improvements
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.
update to 1.3.2 changes: -new "echonest" and "mpdstats" plugins -improvements to "duplicates", "lastgenre" and "lyrics" plugins -fixes
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
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
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
fix for Python!=2.7, needs sqlite3
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.