~ubuntu-branches/ubuntu/saucy/mpd/saucy

« back to all changes in this revision

Viewing changes to doc/sticker.xml

  • Committer: Bazaar Package Importer
  • Author(s): Angel Abad
  • Date: 2011-02-02 12:26:30 UTC
  • mfrom: (1.5.11 upstream)
  • Revision ID: james.westby@ubuntu.com-20110202122630-bdyx8w4k94doz4fs
Tags: 0.16.1-1ubuntu1
* Merge from debian unstable. Remaining changes:
  - debian/control:
    + Don't build-depend on libmikmod2-dev (Debian bug #510675).
    + Move avahi-daemon from Suggests field to Recommends field.
  - debian/mpd.init.d:
    + Read mpd user from mpd.conf.
  - debian/control, debian/rules:
    + Add libmp3lame-dev to the build dependencies and enable lame.

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
<?xml version='1.0' encoding="utf-8"?>
2
 
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
3
 
               "docbook/dtd/xml/4.2/docbookx.dtd">
4
 
<book>
5
 
  <title>The Music Player Daemon Sticker Database</title>
6
 
 
7
 
  <chapter>
8
 
    <title>Introduction to MPD's Sticker Database</title>
9
 
    <para>
10
 
      This document shell give a short guideline for recommended tags
11
 
      for use in MPD's Sticker Database.
12
 
      MPD's Sticker Database is a subsystem that enables users to add
13
 
      custom tags. MPD does not alter the media files.
14
 
    </para>
15
 
  </chapter>
16
 
 
17
 
  <chapter>
18
 
    <title>Guideline for recommended tags</title>
19
 
    <para>
20
 
      Since there is no standard for tags in media files, this
21
 
      document is trying to give you some help deciding what tags to
22
 
      use.  The selection of these tags tries to cover the most
23
 
      widely used tags.  This way the tags might still work in other
24
 
      players, if you sync the database with your original media
25
 
      files.
26
 
      Keep in mind that we stick with lower case tags with underscores
27
 
      instead of spaces. If there will be a Sync tool in future
28
 
      its easy to change this on the fly, if needed.
29
 
    </para>
30
 
 
31
 
    <variablelist>
32
 
      <varlistentry>
33
 
        <term><varname>rating</varname></term>
34
 
        <listitem>
35
 
          <para>
36
 
            Will store a rating value from 1 (worst) to 5 (best) for a
37
 
            given song.
38
 
          </para>
39
 
        </listitem>
40
 
      </varlistentry>
41
 
 
42
 
      <varlistentry>
43
 
        <term><varname>album_rating</varname></term>
44
 
        <listitem>
45
 
          <para>
46
 
            Will store a rating value from 1 (worst) to 5 (best) for a
47
 
            given album.
48
 
          </para>
49
 
        </listitem>
50
 
      </varlistentry>
51
 
 
52
 
      <varlistentry>
53
 
        <term><varname>style</varname></term>
54
 
        <listitem>
55
 
          <para>
56
 
            This tag is used to keep the Genre tag clean, by now
57
 
            having 1000's of genres.  Instead you define a Main Genre
58
 
            for each file and can make a more specific
59
 
            description. This should be one Keyword like "Post Punk"
60
 
            or "Progressive Death Metal" An Alternative name for this
61
 
            tag is "Subgenre", time will tell which one gets more
62
 
            support.
63
 
          </para>
64
 
        </listitem>
65
 
      </varlistentry>
66
 
 
67
 
      <varlistentry>
68
 
        <term><varname>lyrics</varname></term>
69
 
        <listitem>
70
 
          <para>
71
 
            This one is self explaining. This gives the option to
72
 
            store lyrics of a song where they belong to: mapped to the
73
 
            song
74
 
          </para>
75
 
        </listitem>
76
 
      </varlistentry>
77
 
 
78
 
      <varlistentry>
79
 
        <term><varname>similar_artists</varname> (Comma seperated list of artists)</term>
80
 
        <listitem>
81
 
          <para>
82
 
            This tag enables a last.fm alike aproach which will still
83
 
            work when being offline Keep in mind, that this tag is
84
 
            absolutely non-standard! I am not aware of any other
85
 
            player that uses a comparable tag.
86
 
          </para>
87
 
        </listitem>
88
 
      </varlistentry>
89
 
    </variablelist>
90
 
  </chapter>
91
 
</book>