Symfonium embeds a custom tag parser to create a nice music library from your media tags.
The parser is used for the Local device provider when selected, Samba, WebDAV or the cloud providers.
This custom tag parser is based on Taglib (GitHub - taglib/taglib: TagLib Audio Meta-Data Library ) with a significant amount of post-processing. It’s worth noting that there are numerous tools available to set media tags, and while Symfonium aims to support most use cases, it’s possible that some media may not be properly supported yet. If you encounter such an issue, please open a ticket and provide details about the files in question so that we can improve our support.
Remark: Symfonium embrace Musicbrainz ID as album / artists separators. If only half the tracks of an album have a Musicbrainz ID it will generate 2 different albums by default. You can adjust the behavior in the provider settings.
Tags are supported in a lot of different containers and should be properly mapped to internal data.
List of supported tags
| Tag Name | Description |
|---|---|
| Artist | The artists of the track |
| Artists | Track artists for some tag formats |
| Artist Sort | Sort-friendly artist name |
| Album | The album title |
| Album Sort | Sort-friendly album title |
| Album Artist | The album’s main artist |
| Album Artist Sort | Sort-friendly album artist name |
| Composer | The composers of the track |
| Composer Sort | Sort-friendly composers name |
| Title | The track title |
| Title Sort | Sort-friendly track title |
| Genre | The track’s genres |
| Track Number | The track’s number in the album |
| Disc Number | The disc number in a multi-disc set |
| Compilation | Indicates if the album is a compilation |
| Original Date | The track’s original release date |
| Release Date | The release date of the track or album |
| Label | The record label |
| Mood | The mood of the track |
| Style | The track’s style |
| Comment | User comments |
| BPM | Beats per minute |
| Release | The release type or version |
| Rating | The user rating for the track |
| Language | The language of the track |
| Encoding Time | The time when the track was encoded |
| Disc Subtitle | Subtitle for the disc in multi-disc albums |
| Description | Description of the album |
| Tags | User tags associated with the album |
| Artists Tags | User tags associated with the artists |
| Album Artists Tags | User tags associated with the album artists |
| Composer Tags | User tags associated with the composers |
| Country | Release country |
| Explicit | Explicit content indicator |
| Track Tags | User tags associated with the track |
| MusicBrainz Artist ID | MusicBrainz identifier for the artists |
| MusicBrainz Album ID | MusicBrainz identifier for the album |
| MusicBrainz Album Artist ID | MusicBrainz identifier for album artists |
| MusicBrainz Track ID | MusicBrainz identifier for the track |
Cross-Reference Table: Exposed Tags and File Format-Specific Tags
| Exposed Tag | ID3v2 | Vorbis Comments / Other tag formats | ASF | APE | MP4 |
|---|---|---|---|---|---|
| Artist | TPE1 |
ARTIST |
Author |
ARTIST |
\251ART |
| Artists | - | ARTISTS |
- | ARTISTS |
- |
| Artist Sort | TSOP |
ARTISTSORT, ARTISTSORTORDER |
WM/ArtistSortOrder |
ARTISTSORT |
soar |
| Album | TALB |
ALBUM |
WM/AlbumTitle |
ALBUM |
\251alb |
| Album Sort | TSOA |
ALBUMSORTORDER, ALBUMSORT |
WM/AlbumSortOrder |
ALBUMSORT |
soal |
| Album Artist | TPE2 |
ALBUMARTIST, ALBUM ARTIST, MUSICBRAINZ_ALBUMARTIST |
WM/AlbumArtist, MusicBrainz/Album Artist |
ALBUMARTIST, ALBUM ARTIST, MUSICBRAINZ_ALBUMARTIST |
aART, ----:com.apple.iTunes:albumartists, ----:com.apple.iTunes:ALBUMARTISTS |
| Album Artist Sort | TXXX:ALBUMARTISTSORT |
ALBUMARTISTSORT, ALBUMARTISTSORTORDER, ALBUM ARTIST SORT |
WM/AlbumArtistSortOrder |
ALBUMARTISTSORT |
soaa |
| Composer | TCOM |
COMPOSER |
WM/Composer |
COMPOSER |
\251wrt |
| Composer Sort | TSOC |
COMPOSERSORT |
WM/ComposerSortOrder |
COMPOSERSORT |
soco |
| Title | TIT2 |
TITLE |
Title |
TITLE |
\251nam |
| Title Sort | TSOT |
TITLESORT |
WM/TitleSortOrder |
TITLESORT |
sonm |
| Genre | TCON |
GENRE |
WM/Genre |
GENRE |
\251gen |
| Track Number | TRCK |
TRACKNUMBER, TRACK |
WM/TrackNumber, WM/Track |
TRACKNUMBER, TRACK |
trkn |
| Disc Number | TPOS |
DISCNUMBER, DISC |
WM/PartOfSet |
DISCNUMBER, DISC |
disk |
| Compilation | TCMP |
COMPILATION |
WM/Compilation |
COMPILATION |
cpil |
| Original Date | TDOR |
ORIGINALDATE, ORIGINALYEAR, ORIGINAL RELEASE DATE |
WM/OriginalReleaseYear |
ORIGINALDATE, ORIGINALYEAR |
----:com.apple.iTunes:originaldate, ----:com.apple.iTunes:ORIGINAL RELEASE DATE |
| Release Date | TDRL |
DATE, YEAR, RELEASEDATE, RELEASE DATE |
WM/Year |
YEAR |
\251day, ----:com.apple.iTunes:RELEASEDATE, ----:com.apple.iTunes:RELEASE DATE |
| Label | TPUB |
LABEL |
WM/Publisher |
LABEL |
----:com.apple.iTunes:LABEL |
| Mood | TXXX:MOOD |
MOOD, ALBUMMOOD |
WM/Mood |
MOOD, ALBUMMOOD |
----:com.apple.iTunes:MOOD |
| Style | TXXX:STYLE |
STYLE |
WM/Style |
STYLE |
----:com.apple.iTunes:STYLE |
| Comment | COMM |
COMMENT |
WM/Description |
COMMENT |
\251cmt |
| BPM | TBPM |
BPM |
WM/BeatsPerMinute |
BPM |
tmpo |
| Release | TXXX:RELEASETYPE |
RELEASETYPE |
MusicBrainz/Album Type |
MUSICBRAINZ_ALBUMTYPE |
----:com.apple.iTunes:RELEASETYPE, ----:com.apple.iTunes:MusicBrainz Album Type |
| Rating | POPM |
RATING |
WM/Rating |
RATING |
rate, ----:com.apple.iTunes:RATING |
| Language | TLAN |
LANGUAGE |
WM/Language |
LANGUAGE |
----:com.apple.iTunes:LANGUAGE |
| Encoding Time | TXXX:ENCODINGTIME |
ENCODINGTIME |
WM/EncodingTime |
ENCODINGTIME |
----:com.apple.iTunes:ENCODINGTIME |
| Disc Subtitle | TSST |
DISCSUBTITLE, SETSUBTITLE |
WM/SetSubTitle |
DISCSUBTITLE, SETSUBTITLE |
----:com.apple.iTunes:DISCSUBTITLE, ----:com.apple.iTunes:SETSUBTITLE, ----:com.apple.iTunes:SET SUBTITLE |
| Description | TXXX:DESCRIPTION |
DESCRIPTION |
WM/Description |
DESCRIPTION |
desc |
| Tags | TXXX:TAGS |
TAGS |
WM/Tags |
TAGS |
----:com.apple.iTunes:TAGS |
| Artists Tags | TXXX:ARTISTS_TAGS |
ARTISTS_TAGS |
WM/ArtistsTags |
ARTISTS_TAGS |
----:com.apple.iTunes:ARTISTS_TAGS |
| Album Artists Tags | TXXX:ALBUM_ARTISTS_TAGS |
ALBUM_ARTISTS_TAGS |
WM/AlbumArtistsTags |
ALBUM_ARTISTS_TAGS |
----:com.apple.iTunes:ALBUM_ARTISTS_TAGS |
| Composer Tags | TXXX:COMPOSER_TAGS |
COMPOSER_TAGS |
WM/ComposerTags |
COMPOSER_TAGS |
----:com.apple.iTunes:COMPOSER_TAGS |
| Country | TXXX:COUNTRY |
RELEASECOUNTRY, MUSICBRAINZ_ALBUM_RELEASE_COUNTRY, MUSICBRAINZ_ALBUMRELEASECOUNTRY |
MusicBrainz/Album Release Country |
MUSICBRAINZ_ALBUMRELEASECOUNTRY |
----:com.apple.iTunes:RELEASECOUNTRY, ----:com.apple.iTunes:MusicBrainz Album Release Country |
| Explicit | TXXX:ITUNESADVISORY |
ITUNESADVISORY |
WM/ParentalRating |
ITUNESADVISORY |
rtng |
| Track Tags | TXXX:TRACK_TAGS |
TRACK_TAGS |
WM/TrackTags |
TRACK_TAGS |
----:com.apple.iTunes:TRACK_TAGS |
| MusicBrainz Artist ID | TXXX:MUSICBRAINZ_ARTISTID |
MUSICBRAINZ_ARTISTID |
MusicBrainz/Artist Id |
MUSICBRAINZ_ARTISTID |
----:com.apple.iTunes:MUSICBRAINZ_ARTISTID |
| MusicBrainz Album ID | TXXX:MUSICBRAINZ_ALBUMID |
MUSICBRAINZ_ALBUMID |
MusicBrainz/Album Id |
MUSICBRAINZ_ALBUMID |
----:com.apple.iTunes:MUSICBRAINZ_ALBUMID |
| MusicBrainz Album Artist ID | TXXX:MUSICBRAINZ_ALBUMARTISTID |
MUSICBRAINZ_ALBUMARTISTID |
MusicBrainz/Album Artist Id |
MUSICBRAINZ_ALBUMARTISTID |
----:com.apple.iTunes:MUSICBRAINZ_ALBUMARTISTID |
| MusicBrainz Track ID | TXXX:MUSICBRAINZ_TRACKID |
MUSICBRAINZ_TRACKID |
MusicBrainz/Track Id |
MUSICBRAINZ_TRACKID |
----:com.apple.iTunes:MUSICBRAINZ_TRACKID |
Separators
To support older tags and multiple values entered as single values, some separators are applied to the data.
Those separators can be configured in the provider settings too.