document multi-disc album collapsing (#42)

This commit is contained in:
Adrian Sampson 2011-11-26 15:59:30 -08:00
parent 450115358d
commit 35d1f2420b
2 changed files with 13 additions and 5 deletions

View file

@ -8,6 +8,11 @@ Changelog
(NGS) service via `python-musicbrainz-ngs`_. The bindings are included with (NGS) service via `python-musicbrainz-ngs`_. The bindings are included with
this version of beets, but a future version will make them an external this version of beets, but a future version will make them an external
dependency. dependency.
* The importer now detects **multi-disc albums** and tags them together. Using a
heuristic based on the names of directories, certain structures are classified
as multi-disc albums: for example, if a directory contains subdirectories
labeled "disc 1" and "disc 2", these subdirectories will be coalesced into a
single album for tagging.
* The new :doc:`/plugins/chroma` uses the `Acoustid`_ open-source acoustic * The new :doc:`/plugins/chroma` uses the `Acoustid`_ open-source acoustic
fingerprinting service. This replaces the old ``lastid`` plugin, which used fingerprinting service. This replaces the old ``lastid`` plugin, which used
Last.fm fingerprinting and is now deprecated. Fingerprinting with this library Last.fm fingerprinting and is now deprecated. Fingerprinting with this library

View file

@ -44,7 +44,14 @@ all of these limitations.
arbitrarily deep (like ``music/2010/hiphop/seattle/freshespresso/glamour``), arbitrarily deep (like ``music/2010/hiphop/seattle/freshespresso/glamour``),
but any directory with music files in it is interpreted as a separate album. but any directory with music files in it is interpreted as a separate album.
This means that your flat directory of six thousand uncategorized MP3s won't This means that your flat directory of six thousand uncategorized MP3s won't
currently be autotaggable. This will change eventually. currently be autotaggable. (This will change eventually.)
There is one exception to this rule: directories that look like separate parts
of a *multi-disc album* are tagged together as a single release. This
situation is detected by looking at the names of directories. If one directory
has sub-directories with, for example, "disc 1" and "disc 2" in their names,
they get lumped together as a single album. The marker words for this feature
are "part", "volume", "vol.", "disc", and "CD".
* The music may have bad tags, but it's not completely untagged. (This is * The music may have bad tags, but it's not completely untagged. (This is
actually not a hard-and-fast rule: using the *E* option described below, it's actually not a hard-and-fast rule: using the *E* option described below, it's
@ -55,10 +62,6 @@ all of these limitations.
plugin if you're willing to spend a little more CPU power to get tags for plugin if you're willing to spend a little more CPU power to get tags for
unidentified albums. unidentified albums.
* There isn't currently a good solution for multi-disc albums. Currently, every
disc is treated as a separate release, so you'll see "69 Love Songs (disc 1)",
"69 Love Songs (disc 2)" and such. We should be more flexible about this.
* Currently MP3, AAC, FLAC, Ogg Vorbis, Monkey's Audio, WavPack, and Musepack * Currently MP3, AAC, FLAC, Ogg Vorbis, Monkey's Audio, WavPack, and Musepack
files are supported. (Do you use some other format? files are supported. (Do you use some other format?
`Let me know!`_ `Let me know!`_