Internal Tags¶
Quod Libet stores a number of tags internally, that are either not stored in files themselves, or are derived from the values in the files.
String Tags¶
~basename
: The last component of the full path name~dirname
: Everything but the last component of the file path name~filename
: The full path name~format
: The file format (e.g. “MPEG-4”)~codec
: The audio codec (e.g. “AAC LC”)~encoding
: Encoder name, version, settings used (e.g. “LAME 3.97.0, VBR”)~length
: The length of the file in H:MM:SS format~mountpoint
: The component of the full path name that corresponds to the file’s immediate parent mount~performers
: A list of performers, including roles~people
: A list of all people involved in the song~rating
: A string representation of the song’s rating (e.g. ★★★☆)~uri
: The full URI of the song~year
: The release year, derived from thedate
tag~originalyear
: The original year, derived from theoriginaldate
tag~playlists
: Comma-separated playlist names in which the song is included~filesize
: Human formatted size (e.g. 4.5 MB)
The ~people
Internal Tag¶
The internal ~people
tag combines the following tags to one:
albumartist
, artist
, author
, composer
, ~performers
,
originalartist
, lyricist
, arranger
, conductor
in this exact
order.
For sorting, this means that all album artists come first followed by all artists and so on. For song collections / albums, the values of each included tag are sorted by frequency.
Note there is a ~people:real
specialisation
added in #1034 which
excludes Various Artists, commonly used as a placeholder for album artists
on compilations, etc.
Song Collections / Albums¶
~length
: The length of all songs in H:MM:SS format~long-length
: The length of all songs in “H hours, M minutes, S seconds” format~tracks
: The real number of songs in the collection in “# track(s)” format~discs
: The number of different discs in “# disc(s)” format~rating
: The average rating in music notes~filesize
: Total Human formatted size (e.g. 4.5 MB)
All other tags return a list of values retrieved from all songs, without duplicates, sorted by their number of appearance.
Numeric Tags¶
~#added
: The date the song was added to the library~#bitrate
: The bitrate of the song, in kilo bits per second~#disc
: The disc number of the song (the first half of thediscnumber
tag)~#discs
: The total number of discs in this song’s collection~#filesize
: The size in bytes of this song~#lastplayed
: The time this song was last played through~#laststarted
: The time this song was last started~#length
: The length of the song, in seconds~#mtime
: The time this file was last modified~#playcount
: The total number of times you’ve played the song through~#rating
: The rating of the song, as a number between 0 and 1.~#skipcount
: The total number of times you’ve skipped through the song~#track
: The track number of the song (the first half of thetracknumber
tag)~#tracks
: The total number of tracks in the album~#year
: The release year, derived from thedate
tag~#originalyear
: The original year, derived from theoriginaldate
tag
Note some numeric tags have string tag equivalents (see above) for human-readable format.
Song Collections / Albums¶
~#tracks
: The real number of songs in the collection~#discs
: The number of different discs in the collection~#filesize
: The total filesize of all songs in the collection
For all other numeric tags it is possible to define numeric functions by
appending :numeric_func
to the tag name (~#playcount:avg
for example).
All internal numeric tags use a default function in case no function is
given. For user defined numeric tags the average value is returned by
default.
avg
: Returns the average value (~#rating
)
sum
: Returns the summation of all values (~#length
,~#playcount
,~#skipcount
)
min
: Returns the smallest value (~#year
)
max
: Returns the largest value (~#added
,~#lastplayed
,~#laststarted
,~#mtime
)
bav
: Returns the Bayesian average value (~#rating
)Being most appropriate for ratings, it is adjusted globally under the preferences for ratings.