Skip to content

Music Assistant draws on two layers of metadata. Source metadata comes from wherever the media item actually lives — embedded file tags, .lrc and .nfo files, and music providers such as Plex, Jellyfin, Subsonic, Spotify or Tidal. Online metadata providers (Fanart.tv, The Audio DB, MusicBrainz, Cover Art Archive, iTunes Artwork, LRCLIB, Genius) are dedicated third-party services queried only to fill in fields the source did not supply. Source metadata is always preferred; online metadata is complementary.

Metadata TypeSource(s)
Name, sort nameFile tags, artist.nfo, music providers
Genresartist.nfo, music providers, The Audio DB, derived from track tags when the filesystem provider’s Propagate track genres option is enabled
MusicBrainz ID (MBID)File tags, artist.nfo, music providers, derived via MusicBrainz lookup if missing
Biographyartist.nfo (<biography>), music providers, The Audio DB
Style, mood, labelThe Audio DB
Images (thumb, logo, banner, fanart, cutout, landscape, clearart)Embedded tags, folder images, music providers, Fanart.tv, The Audio DB
Links (website, Facebook, Twitter, Last.fm)The Audio DB

The MusicBrainz Artist ID is the key that unlocks all online artist enrichment. When no MBID can be determined for an artist (typically because none of the artist’s tracks or albums matched), no online bio or imagery is fetched. Adding the MBID to file tags or to an artist.nfo is the most reliable fix.

Note that the embedded genre tag in audio files is applied to the track only, not to the album or the artist. To get genres on an album or artist itself, either supply an album.nfo / artist.nfo, rely on an online metadata provider (which for artists requires an MBID), or enable Propagate track genres to albums and artists on the local filesystem provider, which derives them from the tracks’ tags.

Propagation only fills genres that are still empty and never overwrites a genre that came from another source. Apart from propagation, sources merge their genres into whatever is already there — an artist.nfo genre plus genres returned by The Audio DB will both end up on the artist.

Metadata TypeSource(s)
Name, sort name, year, album typeFile tags, album.nfo, music providers
Genresalbum.nfo, music providers, The Audio DB, derived from track tags when the filesystem provider’s Propagate track genres option is enabled
MusicBrainz Release Group / Album IDFile tags, album.nfo, music providers
Description / reviewalbum.nfo (<review>), music providers, The Audio DB
Style, mood, labelThe Audio DB
Links (Wikipedia, AllMusic, Last.fm, social)The Audio DB
Front cover, disc artSee Artwork
Metadata TypeSource(s)
Title, version, artists, album, disc / track number, duration, yearFile tags, music providers
MusicBrainz Recording ID, ISRC, barcodeFile tags, music providers
Genres, mood, style, descriptionFile tags, music providers, The Audio DB
Explicit flag, copyright, grouping, commentFile tags, music providers
LyricsSee Lyrics
Volume normalization valueSee Loudness Analysis

Playlists don’t have rich metadata of their own; instead Music Assistant derives:

  • Thumbnail See Artwork
  • The top genres present across the playlist’s tracks (the eight most common, requiring at least five occurrences each).

Audiobook items collect publisher, authors, narrators, duration, description and chapter list — sourced from embedded tags or the audiobook provider (Audiobookshelf, Audible, etc.). Cover artwork follows the same precedence as albums.

Podcast shows track publisher and total episode count from the podcast provider (Audiobookshelf, Podcast Index, RSS feed, etc.). Per-episode metadata — title, description, artwork — comes directly from the show’s feed.