Spotify Plugin

The spotify plugin generates Spotify playlists from tracks in your library. Using the Spotify Web API, any tracks that can be matched with a Spotify ID are returned, and the results can be either pasted in to a playlist or opened directly in the Spotify app.

Why Use This Plugin?

  • You’re a Beets user and Spotify user already.
  • You have playlists or albums you’d like to make available in Spotify from Beets without having to search for each artist/album/track.
  • You want to check which tracks in your library are available on Spotify.

Basic Usage

First, enable the spotify plugin (see Using Plugins). Then, use the spotify command with a beets query:

beet spotify [OPTIONS...] QUERY

Here’s an example:

$ beet spotify "In The Lonely Hour"
Processing 14 tracks...

Command-line options include:

  • -m MODE or --mode=MODE where MODE is either “list” or “open” controls whether to print out the playlist (for copying and pasting) or open it in the Spotify app. (See below.)
  • --show-failures or -f: List the tracks that did not match a Spotify ID.


The default options should work as-is, but there are some options you can put in config.yaml under the spotify: section:

  • mode: One of the following:

    • list: Print out the playlist as a list of links. This list can then be pasted in to a new or existing Spotify playlist.
    • open: This mode actually sends a link to your default browser with instructions to open Spotify with the playlist you created. Until this has been tested on all platforms, it will remain optional.

    Default: list.

  • region_filter: A two-character country abbreviation, to limit results to that market. Default: None.

  • show_failures: List each lookup that does not return a Spotify ID (and therefore cannot be added to a playlist). Default: no.

  • tiebreak: How to choose the track if there is more than one identical result. For example, there might be multiple releases of the same album. The options are popularity and first (to just choose the first match returned). Default: popularity.

  • regex: An array of regex transformations to perform on the track/album/artist fields before sending them to Spotify. Can be useful for changing certain abbreviations, like ft. -> feat. See the examples below. Default: None.

Here’s an example:

    mode: open
    region_filter: US
    show_failures: on
    tiebreak: first

    regex: [
            field: "albumartist", # Field in the item object to regex.
            search: "Something", # String to look for.
            replace: "Replaced" # Replacement value.
            field: "title",
            search: "Something Else",
            replace: "AlsoReplaced"