Skip to content

List of supported tags

Tags are parsed using TagLib v2. Tag names in the below table are as they are returned by TagLib.

If alternate tags exist for a given value the first tag in the list that exists is used and all other alternatives are ignored.

TagAlternativesDescription
CROSSONIC_ID_*-The crossonic song ID for the given instance. Written automatically by crossonic-server. Can be removed using the admin CLI.
TITLE-The name of the song.
MUSICBRAINZ_TRACKID-The MusicBrainz ID of the song.
LYRICSUNSYNCEDLYRICSThe lyrics of the song.
COMPILATION-Whether the album is a compilation.
ALBUM-The name of the album of the song.
MUSICBRAINZ_RELEASEGROUPID-The MusicBrainz ID of the album.
MUSICBRAINZ_ALBUMID-The MusicBrainz ID of the specific release of the album.
ARTISTSARTISTThe name of an artist of the song. Multiple tags supported. Order is preserved.
ALBUMARTISTSALBUM_ARTISTS, albumartist, album_artistThe name of an artist of the album. Multiple tags supported. Order is preserved.
MUSICBRAINZ_ARTISTIDSMUSICBRAINZ_ARTISTIDThe MusicBrainz ID of an artist of the song. Multiple tags supported. Order should match artist tags.
MUSICBRAINZ_ALBUMARTISTIDSMUSICBRAINZ_ALBUMARTISTIDThe MusicBrainz ID of an artist of the album. Multiple tags supported. Order should match albumartist tags.
ORIGINALDATEORIGINALYEAR, DATE, YEARUsed to extract the original release date.
RELEASEDATERELEASEYEAR, DATE, YEAR, ORIGINALDATE, ORIGINALYEARUsed to extract the release date.
GENRESGENREA genre of the song. Multiple tags supported.
TRACKNUMBER-The track number of the song on the album.
DISCNUMBER-The number of the disc the song is on.
DISCSUBTITLE-The name of the disc the song is on. Requires discnumber.
RELEASETYPESRELEASETYPEA release type of the album, e.g. album, single, ep, live, …. Multiple tags supported.
BPM-The BPM of the song.
REPLAYGAIN_TRACK_GAIN-ReplayGain: the gain of the song.
REPLAYGAIN_TRACK_PEAK-ReplayGain: the peak of the song.
REPLAYGAIN_ALBUM_GAIN-ReplayGain: the gain of the album.
REPLAYGAIN_ALBUM_PEAK-ReplayGain: the peak of the album.
LABELSLABELA record label of the album. Multiple tags supported.
ALBUMVERSIONVERSIONThe release version (e.g. Deluxe, Remastered 2006, …)

Additionally the following properties are extracted from the file:

  • Length of the song
  • Bit rate of the file
  • Sample rate of the file
  • Channel count of the file
  • Cover art