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.
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.6:
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.
* :doc:/plugins/lyrics: The plugin can now produce reStructuredText files
for beautiful, readable books of lyrics.
* A new :ref:from_scratch configuration option makes the importer remove old
metadata before applying new metadata. This new feature complements the
:doc:zero </plugins/zero> and :doc:scrub </plugins/scrub> 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.
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.
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`. 🐛`1568`
* :doc:`/plugins/lyrics`: You can now fetch lyrics from Genius.com.
Thanks to :user:`sadatay`. 🐛`1626` 🐛`1639`
* :doc:`/plugins/zero`: The plugin can now use a "whitelist" policy as an
alternative to the (default) "blacklist" mode. Thanks to :user:`adkow`.
🐛`1621` 🐛`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.
Problems found with existing distfiles:
/pub/pkgsrc/distfiles/amp-0.7.6.tgz
/pub/pkgsrc/distfiles/freeswitch/freeswitch-sounds-music-32000-1.0.8.tar.gz
/pub/pkgsrc/distfiles/freeswitch/freeswitch-sounds-music-48000-1.0.8.tar.gz
/pub/pkgsrc/distfiles/freeswitch/freeswitch-sounds-en-us-callie-32000-1.0.22.tar.gz
/pub/pkgsrc/distfiles/freeswitch/freeswitch-sounds-en-us-callie-48000-1.0.22.tar.gz
/pub/pkgsrc/distfiles/freeswitch/freeswitch-sounds-fr-ca-june-32000-1.0.18.tar.gz
/pub/pkgsrc/distfiles/freeswitch/freeswitch-sounds-fr-ca-june-48000-1.0.18.tar.gz
/pub/pkgsrc/distfiles/freeswitch/freeswitch-sounds-ru-RU-elena-16000-1.0.12.tar.gz
/pub/pkgsrc/distfiles/freeswitch/freeswitch-sounds-ru-RU-elena-32000-1.0.12.tar.gz
/pub/pkgsrc/distfiles/freeswitch/freeswitch-sounds-ru-RU-elena-48000-1.0.12.tar.gz
/pub/pkgsrc/distfiles/freeswitch/freeswitch-sounds-ru-RU-elena-8000-1.0.12.tar.gz
/pub/pkgsrc/distfiles/freeswitch/freeswitch-sounds-fr-ca-june-32000-1.0.18.tar.gz
/pub/pkgsrc/distfiles/freeswitch/freeswitch-sounds-fr-ca-june-48000-1.0.18.tar.gz
/pub/pkgsrc/distfiles/freeswitch/freeswitch-sounds-ru-RU-elena-32000-1.0.13.tar.gz
/pub/pkgsrc/distfiles/freeswitch/freeswitch-sounds-ru-RU-elena-48000-1.0.13.tar.gz
/pub/pkgsrc/distfiles/kid3-3.3.0.tar.gz
/pub/pkgsrc/distfiles/libdca-0.0.5.tar.bz2
/pub/pkgsrc/distfiles/mp3to.gz
/pub/pkgsrc/distfiles/squeezeboxserver-7.5.1-noCPAN.tgz
No changes made to these file.
Otherwise, existing SHA1 digests verified and found to be the same on
the machine holding the existing distfiles (morden). All existing
SHA1 digests retained for now as an audit trail.
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)
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.
either because they themselves are not ready or because a
dependency isn't. This is annotated by
PYTHON_VERSIONS_INCOMPATIBLE= 33 # not yet ported as of x.y.z
or
PYTHON_VERSIONS_INCOMPATIBLE= 33 # py-foo, py-bar
respectively, please use the same style for other packages,
and check during updates.
Use versioned_dependencies.mk where applicable.
Use REPLACE_PYTHON instead of handcoded alternatives, where applicable.
Reorder Makefile sections into standard order, where applicable.
Remove PYTHON_VERSIONS_INCLUDE_3X lines since that will be default
with the next commit.
Whitespace cleanups and other nits corrected, where necessary.
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
changes:
-internal refactoring to the way that we calculate and process distance
scores in the autotagger
-Python-2.6 compatibility fixes, other minor fixes
changes:
-allow additional data sources to augment the matches from MusicBrainz
-New Duplicates Plugin, Missing Plugin
-more feature additions and fixes
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
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.
