https://github.com/simon-weber/gmusicapi

An unofficial client library for Google Music.
https://github.com/simon-weber/gmusicapi

client-lib gmusicapi google google-music python python-2 python-3

Last synced: 3 months ago
JSON representation

An unofficial client library for Google Music.

• Host: GitHub
• URL: https://github.com/simon-weber/gmusicapi
• Owner: simon-weber
• License: bsd-3-clause
• Archived: true
• Created: 2012-01-20T17:19:12.000Z (almost 13 years ago)
• Default Branch: develop
• Last Pushed: 2020-12-26T18:14:42.000Z (almost 4 years ago)
• Last Synced: 2024-09-24T19:21:55.666Z (3 months ago)
• Topics: client-lib, gmusicapi, google, google-music, python, python-2, python-3
• Language: Python
• Homepage: https://unofficial-google-music-api.readthedocs.io
• Size: 3.95 MB
• Stars: 2,485
• Watchers: 133
• Forks: 257
• Open Issues: 61
• Metadata Files:
  • Readme: README.rst
  • Changelog: HISTORY.rst
  • Contributing: CONTRIBUTING.md
  • License: LICENSE

Awesome Lists containing this project

README

        
gmusicapi: an unofficial API for Google Play Music

==================================================

gmusicapi allows control of

`Google Music `__ with Python.

.. code-block:: python

    from gmusicapi import Mobileclient

    

    api = Mobileclient()

    # after running api.perform_oauth() once:

    api.oauth_login('')

    # => 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 powers a bunch of cool projects:

-  alternate clients, including

   `one designed for the visually impaired `__,

   `a web-based jukebox which ships with its own server `__,

   `command line `__

   `clients `__,

   `a FUSE filesystem `__,

   and `an Alexa skill `__

-  library management tools for

   `syncing tracks `__,

   `syncing playlists `__,

   and `migrating to a different account `__

-  proxies for media players, such as

   `gmusicproxy `__ and

   `gmusicprocurator `__,

   as well as plugins for 

   `Mopidy `__,

   `Squeezebox `__ and

   `Tizonia `__.

-  enhancements like `autoplaylists / smart playlists `__

Getting started

---------------

Start with `the usage docs `__, which will guide you through installation and the available apis.

Once you're up and running, you can explore the rest of the docs at http://unofficial-google-music-api.readthedocs.io.

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

------------------

|build_status|

.. |build_status| image:: https://travis-ci.org/simon-weber/gmusicapi.png?branch=develop

        :target: https://travis-ci.org/simon-weber/gmusicapi

* January 2020: Python 2 support dropped.

* November 2018: proper OAuth support for the mobileclient.

* February 2016: Python 3 support!

* September 2015: Google switched to a new music uploading endpoint, breaking uploading for outdated versions of gmusicapi.

* June 2015: Full mobileclient and webclient functionality was restored.

* May 2015: Limited mobileclient functionality was restored.

* April 2015: Google deprecated clientlogin, breaking both the webclient and mobileclient.

* November 2013: I started working fulltime at Venmo, meaning this project is back to night and weekend development.

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

`@simonmweber `__.