From 35d1f2420b98e4ca65fc13c62a08d4524d7629a0 Mon Sep 17 00:00:00 2001 From: Adrian Sampson Date: Sat, 26 Nov 2011 15:59:30 -0800 Subject: [PATCH] document multi-disc album collapsing (#42) --- docs/changelog.rst | 5 +++++ docs/guides/tagger.rst | 13 ++++++++----- 2 files changed, 13 insertions(+), 5 deletions(-) diff --git a/docs/changelog.rst b/docs/changelog.rst index f019afe4f..eac4e8457 100644 --- a/docs/changelog.rst +++ b/docs/changelog.rst @@ -8,6 +8,11 @@ Changelog (NGS) service via `python-musicbrainz-ngs`_. The bindings are included with this version of beets, but a future version will make them an external 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 fingerprinting service. This replaces the old ``lastid`` plugin, which used Last.fm fingerprinting and is now deprecated. Fingerprinting with this library diff --git a/docs/guides/tagger.rst b/docs/guides/tagger.rst index 57356f121..5d8f414e2 100644 --- a/docs/guides/tagger.rst +++ b/docs/guides/tagger.rst @@ -44,7 +44,14 @@ all of these limitations. arbitrarily deep (like ``music/2010/hiphop/seattle/freshespresso/glamour``), 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 - 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 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 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 files are supported. (Do you use some other format? `Let me know!`_