starred/spotipy

Fork 0

mirror of https://github.com/spotipy-dev/spotipy.git synced 2026-04-26 16:15:51 +03:00

[GH-ISSUE #727] The documentation has many references to a “Your Music” library that does not exist #438

New issue

Open

opened 2026-02-27 23:22:38 +03:00 by kerem · 5 comments

kerem commented

2026-02-27 23:22:38 +03:00

Owner

Originally created by @fabquenneville on GitHub (Sep 9, 2021).
Original GitHub issue: https://github.com/spotipy-dev/spotipy/issues/727

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.

Originally created by @fabquenneville on GitHub (Sep 9, 2021). Original GitHub issue: https://github.com/spotipy-dev/spotipy/issues/727 **Describe the bug** The documentation at [readthedocs](https://spotipy.readthedocs.io/en/2.19.0/#api-reference) 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.

kerem added the

bug

label

2026-02-27 23:22:38 +03:00

kerem commented

2026-02-27 23:22:38 +03:00

Author

Owner

@fabquenneville commented on GitHub (Sep 10, 2021):

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 commented on GitHub (Sep 10, 2021): 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.

kerem commented

2026-02-27 23:22:38 +03:00

Author

Owner

@fabquenneville commented on GitHub (Sep 11, 2021):

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 commented on GitHub (Sep 11, 2021): 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.

kerem commented

2026-02-27 23:22:38 +03:00

Author

Owner

@fabquenneville commented on GitHub (Sep 15, 2021):

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.

@fabquenneville commented on GitHub (Sep 15, 2021): 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.

kerem commented

2026-02-27 23:22:38 +03:00

Author

Owner

@Peter-Schorn commented on GitHub (Sep 15, 2021):

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?

@Peter-Schorn commented on GitHub (Sep 15, 2021): > 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?

kerem commented

2026-02-27 23:22:38 +03:00

Author

Owner

@fabquenneville commented on GitHub (Sep 21, 2021):

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.

@fabquenneville commented on GitHub (Sep 21, 2021): > 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.

kerem referenced this issue

2026-02-28 00:02:28 +03:00

[PR #438] [MERGED] Prompt option to always show a dialog when giving permissions to Spotify #896