Importing online data¶
One of the primary goals of Calliope is to provide a unified interface and data format for the varied online services related to music and metadata.
Most online services require an API key to access them. These are private tokens which allow the service provider to monitor and control your usage. You will need to obtain your own API keys to use these services. We try to document how to do this, but be aware that service providers can change things without warning.
Spotify doesn’t make much listen history data available through their API. It’s possible to obtain the last year of history using the Download your data option – see Spotify’s ‘Data rights and privacy settings’ guide for details.
Musicbrainz is a huge, open database of music
metadata. You can use the
calliope.musicbrainz module or the
cpe musicbrainz command to annotate playlist items with musicbrainz
IDs, metadata retrieved from musicbrainz and optionally update existing item data.
Items are only annotated automatically if a good enough match is found on
musicbrainz. In cases where the existing metadata is wrong or incomplete, use
the interactive mode to select the musicbrainz matches manually.