Initialization

1 files changed, 202 insertions, 0 deletions

diff --git a/tags_convention.txt b/tags_convention.txt
new file mode 100644
index 0000000..fee237e
--- /dev/null
+++ b/tags_convention.txt
@@ -0,0 +1,202 @@
+
+Singleton tags, which should only appear once. If one of these tags
+appears more than once, its last appearance should be displayed if there
+is only room to display one instance of the tag.
+
+ALBUM
+    If appropriate, an album name, e.g., `Days Of Future Passed' or
+    `Beethoven: Symphonies Nos. 1-9'.
+
+*AKA
+    An alternative title e.g., `Choral' for the Beethoven's ninth or
+    `Njósnavélin' for the 4th song of the album `( )' by `Sigur Rós'.
+
+ARTIST
+    For information to be displayed on systems with limited display
+    capabilities. It is not a replacement for the ENSEMBLE and PERFORMER
+    tags, but typically will summarize them e.g., `The Beach Boys'. May
+    not be appropriate for classical music (see ENSEMBLE and PERFORMER
+    instead).
+
+PUBLISHER
+    Who publishes the disc the track came from.
+
+*COMPILATION
+    Should be set to 1 if the album is a compilation.
+
+*COLLECTION
+    If the album belongs to a particular collection, put its name there
+    e.g., `Les incontournables du Jazz'.
+
+COPYRIGHT
+    Who holds copyright to the track or disc the track is on.
+
+DISCNUMBER
+    If part of a multi-disc album, put the disc number here. If the disc
+    has a name, it should be set in VOLUME.
+    You can use any format you like, such as Roman numerals, regular
+    numbers, or whatever. The numbers such as Roman numerals, regular
+    numbers, or whatever.  The numbers should be entered in such a way
+    that an alphabetical sort on this tag will correctly show the proper
+    ordering of all the oggs that contain the tag.
+
+ISRC
+    This number lets you order a CD over the phone from a record shop.
+
+*EDITION
+    If disc is a remastered / reissue edition, put it there e.g.
+    `digitally remastered' or `limited'. Don't put any DATE information
+    there.
+
+EAN/UPN
+    There may be a barcode on the CD; it is most likely an EAN or UPN
+    (Universal Product Number).
+
+*KEY
+    The key signature of the track e.g., `E-flat major' or `D minor'. If
+    changes inside, for example, a movement, the "local key" may be
+    written inside the PART.
+
+LABEL
+    The record label or imprint on the disc e.g., `Mercury Records'.
+
+LABELNO
+    Record labels often put the catalog number of the source media
+    somewhere on the packaging. Use this tag to record it.
+
+LICENSE
+    The license, or URL for the license the track is under. For
+    instance, the Open Audio license.
+
+*LIVE
+    Should be set to 1 if the track is a live performance.
+
+OPUS
+    The number of the work; e.g., `10', `BWV 81' or `KV 6'. Sould
+    finish by a number.
+
+SOURCEMEDIA
+    The recording media the track came from. e.g., `CD', `Cassette',
+    `Radio Broadcast', `LP', `CD Single', `Bootleg', `Hybrid SACD' or
+    `Enhanced CD'.
+
+TITLE
+    "The work", whether a symphony, or a pop song e.g., `Symphony No. 5'
+    or `Lucy In The Sky With Diamonds'.
+
+TRACKNUMBER
+    The track number on the CD, e.g., `03'. Should be a number.
+
+VERSION
+    Make sure you don't put DATE or LOCATION information in this tag.
+    `live', `acoustic', `radio edit', `12 inch remix' or `featuring Ray
+    Charles' might be typical values of this tag.
+
+*VOLUME
+    If part of a multi-disc album, put the disc name here e.g.,
+    `Original album' or `Bonus disc'.
+
+ENCODED-BY
+    The person who encoded the Ogg file. May include contact
+    information such as email address and phone number.
+
+ENCODING
+    Put the settings you used to encode the Ogg file here. This tag is
+    NOT expected to be stored or returned by CDDB type databases. It
+    includes information about the quality setting, bit rate, and
+    bitrate management settings used to encode the Ogg.  It also is
+    used for information about which encoding software was used to do
+    the encoding.
+
+
+
+
+The remaining tags are multiples; if they are present more than once,
+all their occurances are considered significant.
+
+COMPOSER
+    Composer of the work e.g., `Gustav Mahler' or `Jimi Hendrix'.
+
+ARRANGER
+    The person who arranged the piece e.g., `Joseph Maurice Ravel'. Can
+    be set to `traditional' if appropriate.
+
+LYRICIST
+    The person who wrote the lyrics if differs to the composer e.g.,
+    `Gaetano Donizetti'.
+
+AUTHOR
+    For text that is spoken, or was originally meant to be spoken, the
+    author e.g., `John Ronald Reuel Tolkien'.
+
+CONDUCTOR
+    Conductor of the work; e.g., `Herbert von Karajan'. Choir directors
+    would also use this tag.
+
+PERFORMER
+    Individual performers singled out for mention with their instrument
+    e.g., `Yoyo Ma (cello)' or `David Gilmour (electric & acoustic
+    guitars, vocals)'.
+
+ENSEMBLE
+    The group performing the piece, when different from ARTIST. For
+    example, this would be the orchestra in classical works e.g.,
+    `London Symphony Orchestra'.    
+
+PART
+    A division within a work; e.g., a movement of a symphony. Some
+    tracks contain several parts. Use a single PART tag for each part
+    contained in a track. e.g., `movement 2. Andante in F major' or
+    `a. Your Move'. Datas should be entered in a should be entered in
+    such a way that an alphabetical sort on this tag will correctly
+    show the proper ordering of the parts.
+
+*PARTNUMBER
+    If the part has no name but but only an index, it can be put here.
+    Can be a range has well e.g., `1-9', and you can use any format you
+    like, such as Roman numerals, regular numbers, or whatever.
+    The numbers should be entered in such a way that an alphabetical sort
+    on this tag will correctly show the proper ordering of all the oggs
+    that contain the contain the piece of music.
+
+GENRE
+    Like the genre tag from the CDDB but without the limitations. You
+    can put any genre you want in this tag. If you think "Pink Floyd"
+    are a genre unto themselves, say so here. For crossover works, or
+    ambiguous works, use as many GENRE tags as you think it takes to
+    describe the styles used.
+
+*DATE
+    Date or date-time of relevance to the track. The date must be in
+    ISO 8601 format, but may be followed by a space character, then any
+    text you wish, including the same date in any other format. If there
+    is no detail e.g., `1968', it should be the the date of the original
+    release of the album.
+    Examples:
+    DATE=2002-11-04/03-08-24 recorded
+    DATE=1969-11-27/28 recorded
+    DATE=1791-09-30 premièred
+    DATE=1811/12 composed
+    DATE=2003 reissued
+    DATE=1967 released
+
+LOCATION
+    Location of recording e.g., `Madison Square Garden, New York City, NY'.
+
+COMMENT
+    Additional comments of any nature e.g., `Bonus track'.
+
+
+
+The fields related to album information i.e., ALBUM, EDITION, PUBLISHER,
+ISRC, EAN/UPN, LABEL, LABELNO, SOURCEMEDIA, should be the same for every
+track in an album.
+
+
+
+References:
+  [1] Ogg Vorbis Documentation
+http://www.xiph.org/vorbis/doc/v-comment.html
+  [2] VorbisComment http://wiki.xiph.org/index.php/VorbisComment
+  [3] Ogg Vorbis Comment Field Recommendations
+http://age.hobba.nl/audio/mirroredpages/ogg-tagging.html