mirror of
https://github.com/beetbox/beets.git
synced 2025-12-06 08:39:17 +01:00
38 lines
1.4 KiB
ReStructuredText
38 lines
1.4 KiB
ReStructuredText
SubsonicUpdate Plugin
|
|
=====================
|
|
|
|
``subsonicupdate`` is a very simple plugin for beets that lets you automatically
|
|
update `Subsonic`_'s index whenever you change your beets library.
|
|
|
|
.. _Subsonic: http://www.subsonic.org/pages/index.jsp
|
|
|
|
To use ``subsonicupdate`` plugin, enable it in your configuration
|
|
(see :ref:`using-plugins`).
|
|
Then, you'll probably want to configure the specifics of your Subsonic server.
|
|
You can do that using a ``subsonic:`` section in your ``config.yaml``,
|
|
which looks like this::
|
|
|
|
subsonic:
|
|
url: https://example.com:443/subsonic
|
|
user: username
|
|
pass: password
|
|
auth: token
|
|
|
|
With that all in place, beets will send a Rest API to your Subsonic
|
|
server every time you import new music.
|
|
Due to a current limitation of the API, all libraries visible to that user will be scanned.
|
|
|
|
This plugin requires Subsonic with an active Premium license (or active trial).
|
|
|
|
Configuration
|
|
-------------
|
|
|
|
The available options under the ``subsonic:`` section are:
|
|
|
|
- **url**: The Subsonic server resource. Default: ``http://localhost:4040``
|
|
- **user**: The Subsonic user. Default: ``admin``
|
|
- **pass**: The Subsonic user password. (This may either be a clear-text
|
|
password or hex-encoded with the prefix ``enc:``.) Default: ``admin``
|
|
- **auth**: The authentication method. Possible choices are ``token`` or
|
|
``password``. ``token`` authentication is preferred to avoid sending
|
|
cleartext password.
|