mirror of
https://github.com/beetbox/beets.git
synced 2025-12-15 21:14:19 +01:00
53 lines
1.4 KiB
ReStructuredText
53 lines
1.4 KiB
ReStructuredText
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
|
|
|
|
.. _gmusicapi: https://github.com/simon-weber/gmusicapi/
|
|
|
|
Then, you can enable the ``gmusic`` plugin in your configuration (see
|
|
:ref:`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.
|