Music Library Metadata

You can have the script edit the metadata of Artists, Albums, and Tracks by adding them to the metadata mapping of a Metadata File.

An example of multiple metadata edits in a music library is below:

metadata:
  "Linkin Park":
    country: "United States of America"
    album_sorting: newest
    albums:
      "Hybrid Theory":
        originally_available: "2000-10-24"
        tracks:
          1:
            user_rating: 5
          "One Step Closer":
            user_rating: 5
      "Meteora":
        originally_available: "2003-03-25"
        album_sorting: newest
        tracks:
          9:
            user_rating: 5
          "Numb":
            user_rating: 5
      "Minutes To Midnight":
        originally_available: "2007-05-14"

Artist

Each artist is defined by the mapping name which must be the same as the artist name in the library unless an alt_title is specified.

Albums

To edit the metadata of a particular Album for an Artist use the albums attribute on its artist.

The mapping name is the album name.

Tracks

To edit the metadata of a particular Track on an Album use the tracks attribute on its album.

The mapping name is the track number on that Album, or the title of the Track.

Metadata Edits

The available attributes for editing artists, albums, and tracks are as follows

Special Attributes

Attribute

Values

Artists

Album

Tracks

alt_title

Alternative title to look for

albums

Mapping to define Albums

tracks

Mapping to define Tracks

  • If you know of another Title your item might exist under, but you want it titled differently you can use alt_title to specify another title to look under and then be changed to the mapping name. For Example the Artist Kesha used to be stylized as Ke$ha, and might still be found that way in Metadata results.

    metadata:
      "Kesha":
        alt_title: "Ke$ha"
    

    This would change the name of the default Ke$ha to Kesha and would not mess up any subsequent runs. ``

General Attributes

Attribute

Values

Artists

Album

Tracks

title

Text to change Title

sort_title

Text to change Sort Title

user_rating

Number to change User Rating

critic_rating

Number to change Critic Rating

originally_available

Date to change Originally Available
Format: YYYY-MM-DD

record_label

Text to change Record Label

summary

Text to change Summary

track

Text to change Track

disc

Text to change Disc

original_artist

Text to change Original Artist

Tag Attributes

You can add .remove to any tag attribute to only remove those tags i.e. genre.remove.

You can add .sync to any tag attribute to sync all tags vs just appending the new ones i.e. genre.sync.

Attribute

Values

Artists

Album

Tracks

genre

List or comma-separated text of each Genre Tag

collection

List or comma-separated text of each Collection Tag

label

List or comma-separated text of each Label Tag

style

List or comma-separated text of each Style Tag

mood

List or comma-separated text of each Mood Tag

country

List or comma-separated text of each Country Tag

similar_artist

List or comma-separated text of each Similar Artist Tag

Image Attributes

Attribute

Values

Artists

Album

Tracks

url_poster

URL of image publicly available on the internet

file_poster

Path to image in the file system

url_background

URL of image publicly available on the internet

file_background

Path to image in the file system

Advanced Attributes

All these attributes only work with Artists.

Attribute

Values

album_sorting

defaultLibrary default
oldestOldest first
newestNewest first
nameAlphabetical