Skip to content

Available sources for playlist composition

Playlists

A list of one or more of the current user playlists.

Add songs from playlists
name: "New playlist"
nb_songs: 100
playlists:
  - name: rock
  - name: chill
  - name: pop
    weight: 0.25
About playlist names

Playlists are given with their simplified name, stripped of emojis and spaces. For example, rock 70s ✌ should be written as rock70s in the configuration.

You can run the following code snippet to figure out the correct name you should give: 

playlist_name = "rock 70s ✌"
python -c "from utils import simplify_string; print(simplify_string($playlist_name))"

History

history lets you add your favourite songs from the past! Three time ranges are available:

  • short_term for the last 4 weeks
  • medium_term for the last 6 months
  • long_term for your all-time best.
Add songs from your most-listened titles
history:
  - time_range: "short_term"
  - time_range: "long_term"
    weight: 0.25

Uris

With uris, you can use any kind of playlist in your composition. Simply add the Spotify playlist uri or url in your YAML.

Warning

Spotify-owned playlists are not supported, their content is not accessible through the API.

Add songs from any Spotify public playlist
uris:
  - name: 50FTlBiOVTyPgVtPYVUzdn
  - name: 7oK3UXsHYmC3PYGQFY5IOb
    weight: 0.5
  - name: https://open.spotify.com/playlist/7oK3UXsHYmC3PYGQFY5IOb?si=eae4b209bee740f8
    weight: 0.25

Playlist URI or playlist URL ?

Both are supported. The URL link to share a playlist features its URI. For example: https://open.spotify.com/playlist/7oK3UXsHYmC3PYGQFY5IOb?si=eae4b209bee740f8 is a link for the playlist URI 7oK3UXsHYmC3PYGQFY5IOb.

Some playlist URIs to cover your needs
  • 7oK3UXsHYmC3PYGQFY5IOb : Bob Dylan, the philosophy of modern song
  • 50FTlBiOVTyPgVtPYVUzdn : Les Inrockuptibles, Trésors Cachés
  • ...

Putting all this together

You can add as many items from as many sections as you'd like ! And create all kinds of playlists

A playlist for your monthly best-of 
name: "🍔 Monthly Best Of"
nb_songs: 50
history:
    - time_range: short_term
A playlist for a chill evening 
name: "🌆 Calm Tunes"
nb_songs: 100
playlists:
    - name: chill
      selection_method: latest
uris:
    - name: https://open.spotify.com/playlist/6LSRWYpEoo8KiXenl2xHOP?si=e83a89df1dca4728  # Les inrocks, trésors cachés
    - name: https://open.spotify.com/playlist/4nutUe1JAzhJSna4mwSIw1?si=71f802c91a04416e  # FIP, best-of du mois

Deprecated sources

In November 2024 and without warning, Spotify deprecated several entrypoints from their public API, removed features and access on others. Some Chopin features are no longer available, but might come back one day.

Features

Unavailable since Spotify removed access to the audio_features API routes.

With features, you can add recommendations to your playlist. Based on the current playlist composition, and the feature value, recommended songs will be added. Available features are described in the API reference

Features come from Spotify audio features analysis

Recommend songs based on track features
artists:
  - name: David Bowie
  - name: The Beatles
features:
  - name: acousticness
    value: 0.6
  - name: popularity
    value: 80

The above composition configuration will:

  1. Add Bowie and Beatles songs to your playlists.
  2. Based on these songs, it will recommend relatively acoustic new ones.
  3. Finally, it will recommend popular songs.

Artists

A list of artists to pick songs from. The name is used to query the Spotify API and retrieve songs from Spotify's This is ... playlists.

Add songs from artists
name: "New playlist"
nb_songs: 20
artists:
  - name: David Bowie
  - name: The Beatles
  - name: Johnny Cash
    weight: 0.25

Radios

A list of artist's radios to pick songs from. The term "radio" refers here to the Spotify's Artist Name Radio playlists.

Songs from radios will include a few songs from the artist, and tracks from related artists.

Add songs from radios of artists
name: "New playlist"
nb_songs: 50
radios:
  - name: Pulp
  - name: Elvis Costello
  - name: Elliott Smith
    weight: 0.25

Mixes

With mixes, you can search for genre-specific playlists curated by Spotify, such as "Bossa Nova Mix", "New Wave Mix", or "Singer Songwriter Mix" for example.

Add songs from genre playlists
mixes:
  - name: "Bossa Nova"
  - name: "80s"
  - name: "Covers"