The documentation has many references to a “Your Music” library that does not exist

[fabquenneville]

Describe the bug The documentation at readthedocs keeps referring to a “Your Music” library that does not exist. I believe for songs it is referring to the "Liked Songs" playlist by the wrong name being very confusing, I have not experimented with the albums and podcasts to see what it's referring to.

[fabquenneville]

Actually I might be wrong on this as it retrieves more songs than there are in my "Liked songs" playlist. I guess I will have to keep experimenting.

[fabquenneville]

Hi again,

There was a little bug in my code. Now that I fixed it I can confirm "Your Music" on the doc is indead for songs "Liked Songs" in spotify.

I had done

results = spotify.current_user_saved_tracks(limit=limit)
tracks  = results['items']
while results["next"] and len(tracks) < cap:
    tracks.extend(spotify.next(results)['items'])

instead of

results = spotify.current_user_saved_tracks(limit=limit)
tracks  = results['items']
while results["next"] and len(tracks) < cap:
    results = spotify.next(results)
    tracks.extend(results['items'])

Not sure if it would be considered a bug but it was confusing to me.

[fabquenneville]

Hi again

There is another "bug" in the docs:

util Module Shows a user’s playlists (need to be authenticated via oauth)

spotipy.util.prompt_for_user_token(username=None, scope=None, client_id=None, client_secret=None, redirect_uri=None, cache_path=None, oauth_manager=None, show_dialog=False)

To my knowledge the util module has nothing to do with the users playlists.

[Peter-Schorn]

The documentation at readthedocs keeps referring to a “Your Music” library that does not exist. I believe for songs it is referring to the "Liked Songs" playlist by the wrong name being very confusing

The "Your Music" library refers collectively to a user's liked tracks, saved albums, followed artists, and followed podcasts. This content is in the "Your Library" tab of the Spotify web player.

I have not experimented with the albums and podcasts to see what it's referring to.

Then why were you so convinced that it doesn't exist?

[fabquenneville]

Then why were you so convinced that it doesn't exist?

Well as you said there is no "Your music" in the web UI all of the music would be "Your library" in english, not "Your music". But for the case of the tracks methods if we reference the web UI or mobile interface it would be "Liked songs": current_user_saved_tracks, current_user_saved_tracks_add, current_user_saved_tracks_contains, current_user_saved_tracks_delete

I realize now that what the Spotipy docs do is mimic the Spotify docs, but for a developper searching for a way to manipulate "Liked Songs" in the "Your library" the fact that there's no mention in either documentations is an unnecessary headache.