MusicBrainz Picard/Tags: Difference between revisions

From MusicBrainz Wiki
Jump to navigationJump to search
(→‎Basic Variables: these are available for other formats as well)
(manually redirecting anyone naughtily linking to the wiki instead of /doc/)
 
Line 1: Line 1:
#REDIRECT [[MusicBrainz Picard]]
This page describes both Tags (which are saved inside your music files and can be read by your music player) and Picard variables which can be used in Picard scripts (for tagging, for file renaming and in several other more minor settings).

All tags are also available as variables, but additional variables which start with '_' are not saved as Tags within your music files.

Variable are used in scripts by wrapping the name between '%' character e.g. '%title%'.

Some variables can contain more than one value (for example, <tt>musicbrainz_artistid</tt>), and if you want to use only one of the values then you will need to use special [[Picard Scripting|script functions]] to access / set them. To access all the multiple values at one, use the variable normally and Picard will combine them into a single string separated by '; ' (semicolon space).

If a later version of Picard is shown here than the current official version on the [[MusicBrainz Picard]] page, then these are beta functionality which will be available in the next official release and a description of how to gain access to these beta versions for testing can also be found on the [[MusicBrainz Picard]] page.

== Basic Tags ==
The following tags are populated from MusicBrainz data for most releases, without any special Picard settings.

All of these are also available as variables for use in Picard Scripts (for tagging, for file renaming and in several other more minor settings) by wrapping them between '%' symbols e.g. '%title%'.

{| border="1"
|-
| title || [[Track Title]]
|-
| artist || [[Track Artist]] Name(s) (string)
|-
| artists || [[Track Artist]] Name(s) (multi-value) (since Picard 1.3)
|-
| artistsort || Track [[Style/Artist/Sort Name|Artist Sort Name]]
|-
| albumartist || [[Release Artist]]
|-
| albumartistsort || [[Release Artist]]'s [[Style/Artist/Sort Name|Sort Name]]
|-
| releasestatus || [[Release Status]]
|-
| releasetype || [[Release Group/Type|Release Group Type]] (see also _primaryreleasetype / _secondaryreleasetype)
|-
| album || [[Release#Title|Release Title]]
|-
| asin || [[ASIN]]
|-
| language || [[Work]] lyric language as per [http://www.sil.org/iso639-3 ISO 639-3] '''if''' track relationships are enabled in Options '''and''' a related work exists. (since Picard 0.10)
|-
| script || [[Release_Language#Language_and_script|Release Script]] (since Picard 0.10)
|-
| releasecountry || [[Release Country]]
|-
| date || [[Release Date]] (YYYY-MM-DD)
|-
| originaldate || Original [[Release Date]] (YYYY-MM-DD) of the earliest release in the [[Release Group]] intended to provide e.g. the release date of the vinyl version of what you have on CD. (Included as standard from Picard 0.15, and using the Original Release Date plugin if you are '''still''' using a non-NGS version earlier than Picard 0.15)

Note: If you are storing tags in mp3 files as ID3v23 (which is the Windows / iTunes compatible version) then original date can only be stored as a year.
|-
| catalognumber || Release [[Catalog Number]](s)
|-
| label || Release [[Label Name]](s)
|-
| barcode || Release [[Barcode]]
|-
| media || [[Release Format]]
|-
| discnumber || [[Disc Number]] of the disc in this release that this track is on
|-
| totaldiscs || Total number of discs in this release
|-
| discsubtitle || The [[Release Status#Title_2|Media Title]] given to a specific disc.
|-
| tracknumber || Track number on the disc
|-
| totaltracks || Total tracks on this disc
|-
| isrc || [[ISRC]] (since Picard 0.12)
|-
| compilation || (since Picard 1.3, compatible with iTunes) 1 for Various Artist albums, 0 otherwise
(Picard 1.2 or previous) 1 if multiple track artists (including featured artists), 0 otherwise
|-
| musicbrainz_trackid || [[Recording]] [[MusicBrainz Identifier]]
|-
| musicbrainz_releasetrackid || [[Release]] Track [[MusicBrainz Identifier]] (since Picard 1.3)
|-
| musicbrainz_artistid || [[Track Artist]]'s [[MusicBrainz Identifier]]
|-
| musicbrainz_albumid || [[Release]] [[MusicBrainz Identifier]]
|-
| musicbrainz_albumartistid || [[Release Artist]]'s [[MusicBrainz Identifier]]
|-
| musicbrainz_discid || [[Disc ID]] if album added using CD Lookup (since Picard 0.12)
|
|}

== Basic Variables ==
These variables are also populated from MusicBrainz data for most releases, without any special Picard settings.

{| border="1"
|-
| _albumtracknumber || The absolute number of this track disregarding the disc number i.e. %_albumtracknumber% of %_totalalbumtracks% (c.f. %tracknumber% of %totaltracks%). (Since Picard 1.3)
|-
| _totalalbumtracks || The total number of tracks across all discs of this release.
|-
| _releasecomment || [[Release#Disambiguation_comment|Release disambiguation comment]] (since Picard 0.15)
|-
| _releaselanguage || [[Release_Language#Language_and_script|Release Language]] as per [http://www.sil.org/iso639-3 ISO 639-3] (since Picard 0.10)
|-
| _releasegroup || [[Release_Group#Title|Release Group Title]] which is typically the same as the Album Title, but can be different.
|-
| _releasegroupcomment || [[Release_Group#Disambiguation_comment|Release Group disambiguation comment]].
|-
| _primaryreleasetype || [[Release_Group/Type#Primary_types|Release Group Primary type]] i.e. Album, Single, EP, Broadcast, Other.
|-
| _secondaryreleasetype || Zero or more [[Release_Group/Type#Secondary_types|Release Group Secondary types]] i.e. Audiobook, Compilation, DJ-mix, Interview, Live, Mixtape/Street, Remix, Soundtrack, Spokenword
|-
| _length || The length of the track in format mins:secs.
|-
| _rating || [[Rating System|Rating]] 0-5 by Musicbrainz users
|-
| _dirname || The name of the directory the file is in at the point of being loaded into Picard. (Since Picard 1.1)
|-
| _filename|| The name of the file without extension (since Picard 1.1)
|-
| _extension || The files extension (since Picard 0.9)
|-
| _format || Media format of the file e.g. <code>MPEG-1 Audio</code>
|-
| _bitrate || Approximate bitrate in kbps.
|-
| _channels || No. of audio channels in the file
|-
| _sample_rate || Number of digitising samples per second Hz
|-
| _bits_per_sample || Bits of data per sample
|-
| _multiartist || 0 if tracks on the album all have the same primary artist, 1 otherwise. (Since Picard 1.3)
|
|}

== Advanced Tags ==
If you enable tagging with [[Advanced Relationship]]s, you get these extra tags:
{| border="1"
|-
| work || [[Work|Work Name]] (since Picard 1.3)
|-
| writer || [[rt:a255bca1-b157-4518-9108-7b147dc3fc68|Writer Relationship Type]] (since Picard 1.0; not written to most file formats automatically<ref>You can merge this with composers with a [[Picard Scripting|script]] like <pre>$copymerge(composer, writer)</pre></ref>).
|-
| composer || [[rt:d59d99ea-23d4-4a80-b066-edca32ee158f|Composer Relationship Type]]
|-
| conductor || Conductor Relationship Type ([[rt:9ae9e4d0-f26b-42fb-ab5c-1149a47cf83b|releases]], [[rt:234670ce-5f22-4fd0-921b-ef1662695c5d|recordings]]), Chorus Master Relationship Type ([[rt:b9129850-73ec-4af5-803c-1c12b97e25d2|releases]], [[rt:45115945-597e-4cb9-852f-4e6ba583fcc8|recordings]])
|-
| performer:<type> || Performer Relationship Type ([[rt:888a2320-52e4-4fe8-a8a0-7a4c8dfde167|releases]] - [[rt:eb10f8a0-0f4c-4dce-aa47-87bcb2bc42f3|vocals]]/[[rt:67555849-61e5-455b-96e3-29733f0115f5|instruments]], [[rt:628a9658-f54c-4142-b0c0-95f031b544da|recordings]] - [[rt:0fdbe3c6-7700-4a31-ae54-b53f06ae1cfa|vocals]]/[[rt:59054b12-01ac-43ee-a618-285fd397e461|instruments]]),
Orchestra Relationship Type ([[rt:23a2e2e7-81ca-4865-8d05-2243848a77bf|releases]], [[rt:3b6616c5-88ba-4341-b4ee-81ce1e6d7ebb|recordings]]),
<type> can be "orchestra", "vocal", "guest guitar", ...
|-
| arranger || [[Arranger Relationship Type]],
[[Instrumentator Relationship Type]],
[[Orchestrator Relationship Type]] (since Picard 0.10)
|-
| lyricist || [[rt:3e48faba-ec01-47fd-8e89-30e81161661c|Lyricist Relationship Type]]
|-
| remixer || [[Remixer Relationship Type]]
|-
| producer || [[Producer Relationship Type]]
|-
| engineer || [[Engineer Relationship Type]]
|-
| mixer || [[Engineer Relationship Type]] ("Mixed By") (since Picard 0.9)
|-
| djmixer || [[Mix-DJ Relationship Type]] (since Picard 0.9)
|-
| license || License Relationship Type ([[rt:004bd0c3-8a45-4309-ba52-fa99f3aa3d50|releases]], [[rt:f25e301d-b87b-4561-86a0-5d2df6d26c0a|recordings]]) (since Picard 1.0)
|}

And if you enable folksonomy tags, you get:
{| border="1"
|-
| genre || Pseudo-genre based on folksonomy tags
|}

== Advanced Variables ==
If you enable tagging with [[Advanced Relationship]]s, you get these extra variables:

{| border="1"
|-
| _recordingtitle || [[Recording]] title - normally the same as the Track title, but can be different.
|-
| _recordingcomment || [[Recording#Disambiguation_comment|Recording disambiguation comment]] (since Picard 0.15)
|
|}

==Plugins==

Plugins from [[Picard Plugins]] can add more tags.

===Last.fm===

{| border="1"
|-
| genre || Pseudo-genre based on folksonomy tags
|}

===Last.fm Plus===
The [[LastFMPlus]] plugin is a sophisticated plugin that tries to provide stable and meaningful genre selections from the ever-changing and idiosyncratic list provided by lastFM.

The LastFMPlus plugin is very configurable and examples provided here are based on the default lists provided on the Tag Filter List tab of the LastFMPlus options page.

{| border="1"
|-
| grouping || Top-level genres - default list: Audiobooks, Blues,
Classic rock, Classical, Country, Dance, Electronica, Folk, Hip-hop,
Indie, Jazz, Kids, Metal, Pop, Punk, Reggae, Rock, Soul, Trance
|-
| genre || Specific detailed genres, e.g. if group is Rock, genre
could be one of Acid rock, Acoustic rock, Alternative metal,
Alternative rock, Art rock, Blues rock, Boogie rock, Brit rock,
Christian rock, College rock, Country rock etc.
|-
| mood || How a track 'feels' e.g. Happy, Introspective, Drunk etc.
|-
| Comment:songs-db_Occassion || Good situations to play a track e.g. Driving, Love, Party etc.
|-
| Comment:songs-db_Custom1 || Decade e.g. 1970s
|-
| Comment:songs-db_Custom2 || Category e.g. Female Vocalist, Singer-Songwriter etc.
|-
| Comment:songs-db_Custom3 || Country e.g. British
|-
| Original Year || Original Year that the track was released
(compared to Original Release Date, the earliest release date of the entire Album)
|}

Note 1: This plugin makes a large number of web services calls to get track-specific data, so loading a large number of albums / tracks could take a significant amount of time.

Note 2: Original Year does not seem to be working correctly at present.
==Other Information==

For technical details on how these tags are written into files, see [[Picard Tag Mapping]].

If you set new variables, these will be saved as new tags in ID3, APEv2 and VORBIS based files. For ID3 based files these will be saved to, and reloaded from, ID3 user defined text information (TXXX) frames. They will not be saved in ASF, MP4 or WAV based files.

For ID3 based tags i.e. mp3 files, you can also set ID3 tags directly from your scripts by setting a special variable starting '_id3:'. Currently these tags are not loaded into variables when you reload the file into Picard.</code>. (Since Picard 0.9)

==Footnotes==

<references />

[[Category:MusicBrainz Picard]] [[Category:WikiDocs Page]]

Latest revision as of 21:16, 25 November 2014

Redirect to: