Metadata Specification¶
Album metadata is provided as a nested dict
that contains information for the album, its tracks, and the player.
A simple example follows:
album = {
"artist": "Sluggy Puppernutters",
"title": "Self-Titled Album",
"artist_url": "https://sluggy.example",
"album_url": "https://sluggy.example/album/self-titled",
"artwork": {
"1x": "album-art-thumb.jpg",
"2x": "album-art-hidpi.jpg",
"fullsize": "album-art-fullsize.jpg"
},
"tracks": [
{
"title": "Hit Single",
"filename": "hit single.mp3",
"artwork": {
"1x": "hit-single-thumb.jpg"
},
"explicit": True,
"duration": 273
},
{
"title": "We Hate Our Hit Single",
"filename": "something else.mp3",
"explicit": True,
"duration": 273,
"lyrics": [
"Here is a stanza",
"And another stanza",
"",
"And this is the second verse",
"It's the first but worse"
],
"about": "Here's a cat.\n\n![](https://placekitten.com/640/480)"
},
{
"title": "You'll have to buy the album to hear this one",
"duration": 3600
}
],
"theme": {
"foreground": "white",
"background": "black",
"highlight": "yellow",
"hide_footer": False,
"user_css": "fancypants.css",
"footer_text": "Custom footer text"
}
}
Album¶
The top-level dict
contains the following data:
artist
: The recording artist’s nametitle
: The title of the albumartist_url
: The recording artist’s homepage/websitealbum_url
: The canonical web address for this albumartwork
: The album-level artwork datatracks
: The individual tracks of this albumtheme
: Visual theme settings
Tracks¶
Track data is a list
of dict
of the following data
for each track:
title
: The title of the trackfilename
: The preview audio file (optional)artwork
: Track-level artwork dataexplicit
: Whether this track contains explicit lyricsduration
: The length of the track (in seconds)lyrics
: The lyrics of the song, either as a big newline-separated string or as alist
of strings (one per line).about
: The extended information of the track, either as a newline-separated string or as alist
of strings (one per line). This text may be formatted with markdown.
Theme¶
The visual theme settings are as follows:
foreground
: Foreground text colorbackground
: Background colorhighlight
: Highlight text colorhide_footer
: Whether to hide the “Made with” footeruser_css
: User CSS file to include, for deeper visual customizationfooter_text
: Custom HTML to override the “Made with” footer
Artwork¶
Artwork data can be attached to an album and/or its tracks. It is a :py:class`dict` with the following keys:
1x
: The normal-DPI rendition of the thumbnail2x
: The high-DPI rendition of the thumbnailfullsize
: The fullsize rendition of the artwork