MetaSync Plugin#

This plugin provides the metasync command, which lets you fetch certain metadata from other sources: for example, your favorite audio player.

Currently, the plugin supports synchronizing with the Amarok music player, and with iTunes. It can fetch the rating, score, first-played date, last-played date, play count, and track uid from Amarok.

Installation#

Enable the metasync plugin in your configuration (see Using Plugins).

To synchronize with Amarok, you’ll need the dbus-python library. There are packages for most major Linux distributions.

Configuration#

To configure the plugin, make a metasync: section in your configuration file. The available options are:

  • source: A list of comma-separated sources to fetch metadata from. Set this to “amarok” or “itunes” to enable synchronization with that player. Default: empty

The follow subsections describe additional configure required for some players.

itunes#

The path to your iTunes library xml file has to be configured, e.g.:

metasync:
    source: itunes
    itunes:
        library: ~/Music/iTunes Library.xml

Please note the indentation.

Usage#

Run beet metasync QUERY to fetch metadata from the configured list of sources.

The command has a few command-line options:

  • To preview the changes that would be made without applying them, use the -p (--pretend) flag.

  • To specify temporary sources to fetch metadata from, use the -s (--source) flag with a comma-separated list of a sources.