Skip to content
This repository has been archived by the owner on Jan 13, 2021. It is now read-only.
/ gplaymusic Public archive

A Google Play Music API in Java

License

Notifications You must be signed in to change notification settings

FelixGail/gplaymusic

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Unofficial GPlayMusic API in JAVA

CircleCI CircleCI
GitHub release

This library poses as a client for the GooglePlay app. It can search for songs/artists/albums, modify and create playlists and stations and even download tracks. For most activities an active subscription to GooglePlay All Access is needed.

This project is neither supported nor endorsed by Google.

This API should not be considered stable until version 1.0.0

Installation

Maven:

To use this library, simply add the following lines to your pom.xml:

Sonatype Nexus (Releases)
Sonatype Nexus (Snapshots)

<dependency>
    <groupId>com.github.felixgail</groupId>
    <artifactId>gplaymusic</artifactId>
    <version>0.4.0</version>
</dependency>

Otherwise download the latest version from the releases page.

Getting Started

Collecting your credentials:

To use the api you will need to provide the following information:

  • USERNAME: The email or username to your google account.
  • PASSWORD: The password to your google account or, if you are using 2-factor-authorization, an app password created here.
  • ANDROID_ID: The IMEI of an android device that had GooglePlayMusic installed.

Provided information will never be saved by this project.

Fetching an authorization token:
AuthToken authToken = TokenProvider.provideToken(USERNAME,
                                      PASSWORD, ANDROID_ID);
Creating a new API instance:
GPlayMusic api = new GPlayMusic.Builder()
                  .setAuthToken(authToken)
                  .build();

And you are ready to go.
A full documentation should come sometime in the future. For now use the Javadoc to help yourself. It can be found here.

Feel free to create an issue if you have questions or problems.

Attribution

Special thanks to gmusicapi project by Simon Webers. I started this project as a port for this great library.