mirror of
https://github.com/beetbox/beets.git
synced 2025-12-06 08:39:17 +01:00
aa31fea037
*All* URLs were checked manually, but only once per domain! I mostly concerned myself with URLs in documentation rather than source code because the latter may or may not have impactful changes, while the former should be straight forward. Changes in addition to simply adding an s: - changed pip and pypi references as their location has changed - MPoD (iOS app) url redirects to Regelian, so I replaced those - updated homebrew references Notable observations: - beets.io does have HTTPS set up properly (via gh-pages) - beatport.py uses the old HTTP url for beatport - as does lyrics.py for lyrics.wikia.com - https://tomahawk-player.org/ expired long ago, but the http page redirects to https regardless - none of the sourceforge subdomains have https (in 2019!)
63 lines
1.7 KiB
ReStructuredText
63 lines
1.7 KiB
ReStructuredText
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.
|
|
|
|
.. _Amarok: https://amarok.kde.org/
|
|
.. _iTunes: https://www.apple.com/itunes/
|
|
|
|
|
|
Installation
|
|
------------
|
|
|
|
Enable the ``metasync`` plugin in your configuration (see
|
|
:ref:`using-plugins`).
|
|
|
|
To synchronize with Amarok, you'll need the `dbus-python`_ library. There are
|
|
packages for most major Linux distributions.
|
|
|
|
.. _dbus-python: https://dbus.freedesktop.org/releases/dbus-python/
|
|
|
|
|
|
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.
|