Skip to main content
`Ctrl`+`K`

# SubsonicUpdate Plugin

`subsonicupdate` is a very simple plugin for beets that lets you automatically update Subsonic’s index whenever you change your beets library.

To use `subsonicupdate` plugin, enable it in your configuration (see 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, this plugin will send a REST API call to your Subsonic server every time you change your beets library. Due to a current limitation of the API, all libraries visible to that user will be scanned.

If the Smart Playlist Plugin is used, creating or changing any playlist will trigger a Subsonic update as well.

This plugin requires Subsonic with an active Premium license (or active trial) or any other Subsonic API compatible server implementing the `startScan` endpoint.

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