Skip to main content

An unofficial api for Google Play Music.

Project description

gmusicapi allows control of Google Music with Python.

from gmusicapi import Mobileclient

api = Mobileclient()
api.login('', 'my-password')
# => True

library = api.get_all_songs()
sweet_track_ids = [track['id'] for track in library
                   if track['artist'] == 'The Cat Empire']

playlist_id = api.create_playlist('Rad muzak')
api.add_songs_to_playlist(playlist_id, sweet_track_ids)

gmusicapi is not supported nor endorsed by Google.

That said, it’s actively maintained, and used in a bunch of cool projects, like:

Getting started

Everything you need is at

If the documentation doesn’t answer your questions, or you just want to get in touch, either drop by #gmusicapi on Freenode or shoot me an email.

Status and updates

Over the summer, gmusicapi began a major shift away from the Webclient interface. That’s finished now, so prefer the new Mobileclient interface whenever possible. Non-deprecated parts of the Webclient are listed at the Webclient documentation page.

I’ve started fulltime work at Venmo as of November, meaning this project is back to night and weekend development.

For fine-grained development updates, follow me on Twitter: @simonmweber.

Copyright 2014 Simon Weber. Licensed under the 3-clause BSD. See LICENSE.


As of 1.0.0, semantic versioning is used.


released 2014-01-20

  • add verify_ssl option to client init
  • greatly loosen dependency version requirements


released 2013-12-11

  • remove extraneous logging introduced in 3.0.0 – this could have logged auth details, so it’s recommended to delete old logs


released 2013-11-03

  • Musicmanager.get_all_songs is now Musicmanager.get_uploaded_songs
  • Mobileclient.get_all_playlist_contents is now Mobileclient.get_all_user_playlist_contents, and will no longer return results for subscribed playlists
  • add Mobileclient.get_shared_playlist_contents
  • add Mobileclient.reorder_playlist_entry
  • add Mobileclient.change_song_metadata
  • add Mobileclient.get_album_info
  • add Mobileclient.get_track_info
  • add Mobileclient.get_genres
  • compatibility fixes


released 2013-08-01

  • remove broken Webclient.{create_playlist, change_playlist, copy_playlist, search, change_playlist_name}
  • add Mobileclient; this will slowly replace most of the Webclient, so prefer it when possible
  • add support for streaming All Access songs
  • add Webclient.get_registered_devices
  • add a toggle to turn off validation per client
  • raise an exception when a song dictionary is passed instead of an id


released 2013-05-16

  • add support for listing/downloading songs with the Musicmanager. When possible, this should be preferred to the Webclient’s method, since it does not have a download quota.
  • fix a bug where the string representing a machine’s mac was not properly formed for use as an uploader_id. This will cause another machine to be registered for some users; the old device can be identified from its lack of a version number.
  • verify user-provided uploader_ids


released 2013-04-19

  • get_all_songs can optionally return a generator
  • compatibility updates for AddPlaylist call
  • log to appdirs.user_log_dir by default
  • add open_browser param to perform_oauth


released 2013-04-02

  • breaking: Api has been split into Webclient and Musicmanager
  • breaking: semantic versioning (previous versions removed from PyPi)
  • Music Manager OAuth support
  • faster uploading when matching is disabled
  • faster login


  • add artistMatchedId to metadata
  • tests are no longer a mess


  • add support for uploading album art (docs)
  • add support for .m4b files
  • add CancelUploadJobs call (not exposed in api yet)
  • Python 2.6 compatibility
  • reduced peak memory usage when uploading
  • logging improvements
  • improved error messages when uploading


  • user now controls logging (docs)
  • documentation overhaul


  • fix international logins


  • fix packaging issues


  • improve handling of strange metadata when uploading
  • add a dependency on dateutil


  • breaking: upload returns a 3-tuple (docs)
  • breaking: get_all_playlist_ids always returns lists of ids; remove always_id_lists option (docs)
  • breaking: remove suppress_failure option in Api.__init__
  • breaking: copy_playlist orig_id argument renamed to playlist_id (docs)
  • new: report_incorrect_match (only useful for Music Manager uploads) (docs)
  • uploading fixed
  • avconv replaces ffmpeg
  • scan and match is supported
  • huge code improvements


  • compatibility update for playlist mutation
  • various metadata compatibility updates


  • bugfix: support for uploading uppercase filenames (Tom Graham)
  • bugfix: fix typo in multidownload validation, and add test


  • metadata compatibility updates (storeId, lastPlayed)
  • fix uploading of unicode filenames without tags


  • update allowed rating values to 1-5 (David Dooling)
  • update metajamId to matchedId (David Dooling)
  • fix broken expectation about disc/track numbering metadata


  • change to the 3-clause BSD license
  • add Kevin Kwok to AUTHORS


  • improve code in
  • support uploading of all Google-supported formats: m4a, ogg, flac, wma, mp3. Non-mp3 are transcoded to 320kbs abr mp3 using ffmpeg
  • introduce dependency on ffmpeg. for non-mp3 uploading, it needs to be in path and have the needed transcoders available
  • get_playlists is now get_all_playlist_ids, and is faster
  • add an exception CallFailure. Api functions raise it if the server says their request failed
  • add suppress_failure (default False) option to Api.__init__()
  • change_playlist now returns the changed playlistId (pid)
  • change_song_metadata now returns a list of changed songIds (sids)
  • create_playlist now returns the new pid
  • delete_playlist now returns the deleted pid
  • delete_songs now returns a list of deleted sids
  • change_playlist now returns the pid of the playlist - which may differ from the one passed in
  • add_songs_to_playlist now returns a list of (sid, new playlistEntryId aka eid) tuples of added songs
  • remove_songs_from_playlist now returns a list of removed (sid, eid) pairs
  • search dictionary is now flattened, without the “results” key. see documentation for example


  • package for pip/pypi
  • add AUTHORS file
  • remove; the sessions are now just api.PlaySession (Darryl Pogue)
  • protocol.Metadata_Expectations.get_expectation will return UnknownExpectation when queried for unknown keys; this should prevent future problems
  • add immutable ‘subjectToCuration’ and ‘metajamId’ fields - use unknown


  • add change_playlist for playlist modifications
  • get_playlists supports multiple playlists of the same name by returning lists of playlist ids. By default, it will return a single string (the id) for unique playlist names; see the always_id_lists parameter.
  • api.login now attempts to bump Music Manager authentication first, bypassing browser emulation. This allows for much faster authentication.
  • urls updated for the change to Google Play Music
  • remove_songs_from_playlist now takes (playlist_id, song_ids), for consistency with other playlist mutations


  • change name to gmusicapi to avoid ambiguity
  • change delete_song and remove_song_from_playlist to delete_songs and remove_songs_from_playlist, for consistency with other functions
  • add verification of WC json responses
  • setup a sane branch model. see
  • improve logging

Project details

Release history Release notifications

History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


This version
History Node


History Node


History Node


History Node


History Node


History Node


History Node


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
gmusicapi-3.1.0.tar.gz (121.1 kB) Copy SHA256 hash SHA256 Source None Jan 20, 2014

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page