Changelog History
-
v1.4.9 Changes
May 31, 2019π 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:
π 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
: Theoauth_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 thegmusicapi
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
-
v1.4.8 Changes
May 17, 2019π 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 theaunique
template function. - π The
albumdisambig
field no longer includes the MusicBrainz release group disambiguation comment. A newreleasegroupdisambig
field has been added. #3024 - 0οΈβ£ The
modify
command now allows resetting fixed attributes. For example,beet modify -a artist:beatles artpath!
resetsartpath
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 #3009chroma
:- 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
- Now optionally has a bias toward looking up more relevant releases according to the
- π
convert
: The plugin now has anid3v23
option that allows you to override the globalid3v23
option. Thanks to @Holzhaus. #3104 spotify
:- π
ipfs
: The plugin now supports anocopy
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 theMPD_PORT
environment variable if no port is specified in the configuration file. #3223 bpd
:- MPD protocol commands
consume
andsingle
are now supported along with updated semantics forrepeat
andprevious
and new fields forstatus
. 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
- MPD protocol commands
mbsync
: The plugin no longer queries MusicBrainz when either themb_albumid
ormb_trackid
field is invalid. See also the discussion on Google Groups Thanks to @arogl.- π
export
: The plugin now also exportspath
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 thecurrentsong
MPD command instead ofplaylist
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. #1579badfiles
: Avoid a crash when the underlying tool emits undecodable output. #3165beatport
: 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 #3215replaygain
: Avoid a crash when thebs1770gain
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 creatingpython-itunes
in the first place. Thanks to @nathdwek. #2371 #2551 #2718 - π
lastgenre
,edit
: Avoid a deprecation warnings from thePyYAML
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 theprefer_specific
option without also settingcanonical
. #2973- π
fetchart
: The plugin now respects theignore
andignore_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
: Theforce
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 themagick
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 likeplaylist:name
although there is no field namedplaylist
. Seeextend-query
for details.
π¦ And some messages for packagers:
- Note the changes to the dependencies on
jellyfish
andmunkres
. - π The optional
python-itunes
dependency has been removed. - π Python versions 3.7 and 3.8 are now supported.
- π§ A new
-
v1.4.7 Changes
May 29, 2018π 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, ignore_video_tracks, lets you return to the old behavior and include these video tracks. #1210
- A new importer option, ignored_media, can let you skip certain media formats. #2688
π 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 #406. Thanks to @Rawrmonkeys. - π§ A new importer configuration option, artist_credit, will tell beets to prefer the artist credit over the artist when autotagging. #1249
And there are even more new features:
replaygain
: Thebeet replaygain
command now has--force
,--write
and--nowrite
options. #2778- A new importer configuration option, incremental_skip_later, lets you avoid recording skipped directories to the list of "processed" directories in incremental mode. This way, you can revisit them later with another import. Thanks to @sekjun9878. #2773
fetchart
: The configuration options now support finer-grained control via thesources
option. You can now specify the search order for different matching strategies within different backends.- π
web
: A newcors_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
sonosupdate
plugin automatically notifies Sonos controllers to update the music library when the beets library changes. Thanks to @cgtobi. - π
discogs
: The plugin now stores master release IDs intomb_releasegroupid
. It also "simulates" track IDs using the release ID and the track list position. Thanks to @dbogdanov. #2336 - π
discogs
: Fetch the original year from master releases. #1122
π There are lots and lots of fixes:
- π
replaygain
: Fix a corner-case with thebs1770gain
backend where ReplayGain values were assigned to the wrong files. The plugin now requires version 0.4.6 or later of thebs1770gain
tool. #2777 - π
lyrics
: The plugin no longer crashes in the Genius source when BeautifulSoup is not found. Instead, it just logs a message and disables the source. #2911 lyrics
: Handle network and API errors when communicating with Genius. #2771- 0οΈβ£
lyrics
: Thelyrics
command previously wrote ReST files by default, even when you didn't ask for them. This default has been fixed. lyrics
: When writing ReST files, thelyrics
command now groups lyrics by thealbumartist
field, rather thanartist
. #2924- π Plugins can now see updated import task state, such as when rejecting the initial candidates and finding new ones via a manual search. Notably, this means that the importer prompt options that the
edit
provides show up more reliably after doing a secondary import search. #2441 #2731 importadded
: Fix a crash on non-autotagged imports. Thanks to @m42i. #2601 #1918- β‘οΈ
plexupdate
: The Plex token is now redacted in configuration output. Thanks to @Kovrinic. #2804 - Avoid a crash when importing a non-ASCII filename when using an ASCII locale on Unix under Python 3. #2793 #2803
- π Fix a problem caused by time zone misalignment that could make date queries fail to match certain dates that are near the edges of a range. For example, querying for dates within a certain month would fail to match dates within hours of the end of that month. #2652
- π
convert
: The plugin now runs before other plugin-provided import stages, which addresses an issue with generating ReplayGain data incompatible between the source and target file formats. Thanks to @autrimpo. #2814 ftintitle
: Thedrop
config option had no effect; it now does what it says it should do. #2817- π Importing a release with multiple release events now selects the event based on the order of your preferred countries rather than the order of release events in MusicBrainz. #2816
- π
web
: The time display in the web interface would incorrectly jump at the 30-second mark of every minute. Now, it correctly changes over at zero seconds. #2822 - π
web
: Fetching album art now works (instead of throwing an exception) under Python 3. Additionally, the server will now return a 404 response when the album ID is unknown (instead of throwing an exception and producing a 500 response). #2823 - π
web
: Fix an exception on Python 3 for filenames with non-Latin1 characters. (These characters are now converted to their ASCII equivalents.) #2815 - Partially fix bash completion for subcommand names that contain hyphens. Thanks to @jhermann. #2836 #2837
replaygain
: Really fix album gain calculation using the GStreamer backend. #2846- π Avoid an error when doing a "no-op" move on non-existent files (i.e., moving a file onto itself). #2863
- π
discogs
: Fix themedium
andmedium_index
values, which were occasionally incorrect for releases with two-sided mediums such as vinyl. Also fix themedium_total
value, which now contains total number of tracks on the medium to which a track belongs, not the total number of different mediums present on the release. Thanks to @dbogdanov. #2887 - π The importer now supports audio files contained in data tracks when they are listed in MusicBrainz: the corresponding audio tracks are now merged into the main track list. Thanks to @jdetrey. #1638
keyfinder
: Avoid a crash when trying to process unmatched tracks. #2537- π
mbsync
: Support MusicBrainz recording ID changes, relying on release track IDs instead. Thanks to @jdetrey. #1234 - β‘οΈ
mbsync
: We can now successfully update albums even when the first track has a missing MusicBrainz recording ID. #2920
There are a couple of changes for developers:
- Plugins can now run their import stages early, before other plugins. Use the
early_import_stages
list instead of plainimport_stages
to request this behavior. #2814 - We again properly send
albuminfo_received
andtrackinfo_received
in all cases, most notably when using thembsync
plugin. This was a regression since version 1.4.1. #2921
-
v1.4.6 Changes
December 21, 2017π The highlight of this release is "album merging," an oft-requested option in the importer to add new tracks to an existing album you already have in your library. This way, you no longer need to resort to removing the partial album from your library, combining the files manually, and importing again.
π Here are the larger new features in this release:
- π When the importer finds duplicate albums, you can now merge all the tracksβold and newβtogether and try importing them as a single, combined album. Thanks to @udiboy1209. #112 #2725
- π
lyrics
: The plugin can now produce reStructuredText files for beautiful, readable books of lyrics. Thanks to @anarcat. #2628 - π A new
from_scratch
configuration option makes the importer remove old metadata before applying new metadata. This new feature complements thezero
andscrub
plugins but is slightly different: beets clears out all the old tags it knows about and only keeps the new data it gets from the remote metadata source. Thanks to @tummychow. #934 #2755
There are also somewhat littler, but still great, new features:
convert
: A newno_convert
option lets you skip transcoding items matching a query. Instead, the files are just copied as-is. Thanks to @Stunner. #2732 #2751- π¨
fetchart
: A new quiet switch that only prints out messages when album art is missing. Thanks to @euri10. #2683 - π§
mbcollection
: You can configure a custom MusicBrainz collection via the newcollection
configuration option. #2685 - β‘οΈ
mbcollection
: The collection update command can now remove albums from collections that are longer in the beets library. fetchart
: Theclearart
command now asks for confirmation before touching your files. Thanks to @konman2. #2708 #2427- β‘οΈ
mpdstats
: The plugin now correctly updates song statistics when MPD switches from a song to a stream and when it plays the same song multiple times consecutively. #2707 - π§
acousticbrainz
: The plugin can now be configured to write only a specific list of tags. Thanks to @woparry.
π There are lots and lots of bug fixes:
- π
hook
: Fixed a problem where accessing non-string properties ofitem
oralbum
(e.g.,item.track
) would cause a crash. Thanks to @broddo. #2740 - π
play
: Whenrelative_to
is set, the plugin correctly emits relative paths even when querying for albums rather than tracks. Thanks to @j000. #2702 - β We suppress a spurious Python warning about a
BrokenPipeError
being ignored. This was an issue when using beets in simple shell scripts. Thanks to @Azphreal. #2622 #2631 - π
replaygain
: Fix a regression in the previous release related to the new R128 tags. #2615 #2623 lyrics
: The MusixMatch backend now detects and warns when the server has blocked the client. Thanks to @anarcat. #2634 #2632- π§
importfeeds
: Fix an error on Python 3 in certain configurations. Thanks to @djl. #2467 #2658 edit
: Fix a bug when editing items during a re-import with the-L
flag. Previously, diffs against against unrelated items could be shown or beets could crash. #2659- β‘οΈ
kodiupdate
: Fix the server URL and add better error reporting. #2662 - π Fixed a problem where "no-op" modifications would reset files' mtimes, resulting in unnecessary writes. This most prominently affected the
edit
plugin when saving the text file without making changes to some music. #2667 - π
chroma
: Fix a crash when running thesubmit
command on Python 3 on Windows with non-ASCII filenames. #2671 - π
absubmit
: Fix an occasional crash on Python 3 when the AB analysis tool produced non-ASCII metadata. #2673 - π§
duplicates
: Use the default tiebreak for items or albums when the configuration only specifies a tiebreak for the other kind of entity. Thanks to @cgevans. #2758 - π»
duplicates
: Fix the--key
command line option, which was ignored. replaygain
: Fix album ReplayGain calculation with the GStreamer backend. #2636scrub
: Handle errors when manipulating files using newer versions of Mutagen. #2716- π
fetchart
: The plugin no longer gets skipped during import when the "Edit Candidates" option is used from theedit
plugin. #2734 - π Fix a crash when numeric metadata fields contain just a minus or plus sign with no following numbers. Thanks to @eigengrau. #2741
fromfilename
: Recognize file names that contain only a track number, such as01.mp3
. Also, the plugin now allows underscores as a separator between fields. Thanks to @Vrihub. #2738 #2759- π Fixed an issue where images would be resized according to their longest edge, instead of their width, when using the
maxwidth
config option in thefetchart
andembedart
plugins.
There are some changes for developers:
- π "Fixed fields" in Album and Item objects are now more strict about translating missing values into type-specific null-like values. This should help in cases where a string field is unexpectedly
None
sometimes instead of just showing up as an empty string. #2605 - π¨ Refactored the move functions the
beets.library
module and themanipulate_files
function inbeets.importer
to use a single parameter describing the file operation instead of multiple Boolean flags. There is a new numerated type describing how to move, copy, or link files. #2682
-
v1.4.5 Changes
June 20, 2017Version 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 import, using either a
--set field=value
command-line flag or a newset_fields
configuration option under theimporter
section. Thanks to @bartkl. #1881 #2581 - Date queries can now include times, so you can filter your music down to the second. Thanks to @discopatrick. #2506 #2528
- Date queries can also be relative. You can say
added:-1w..
to match music added in the last week, for example. Thanks to @euri10. #2598 - A new
gmusic
lets you interact with your Google Play Music library. Thanks to @tigranl. #2553 #2586 - π§
replaygain
: We now keep R128 data in separate tags from classic ReplayGain data for formats that need it (namely, Ogg Opus). A newr128
configuration option enables this behavior for specific formats. Thanks to @autrimpo. #2557 #2560 - π The
move
command gained a new--export
flag, which copies files to an external location without changing their paths in the library database. Thanks to @SpirosChadoulos. #435 #2510
π There are also some bug fixes:
lastgenre
: Fix a crash when using theprefer_specific
andcanonical
options together. Thanks to @yacoob. #2459 #2583- π
web
: Fix a crash on Windows under Python 2 when serving non-ASCII filenames. Thanks to @robot3498712. #2592 #2593 metasync
: Fix a crash in the Amarok backend when filenames contain quotes. Thanks to @aranc23. #2595 #2596- More informative error messages are displayed when the file format is not recognized. #2599
- π§ You can now set fields to certain values during import, using either a
-
v1.4.4 Changes
June 10, 2017π This release built up a longer-than-normal list of nifty new features. We now support DSF audio files and the importer can hard-link your files, for example.
Here's a full list of new features:
- β Added support for DSF files, once a future version of Mutagen is released that supports them. Thanks to @docbobo. #459 #2379
- π A new hardlink config option instructs the importer to create hard links on filesystems that support them. Thanks to @jacobwgillespie. #2445
- β‘οΈ A new
kodiupdate
lets you keep your Kodi library in sync with beets. Thanks to @Pauligrinder. #2411 - π§ A new bell configuration option under the
import
section enables a terminal bell when input is required. Thanks to @SpirosChadoulos. #2366 #2495 - π A new field,
composer_sort
, is now supported and fetched from MusicBrainz. Thanks to @dosoe. #2519 #2529 - The MusicBrainz backend and
discogs
now both provide a new attribute calledtrack_alt
that stores more nuanced, possibly non-numeric track index data. For example, some vinyl or tape media will report the side of the record using a letter instead of a number in that field. #1831 #2363 - π
web
: Added a new endpoint,/item/path/foo
, which will return the item info for the file at the given path, or 404. - π
web
: Added a new config option,include_paths
, which will cause paths to be included in item API responses if set to true. - 0οΈβ£ The
%aunique
template function for aunique now takes a third argument that specifies which brackets to use around the disambiguator value. The argument can be any two characters that represent the left and right brackets. It defaults to[]
and can also be blank to turn off bracketing. #2397 #2399 - β Added a
--move
or-m
option to the importer so that the files can be moved to the library instead of being copied or added "in place." #2252 #2429 - 0οΈβ£
badfiles
: Added a--verbose
or-v
option. Results are now displayed only for corrupted files by default and for all the files when the verbose option is set. #1654 #2434 embedart
: The explicitembedart
command now asks for confirmation before embedding art into music files. Thanks to
@Stunner. #1999- You can now run beets by typing
python -m beets
. #2453 smartplaylist
: Different playlist specifications that generate identically-named playlist files no longer conflict; instead, the resulting lists of tracks are concatenated. #2468- π
missing
: A new mode lets you see missing albums from artists you have in your library. Thanks to @qlyoung. #2481 - π
web
: Add newreverse_proxy
config option to allow serving the web plugins under a reverse proxy. - π Importing a release with multiple release events now selects the event based on your preferred countries. #2501
- β
play
: A new-y
or--yes
parameter lets you skip the warning message if you enqueue more items than the warning threshold usually allows. - π Fix a bug where commands which forked subprocesses would sometimes prevent further inputs. This bug mainly affected
convert
. Thanks to @jansol. #2488 #2524
π There are also quite a few fixes:
- π§ In the replace configuration option, we now replace a leading hyphen (-) with an underscore. #549 #2509
absubmit
: We no longer filter audio files for specific formats---we will attempt the submission process for all formats. #2471- β‘οΈ
mpdupdate
: Fix Python 3 compatibility. #2381 replaygain
: Fix Python 3 compatibility in thebs1770gain
backend. #2382bpd
: Report playback times as integers. #2394- π
mpdstats
: Fix Python 3 compatibility. The plugin also now requires version 0.4.2 or later of thepython-mpd2
library. #2405 mpdstats
: Improve handling of MPD status queries.badfiles
: Fix Python 3 compatibility.- π Fix some cases where album-level ReplayGain/SoundCheck metadata would be written to files incorrectly. #2426
badfiles
: The command no longer bails out if the validator command is not found or exits with an error. #2430 #2433lyrics
: The Google search backend no longer crashes when the server responds with an error. #2437discogs
: You can now authenticate with Discogs using a personal access token. #2447- π Fix Python 3 compatibility when extracting rar archives in the importer. Thanks to @Lompik. #2443 #2448
- π
duplicates
: Fix Python 3 compatibility when using thecopy
andmove
options. #2444 mbsubmit
: The tracks are now sorted properly. Thanks to
@awesomer. #2457thumbnails
: Fix a string-related crash on Python 3. #2466beatport
: More than just 10 songs are now fetched per album. #2469- π§ On Python 3, the terminal_encoding setting is respected again for output and printing will no longer crash on systems configured with a limited encoding.
- π§
convert
: The default configuration uses FFmpeg's built-in AAC codec instead of faac. Thanks to @jansol. #2484 - π Fix the importer's detection of multi-disc albums when other subdirectories are present. #2493
- π¨ Invalid date queries now print an error message instead of being silently ignored. Thanks to @discopatrick. #2513 #2517
- π¨ When the SQLite database stops being accessible, we now print a friendly error message. Thanks to @Mary011196. #1676 #2508
- π¨
web
: Avoid a crash when sending binary data, such as Chromaprint fingerprints, in music attributes. #2542 #2532 - π Fix a hang when parsing templates that end in newlines. #2562
- π Fix a crash when reading non-ASCII characters in configuration files on Windows under Python 3. #2456 #2565 #2566
π We removed backends from two metadata plugins because of bitrot:
- π
lyrics
: The Lyrics.com backend has been removed. (It stopped working because of changes to the site's URL structure.) #2548 #2549 - π
fetchart
: The documentation no longer recommends iTunes Store artwork lookup because the unmaintained python-itunes is broken. Want to adopt it? #2371 #1610
-
v1.4.3 Changes
January 09, 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 AcousticBrainz Submit plugin for performing acoustic analysis on your music. The Random plugin 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!
The most visible new features are:
- π We now support the composer, lyricist, and arranger tags. The MusicBrainz data source will fetch data for these fields when the next version of python-musicbrainzngs_ is released. Thanks to @ibmibmibm. #506 #507 #1547 #2333
- A new
absubmit
lets you run acoustic analysis software and upload the results for others to use. Thanks to @inytar. #2253 #2342 - π
play
: The plugin now provides an importer prompt choice to play the music you're about to import. Thanks to @diomekes. #2008 #2360 - π We now use SSL to access Web services whenever possible. That includes MusicBrainz itself, several album art sources, some lyrics sources, and other servers. Thanks to @tigranl. #2307
random
: A new--time
option lets you generate a random playlist that takes a given amount of time. Thanks to @diomekes. #2305 #2322
Some smaller new features:
- π
zero
: A newzero
command manually triggers the zero plugin. Thanks to @SJoshBrown. #2274 #2329 - 0οΈβ£
acousticbrainz
: The plugin will avoid re-downloading data for files that already have it by default. You can override this behavior using a newforce
option. Thanks to @SusannaMaria. #2347 #2349 - β‘οΈ
bpm
: Theimport.write
configuration option now decides whether or not to write tracks after updating their BPM. #1992
π And the fixes:
bpd
: Fix a crash on non-ASCII MPD commands. #2332scrub
: Avoid a crash when files cannot be read or written. #2351scrub
: The image type values on scrubbed files are preserved instead of being reset to "other." #2339- π
web
: Fix a crash on Python 3 when serving files from the filesystem. #2353 - π
discogs
: Improve the handling of releases that contain subtracks. #2318 - π
discogs
: Fix a crash when a release does not contain format information, and increase robustness when other fields are missing. #2302 - π
lyrics
: The plugin now reports a beets-specific User-Agent header when requesting lyrics. #2357 - β‘οΈ
embyupdate
: The plugin now checks whether an API key or a password is provided in the configuration. - π§
play
: The misspelled configuration optionwarning_treshold
is no longer supported.
For plugin developers: when providing new importer prompt choices (see append_prompt_choices), you can now provide new candidates for the user to consider. For example, you might provide an alternative strategy for picking between the available alternatives or for looking up a release on MusicBrainz.
-
v1.4.2 Changes
December 17, 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 ofpip2
this time and let us know how it goes!π Here are the fixes:
badfiles
: Fix a crash on non-ASCII filenames. #2299- The
%asciify{}
path formatting function and the asciify-paths setting properly substitute path separators generated by converting some Unicode characters, such as Β½ and Β’, into ASCII. - π²
convert
: Fix a logging-related crash when filenames contain curly braces. Thanks to @kierdavis. #2323 - We've rolled back some changes to the included zsh completion script that were causing problems for some users. #2266
π Also, we've removed some special handling for logging in the
discogs
that we believe was unnecessary. If spurious log messages appear in this version, please let us know by filing a bug. -
v1.4.1 Changes
November 26, 2016Version 1.4 has alpha-level Python 3 support. Thanks to the heroic efforts of @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.
π¦ If you package beets for distribution, here's what you'll want to know:
- This version of beets now depends on the six library.
- We also bumped our minimum required version of Mutagen to 1.33 (from 1.27).
- Please don't package beets as a Python 3 application yet, even though most things work under Python 3.4 and later.
π§ This version also makes a few changes to the command-line interface and configuration that you may need to know about:
- π
duplicates
: Theduplicates
command no longer accepts multiple field arguments in the form-k title albumartist album
. Each argument must be prefixed with-k
, as in-k title -k albumartist -k album
. - π§ The old top-level
colors
configuration option has been removed (the setting is now underui
). - The deprecated
list_format_album
andlist_format_item
configuration options have been removed (see format_album and format_item).
The are a few new features:
- β‘οΈ
mpdupdate
,mpdstats
: When thehost
option is not set, these plugins will now look for the$MPD_HOST
environment variable before falling back tolocalhost
. Thanks to @tarruda. #2175 - π
web
: Added anexpand
option to show the items of an album. #2050 - β‘οΈ
embyupdate
: The plugin can now use an API key instead of a password to authenticate with Emby. #2045 #2117 - π
acousticbrainz
: The plugin now adds abpm
field. beet --version
now includes the Python version used to run beets.- /reference/pathformat can now include unescaped commas (
,
) when they are not part of a function call. #2166 #2213 - β‘οΈ The
update
command takes a new-F
flag to specify the fields to update. Thanks to @dangmai. #2229 #2231
π And there are a few bug fixes too:
- π
convert
: The plugin no longer asks for confirmation if the query did not return anything to convert. #2260 #2262 - π
embedart
: The plugin now usesjpg
as an extension rather thanjpeg
, to ensure consistency with the plugins/fetchart. Thanks to @tweitzel. #2254 #2255 - π
embedart
: The plugin now works for all jpeg files, including those that are only recognizable by their magic bytes. #1545 #2255 - π¨
web
: The JSON output is no longer pretty-printed (for a space savings). #2050 - π
permissions
: Fix a regression in the previous release where the plugin would always fail to set permissions (and log a warning). #2089 beatport
: Use track numbers from Beatport (instead of determining them from the order of tracks) and set themedium_index
value.- With per_disc_numbering enabled, some metadata sources (notably, the
beatport
) would not set the track number at all. This is fixed. #2085 - π§
play
: Fix$args
getting passed verbatim to the play command if it was set in the configuration but-A
or--args
was omitted. - π With ignore_hidden enabled, non-UTF-8 filenames would cause a crash. This is fixed. #2168
- β‘οΈ
embyupdate
: Fixes authentication header problem that caused a problem that it was not possible to get tokens from the Emby API. - π
lyrics
: Some titles use a colon to separate the main title from a subtitle. To find more matches, the plugin now also searches for lyrics using the part part preceding the colon character. #2206 - π Fix a crash when a query uses a date field and some items are missing that field. #1938
discogs
: Subtracks are now detected and combined into a single track, two-sided mediums are treated as single discs, and tracks havemedia
,medium_total
andmedium
set correctly. #2222 #2228.missing
:missing
is now treated as an integer, allowing the use of (for example) ranges in queries.smartplaylist
: Playlist names will be sanitized to ensure valid filenames. #2258- The ID3 APIC tag now uses the Latin-1 encoding when possible instead of a Unicode encoding. This should increase compatibility with other software, especially with iTunes and when using ID3v2.3. Thanks to @lazka. #899 #2264 #2270
π The last release, 1.3.19, also erroneously reported its version as "1.3.18" when you typed
beet version
. This has been corrected. -
v1.3.19 Changes
June 26, 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
beatport
and a modernizedbpd
.π 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.
π New features:
- π
beatport
: This metadata source plugin has arisen from the dead! It now works with Beatport's new OAuth-based API. Thanks to
@jbaiter. #1989 #2067 - π
bpd
: The plugin now uses the modern GStreamer 1.0 instead of the old 0.10. Thanks to @philippbeckmann. #2057 #2062 - π A new
--force
option for theremove
command allows removal of items without prompting beforehand. #2042 - A new duplicate_action importer config option controls how duplicate albums or tracks treated in import task. #185
π Some fixes for Windows:
- π Queries are now detected as paths when they contain backslashes (in addition to forward slashes). This only applies on Windows.
- π
embedart
: Image similarity comparison with ImageMagick should now work on Windows. - π
fetchart
: The plugin should work more reliably with non-ASCII paths.
π And other fixes:
replaygain
: Thebs1770gain
backend now correctly calculates sample peak instead of true peak. This comes with a major speed increase. #2031- β
lyrics
: Avoid a crash and a spurious warning introduced in the last version about a Google API key, which appeared even when you hadn't enabled the Google lyrics source. - π Fix a hard-coded path to
bash-completion
to work better with Homebrew installations. Thanks to @bismark. #2038 - π Fix a crash introduced in the previous version when the standard input was connected to a Unix pipe. #2041
- π Fix a crash when specifying non-ASCII format strings on the command line with the
-f
option for many commands. #2063 - β
fetchart
: Determine the file extension for downloaded images based on the image's magic bytes. The plugin prints a warning if result is not consistent with the server-suppliedContent-Type
header. In previous versions, the plugin would use a.jpg
extension for all images. #2053
- π