]> kaliko git repositories - mpd-sima.git/blob - doc/source/user/10_metadata.rst
doc: Update sphinx config, add user documentation
[mpd-sima.git] / doc / source / user / 10_metadata.rst
1 .. _metadata-convention:
2
3 Music library metadata convention
4 =================================
5
6 In order to choose which tracks to add, your music library needs to follow some
7 conventions regarding **metadata** [1]_. Files in your library should be tagged
8 with the metadata best describing the music file.
9
10 Be aware that the benefit from a well tagged library goes far beyond the use of
11 MPD_sima alone. Any piece of software will take advantage of a well tagged
12 library, especially music players. If you already use MPD_ as a player, you are
13 already well aware of it.
14
15 A minimal set of tags required for MPD_sima to work would be ``ARTIST``, ``ALBUM``, ``TITLE``, but in order to work properly and with all plugins a more complete tag set is recommended.
16
17 MPD_sima is actually expecting: ``ARTIST``, ``ALBUM``, ``TITLE``, ``ALBUMARTIST``,
18 ``GENRE`` and some MusicBrainzIDs_ [2]_ as well: ``MUSICBRAINZ_ARTISTID``,
19 ``MUSICBRAINZ_ALBUMID`` and ``MUSICBRAINZ_ALBUMARTISTID``.
20
21 There are very good tools to (auto)tag you music library, picard_ is highly
22 recommended, beets_ is also a good alternative. Actually any piece of software
23 tagging your files with the most common tags (albumartist especially) and
24 MusicBrainzIDs_ [3]_ should be fine.
25
26
27
28 .. [1] commonly named tags or `ID3 tags`_ for MP3, but most audio format have some metadata features.
29
30 .. [2] MusicBrainz_ provides a reliable and unambiguous form of music identification; this music identification is performed through the use of MusicBrainz Identifiers (MBIDs_).
31 .. [3] cf 2_
32
33 .. include:: ../links.rst
34
35 .. vim: spell spelllang=en