This release includes many new features, but also some breaking changes for existing functions. Some functions were renamed, so make sure to update your programs.
Features ✨
-
add user id parameter to constructor to allow using brand accounts
-
add subscription methods
add_subscription
remove_subscription
rate_playlist
(also works with albums)subscribe_artists
unsubscribe_artists
-
add library methods
get_library_artists
get_library_albums
get_library_songs
get_library_subscriptions
get_library_upload_artists
get_library_upload_albums
For all features, check out the documentation.
Changes ⚒
-
BREAKING changes to
get_playlist_items
,search
andget_album
:album
dictionary keys are now a dictionary withname
andid
. Previously the keys only contained the name stringartists
dictionary keys now contain a list of artist dictionaries, each with the artist's name and id. Previously theartist
key only contained the name string of the first artist
-
BREAKING
get_uploaded_songs
renamed toget_library_upload_songs
-
BREAKING
get_playlist_items
renamed toget_playlist
, now also returns playlist metadata (id, privacy, title, description, track count) -
BREAKING
get_playlists
renamed toget_library_playlists
to be consistent with our library calls, and to avoid confusion withget_playlist
-
get_album
also returns the associated playlistId, durationMs, trackCount -
default limits for
get_playlist_items
andget_liked_songs
changed to 100 from 1000 -
Added type hints to all functions
Fixes 🐞
- Fix song duration for default search
- Fix get_playlist_items if playlist has no song count
- Fix issue in get_upload_song if requested while song processing