playmusic

Node-JS Google Play Music API

Written by Jamon Terrell [e-mail]

NOTE: As of version 2.0, all callbacks are node.js style, with the first param being an "error" if one exists. If you are upgrading from 1.x you'll need to make sure to update your callbacks as represented in the documentation

This project is not endorsed by of affiliated with Google in any way.

Seeking Help!

I'm creating a few issues for items that I'd like to have added, but haven't had time to add. If anyone wants to volunteer to submit PRs for them, or is interested in becoming a direct contributor to the project, please comment on those issues or e-mail me.

Thanks!

Authentication

The library requires Google credentials, but does not require an All Access subscription on that account. It also requires a mobile device registered against that account. Ensure you have signed into the app on a phone and that you have played any amount of music. This will authorise the device that the library will masquerade as.

The Google account also needs to have the "Allow less secure apps" setting set to "ON". You can change it here.

How to Use

Initialization

var PlayMusic = require('playmusic');
var pm = new PlayMusic();
pm.init({email: "[e-mail]", password: "password"}, function(err) {
    if(err) console.error(err);
    // place code here
})

You may also call init with a master token either extracted from an existing android device or created by calling pm.login.

var PlayMusic = require('playmusic');
var pm = new PlayMusic();
pm.init({androidId: "16 DIGIT HEX", masterToken: "oauth2rt_1/..."}, function(err) {
    if(err) console.error(err);
    // place code here
})

To create a master token, call pm.login. if you do not provide an androidId, one will be generated. The callback function will be given an object containing "masterToken" and "androidId". This object can be saved and passed to init on future calls.

var PlayMusic = require('playmusic');
var pm = new PlayMusic();
pm.login({email: "[e-mail]", password: "password", androidId: "16 DIGIT HEX"}, function(err) {
    if(err) console.error(err);
    // place code here
})

Retrieve list of all tracks in your library (uploaded tracks and tracks added to library from All Access)

    pm.getAllTracks(function(err, library) {
        var song = library.data.items.pop();
        console.log(song);
        pm.getStreamUrl(song.id, function(err, streamUrl) {
            console.log(streamUrl);
        });
    });

Search for a song

    pm.search("bastille lost fire", 5, function(err, data) { // max 5 results
        var song = data.entries.sort(function(a, b) { // sort by match score
            return a.score < b.score;
        }).shift(); // take first song
        console.log(song);
        pm.getStreamUrl(song.track.nid, function(err, streamUrl) {
            console.log(streamUrl);
        });
    }, function(message, body, err, httpResponse) {
        console.log(message);
    });

Retrieve Playlists

    // gets all playlists
    pm.getPlayLists(function(err, data) {
        console.log(data.data.items);
    });

    // gets all playlists, and all entries on each
    pm.getPlayListEntries(function(err, data) {
        console.log(data.data.items);
    });

Get favorite songs

	pm.getFavorites(function(err, data) {
		console.log(data.track);
	});

Retrieve the Stream URL for a song by track.storeId (All Access songs only!!!)

    pm.getStreamUrl("Thvfmp2be3c7kbp6ny4arxckz54", console.log);

Retrieve the Stream URL for a song by track.id (uploaded songs only!!!)

    pm.getStreamUrl("84df1e4e-6b76-3147-9a78-a44becc28dc5", console.log);

Retrieve information about an album or artist (All Access Only!!!)

    // getArtist - artistId, albumList, topTrackCount, relatedArtistCount[, callback]
    pm.getArtist('Ak6zkmv2zbbsaxl63cgsnx5ttcm', true, 2, 2);

    // getAlbum - albumId, includeTracks[, success, error]
    pm.getAlbum('Bfn67zo6q3ekh35eaorkq5untmi', true);

Get Google Play Music Settings

    pm.getSettings();

More Examples:

npm install playmusic
node

var pm = new (require('playmusic'));
pm.init({email: "email", password: "password"}, function() {});
// var pm = new (require('./'))();  pm.init(JSON.parse(require('fs').readFileSync("./examples/config.json")));

pm.getPlayLists();
pm.getPlayListEntries();

// getArtist - artistId, albumList, topTrackCount, relatedArtistCount[, callback]
pm.getArtist('Ak6zkmv2zbbsaxl63cgsnx5ttcm', true, 2, 2, console.log);

// getStreamUrl for All Access - sj#track -> storeId
pm.getStreamUrl('Tsbbwp6r2wpwxb55noc6b26kwq4', console.log);

// getStreamUrl for uploaded - sj#track -> id
pm.getStreamUrl('84df1e4e-6b76-3147-9a78-a44becc28dc5', console.log);


// Find all uploaded tracks (tracks returned by getAllTracks without a storeId), get a streamUrl for one of them
var allTracks;
pm.getAllTracks(function(data) { allTracks = data.data.items; });
var searchResults = allTracks.filter(function(track) { return typeof track.storeId === "undefined"; });
console.log(searchResults[0]);
pm.getStreamUrl(searchResults[0].id, console.log);

Future

• create stations / get songs from stations/genres
• provide better examples
• add automated integration testing
• improve authentication
• explore providing a higher level api that allows easy following of relationships between objects
• Suggestions? submit an issue!

License

This Source Code is subject to the terms of the Mozilla Public License, v. 2.0. If a copy of the MPL was not distributed with this file, You can obtain one at http://mozilla.org/MPL/2.0/.

Attribution

Special thanks go out to the following individuals and projects:

• Google Play Music resolver for Tomahawk - information on the gmusic api
• gmusicapi project by Simon Weber and others - information on the gmusic api, also special thanks to their IRC support of my many questions
• wyozi - playlist management support
• Jonathan Cremin and match-audio - contributions including support for new api changes and documentation for authorization, bug fixes for error handling
• Jan Smolders and MediacenterJS - testing, troubleshooting and other feedback
• Puneeth Uttla - authentication workaround, api change fixes (Thanks a bunch!)