Overview

Meta-data is information set in files which describe the file. For example, title, artist, version, year etc. Most modern audio formats support some degree of meta-data.

Wagtail allows the setting of arbitrary meta-data through the use of the details file and matching commands specified in format.conf.

The meta-data fields used and their semantic meaning is completely up to the administrator of a Wagtail setup. However, this page details the fields considered by the default configuration files and the implied meaning. Note that the defaults supplied vary from version-to-version of Wagtail and you may need to update your configuration files to make use of these fields.

These fields refer to the details file names, in some cases the matching command in format.conf will use a different key when setting the meta-data in the file. For example, the command for disc-title writes into a field named "ALBUM" on FLAC and OGG/Vorbis files.

Meta-data list

Field Description
artist Generally the name of the band or solo-artist. For classical music this is the composer.
contact Contact information for the owner of the track.
copyright Copyright information for the track.
description General purpose description of the file. Use this for data which doesn't fit in any other category.
disc-artist Like artist but for the disc the file comes from not the file itself. For example, a particular file may have a disc-artist value of "Various" and an artist value of "Main Street Singers".
disc-class The kind of disc the track comes from. Example values include "Single", "EP" and "Promo". For albums this field is left blank.
disc-id A copy of the CDDB ID.
disc-month The month the disc was released.
disc-multiartist Set to 1 if the file comes from a multiple artist disc, 0 otherwise.
disc-number The number of the disc in multiple volume sets.
disc-pretitle Disc version of pretitle.
disc-subtitle Disc version of subtitle.
disc-title The main title of the disc or album. If the pre/sub-title scheme is being used, this field excludes any bracketed sections.
disc-year The year the disc was released.
featuring Supplemental artists who appear on the track.
genre The musical genre of the track.
isrc The ISRC number for the track.
license The licence the track is released under.
location The place the track was recorded.
lyrics The lyrics for the track, or a pointer to the lyrics.
month The month the track was recorded.
organization The organisation responsible for releasing the track, e.g. the record label.
performer For classical music, the person who performed on this recording. So the artist may be "Bach" but the performer "Andre Previn".
pretitle For titles which featuring a leading section in brackets, this is the section in brackets. If the full title of a track is "(You've got to) Smile", the pretitle is "You've got to".
subtitle For titles which featuring a trailing section in brackets, this is the section in brackets. If the full title of a track is "Not now (Not ever)", the subtitle is "Not ever".
title The main title of the track. If the pre/sub-title scheme is being used, this field excludes any bracketed sections.
track The number of this track within the disc.
track-total The total number of tracks on the disc.
version The version of the track, e.g. "12 inch mix", "Instrumental" etc.
year The year the track was recorded.