aboutsummaryrefslogtreecommitdiffstats
path: root/doc/sticker.xml
blob: 0e27ba8cf6c98660034b3f7e9c616671bed79ea2 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
<?xml version='1.0' encoding="utf-8"?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
               "docbook/dtd/xml/4.2/docbookx.dtd">
<book>
  <title>The Music Player Daemon Sticker Database</title>

  <chapter>
    <title>Introduction to MPD's Sticker Database</title>
    <para>
      This document shell give a short guideline for recommended tags
      for use in MPD's Sticker Database.
      MPD's Sticker Database is a subsystem that enables users to add
      custom tags. MPD does not alter the media files.
    </para>
  </chapter>

  <chapter>
    <title>Guideline for recommended tags</title>
    <para>
      Since there is no standard for tags in media files, this
      document is trying to give you some help deciding what tags to
      use.  The selection of these tags tries to cover the most
      widely used tags.  This way the tags might still work in other
      players, if you sync the database with your original media
      files.
      Keep in mind that we stick with lower case tags with underscores
      instead of spaces. If there will be a Sync tool in future
      its easy to change this on the fly, if needed.
    </para>

    <variablelist>
      <varlistentry>
        <term><varname>rating</varname></term>
        <listitem>
          <para>
            Will store a rating value from 1 (worst) to 5 (best) for a
            given song.
          </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term><varname>album_rating</varname></term>
        <listitem>
          <para>
            Will store a rating value from 1 (worst) to 5 (best) for a
            given album.
          </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term><varname>style</varname></term>
        <listitem>
          <para>
            This tag is used to keep the Genre tag clean, by now
            having 1000's of genres.  Instead you define a Main Genre
            for each file and can make a more specific
            description. This should be one Keyword like "Post Punk"
            or "Progressive Death Metal" An Alternative name for this
            tag is "Subgenre", time will tell which one gets more
            support.
          </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term><varname>lyrics</varname></term>
        <listitem>
          <para>
            This one is self explaining. This gives the option to
            store lyrics of a song where they belong to: mapped to the
            song
          </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term><varname>similar_artists</varname> (Comma seperated list of artists)</term>
        <listitem>
          <para>
            This tag enables a last.fm alike aproach which will still
            work when being offline Keep in mind, that this tag is
            absolutely non-standard! I am not aware of any other
            player that uses a comparable tag.
          </para>
        </listitem>
      </varlistentry>
    </variablelist>
  </chapter>
</book>