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:

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


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.