Skip to content

Latest commit

 

History

History
155 lines (106 loc) · 4.24 KB

README.rst

File metadata and controls

155 lines (106 loc) · 4.24 KB
Raw

Mopidy-GMusic

Latest PyPI version Number of PyPI downloads Travis CI build status Test coverage

Mopidy extension for playing music from Google Play Music.

Dependencies

  • You must have a Google account and some music and playlists in your library.
  • You must have an Android device registered for Google Play Music.
  • The Unofficial Google Music API is needed to access Google Play Music. It will automatically be installed together with Mopidy-GMusic.

Installation

Install the Mopidy-GMusic extension by running:

pip install mopidy-gmusic

Configuration

Before starting Mopidy, you must add your Google username, password, and Android mobile device ID to your Mopidy configuration file:

[gmusic]
username = alice
password = secret
deviceid = 0123456789abcdef

The mobile device ID is a 16-digit hexadecimal string (without a '0x' prefix) identifying the Android device registered for Google Play Music. You can obtain this ID by dialing *#*#8255#*#* on your phone (see the aid) or using this App (see the Google Service Framework ID Key). You may also leave this field empty. Mopidy will try to find the ID by itself. See the Mopidy logs for more information.

All Access subscribers may enable All Access integration by adding this line:

[gmusic]
all_access = true

All Access radios are available as browsable content or playlist:

[gmusic]
# show radio stations in content browser
show_radio_stations_browse = true
# show radio stations as playlists
show_radio_stations_playlist = false
# limit the number of radio stations, 0 = unlimited
max_radio_stations = 0
# limit the number or tracks for each radio station
max_radio_tracks = 25

Usage

The extension is enabled by default if all dependencies are available. You can simply browse through your library and search for tracks, albums, and artists. Google Play Music playlists are imported as well. You can even add songs from your All Access subscription to your library. Mopidy will able to play them.

Project resources

Changelog

v1.0.0 (UNRELEASED)

  • Require Mopidy v1.0
  • Update to work with new playback API in Mopidy 1.0
  • Update to work with new search API in Mopidy 1.0
  • (a number of other changes, not yet added to the changelog)

v0.3.0 (2014-01-28)

  • Issue #19: Public playlist support
  • Issue #16: All playlist files are playable now
  • Require Mopidy >= 0.18.

v0.2.2 (2013-11-11)

  • Issue #17: Fixed a bug regarding various artist albums (compilations)
  • Issue #18: Fixed Google Music API playlist call for version 3.0.0
  • Issue #16 (partial): All Access tracks in playlists are playable now

v0.2.1 (2013-10-11)

  • Issue #15: Fixed a bug regarding the translation of Google album artists to Mopidy album artists

v0.2 (2013-10-11)

  • Issue #12: Now able to play music from Google All Access
  • Issue #9: Switched to the Mobileclient API of Google Music API
  • Issue #4: Generate Album and Artist Search Results

v0.1.1 (2013-09-23)

  • Issue #11: Browsing the library fixed by implementing find_exact()

v0.1 (2013-09-16)

  • Initial release