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

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.