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 |
| Album Version | Version or edition information for the album |
| Media Type | The physical or digital media type |
| 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 |
| Movement Name | Name of the movement in a classical work |
| Movement Number | Number of the movement in a classical work |
| Grouping | Grouping or content group for the track |
| Occasion | Occasion associated with the track |
| Original Album | The original album title |
| Original Artist | The original artist of the track |
| Style | The track’s style |
| Comment | User comments |
| BPM | Beats per minute |
| Release | The release type or version |
| Release Status | The MusicBrainz release status |
| 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 |
| Work | Larger work the track belongs to |
| Year | The year value found in the tags |
| 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 |
| Cue Sheet | Embedded cue sheet |
| Love Rating | MusicBee love rating |
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 |
| Album Version | TXXX:ALBUMVERSION, TXXX:VERSION, TXXX:MUSICBRAINZ_ALBUMCOMMENT, TXXX:MUSICBRAINZ ALBUM COMMENT | ALBUMVERSION, VERSION, MUSICBRAINZ_ALBUMCOMMENT, MUSICBRAINZ ALBUM COMMENT | WM/AlbumVersion, WM/Version, MusicBrainz/ AlbumComment, MusicBrainz/Album Comment | ALBUMVERSION, VERSION, MUSICBRAINZ_ALBUMCOMMENT, MUSICBRAINZ ALBUM COMMENT | ----:com.apple.iTunes:ALBUMVERSION, ----:com.apple.iTunes:VERSION, ----:com.apple.iTunes:MUSICBRAINZ_ALBUMCOMMENT,
----:com.apple.iTunes:MUSICBRAINZ ALBUM COMMENT |
| Media Type | TMED, TXXX:MEDIA, TXXX:MEDIA TYPE, TXXX:MEDIATYPE | MEDIA, MEDIA TYPE, MEDIA_TYPE, MEDIATYPE | WM/Media, WM/MediaType
| MEDIA, MEDIATYPE, MEDIA TYPE | ----:com.apple.iTunes:MEDIA, ----:com.apple.iTunes:MEDIA_TYPE, ----:com.apple.iTunes:MEDIA TYPE |
| 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 |
| Movement Name | MVNM, TXXX:MOVEMENTNAME | MOVEMENTNAME | WM/MovementName
| MOVEMENTNAME | \251mvn, ----:com.apple.iTunes:MOVEMENTNAME |
| Movement Number | MVIN, TXXX:MOVEMENTNUMBER | MOVEMENT, MOVEMENTNUMBER | WM/MovementNumber
| MOVEMENTNUMBER | \251mvi, ----:com.apple.iTunes:MOVEMENTNUMBER |
| Grouping | GRP1, TXXX:GROUPING, TXXX:CONTENTGROUP | GROUPING, CONTENTGROUP | Wm/Grouping, WM/ContentGroup
| GROUPING, CONTENTGROUP | \251grp, ----:com.apple.iTunes:GROUPING, ----:com.apple.iTunes:CONTENTGROUP |
| Occasion | TXXX:OCCASION | OCCASION | WM/Occasion
| OCCASION | ----:com.apple.iTunes:OCCASION |
| Original Album | TOAL, TXXX:ORIGINALALBUM, TXXX:ORIGALBUM | ORIGINALALBUM, ORIGALBUM | WM/OriginalAlbum
| ORIGINALALBUM, ORIGALBUM | ----:com.apple.iTunes:ORIGINALALBUM |
| Original Artist | TOPE, TXXX:ORIGINALARTIST, TXXX:ORIGARTIST | ORIGINALARTIST, ORIGARTIST | WM/OriginalArtist
| ORIGINALARTIST, ORIGARTIST | ----:com.apple.iTunes:ORIGINALARTIST |
| 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 |
| Release Status | TXXX:RELEASESTATUS, TXXX:MUSICBRAINZ ALBUM STATUS | RELEASESTATUS, MUSICBRAINZ_ALBUMSTATUS | MusicBrainz/Album Status
| MUSICBRAINZ_ALBUMSTATUS | ----:com.apple.iTunes:RELEASESTATUS, ----:com.apple.iTunes:MusicBrainz Album Status |
| 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 |
| Work | TIT1, TXXX:WORK | WORK | WM/Work
| WORK | \251wrk, ----:com.apple.iTunes:WORK |
| Year | TXXX:YEAR | DATE, YEAR | WM/Year
| YEAR | \251day, ----:com.apple.iTunes:YEAR |
| 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 | - |
| Cue Sheet | - | CUESHEET | -
| - | - |
| Love Rating | TXXX:LOVE RATING, TXXX:LOVE_RATING | LOVE RATING | musicbee/LOVE RATING
| LOVE RATING | ----:com.apple.iTunes:LOVERATING |
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.