Gmusic Plugin

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


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).


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:

    password: seekrit

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.