FelixGail / gplaymusic

A Google Play Music API in Java
MIT License
54 stars 15 forks source link

Google has officially discontinued PlayMusic: https://blog.youtube/news-and-events/youtube-music-will-replace-google-play-music-end-2020/.

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:

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.