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

`default`	Library default
`oldest`	Oldest first
`newest`	Newest first
`name`	Alphabetical