diff --git a/docs/changelog.rst b/docs/changelog.rst index 62189fa37..9b49bdd5f 100644 --- a/docs/changelog.rst +++ b/docs/changelog.rst @@ -4,6 +4,12 @@ Changelog 1.3.14 (in development) ----------------------- +New features: + +* The :doc:`/plugins/metasync` plugin now lets you get metadata from iTunes. + This plugin is still in an experimental phase. + + Fixes: * :doc:`/plugins/mpdstats`: Avoid a crash when the music played is not in the diff --git a/docs/plugins/metasync.rst b/docs/plugins/metasync.rst index cd157eacd..e7d26ccd9 100644 --- a/docs/plugins/metasync.rst +++ b/docs/plugins/metasync.rst @@ -4,11 +4,13 @@ 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. +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. .. _Amarok: https://amarok.kde.org/ +.. _iTunes: https://www.apple.com/itunes/ Installation @@ -29,10 +31,23 @@ Configuration To configure the plugin, make a ``metasync:`` section in your configuration file. The available options are: -- **source**: A list of sources to fetch metadata from. Set this to "amarok" - to enable synchronization with that player. +- **source**: A list of 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.:: + + metaysnc: + source: itunes + itunes: + library: ~/Music/iTunes Library.xml + +Please note the indentation. Usage -----