lcacheux / gplaymusic

A Google Play Music API in Java

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Unofficial GPlayMusic API in JAVA

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 a valid 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:

<dependency>
    <groupId>com.github.felixgail</groupId>
    <artifactId>gplaymusic</artifactId>
    <version>0.2.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.

About

A Google Play Music API in Java

License:MIT License


Languages

Language:Java 100.0%