Gmusic Plugin
*************

The "gmusic" plugin lets you upload songs to Google Play Music and
query songs in your library.


Installation
============

The plugin requires gmusicapi. You can install it using *pip*:

   pip install gmusicapi

Then, you can enable the "gmusic" plugin in your configuration (see
Using Plugins).


Usage
=====

To upload tracks to Google Play Music, use the "gmusic-upload"
command:

   beet gmusic-upload [QUERY]

If you don't include a query, the plugin will upload your entire
collection.

To query the songs in your collection, you will need to add your
Google credentials to your beets configuration file. Put your Google
username and password under a section called "gmusic", like so:

   gmusic:
       email: user@example.com
       password: seekrit

If you have enabled two-factor authentication in your Google account,
you will need to set up and use an *application-specific password*.
You can obtain one from your Google security settings page.

Then, use the "gmusic-songs" command to list music:

   beet gmusic-songs [-at] [ARGS]

Use the "-a" option to search by artist and "-t" to search by track.
For example:

   beet gmusic-songs -a John Frusciante
   beet gmusic-songs -t Black Hole Sun

For a list of all songs in your library, run "beet gmusic-songs"
without any arguments.
