mirror of
https://github.com/beetbox/beets.git
synced 2026-01-24 17:12:07 +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!)
65 lines
1.9 KiB
ReStructuredText
65 lines
1.9 KiB
ReStructuredText
AcousticBrainz Plugin
|
|
=====================
|
|
|
|
The ``acousticbrainz`` plugin gets acoustic-analysis information from the
|
|
`AcousticBrainz`_ project.
|
|
|
|
.. _AcousticBrainz: https://acousticbrainz.org/
|
|
|
|
Enable the ``acousticbrainz`` plugin in your configuration (see :ref:`using-plugins`) and run it by typing::
|
|
|
|
$ beet acousticbrainz [-f] [QUERY]
|
|
|
|
By default, the command will only look for AcousticBrainz data when the tracks
|
|
doesn't already have it; the ``-f`` or ``--force`` switch makes it re-download
|
|
data even when it already exists. If you specify a query, only matching tracks
|
|
will be processed; otherwise, the command processes every track in your
|
|
library.
|
|
|
|
For all tracks with a MusicBrainz recording ID, the plugin currently sets
|
|
these fields:
|
|
|
|
* ``average_loudness``
|
|
* ``bpm``
|
|
* ``chords_changes_rate``
|
|
* ``chords_key``
|
|
* ``chords_number_rate``
|
|
* ``chords_scale``
|
|
* ``danceable``
|
|
* ``gender``
|
|
* ``genre_rosamerica``
|
|
* ``initial_key`` (This is a built-in beets field, which can also be provided
|
|
by :doc:`/plugins/keyfinder`.)
|
|
* ``key_strength``
|
|
* ``mood_acoustic``
|
|
* ``mood_aggressive``
|
|
* ``mood_electronic``
|
|
* ``mood_happy``
|
|
* ``mood_party``
|
|
* ``mood_relaxed``
|
|
* ``mood_sad``
|
|
* ``rhythm``
|
|
* ``tonal``
|
|
* ``voice_instrumental``
|
|
|
|
Automatic Tagging
|
|
-----------------
|
|
|
|
To automatically tag files using AcousticBrainz data during import, just
|
|
enable the ``acousticbrainz`` plugin (see :ref:`using-plugins`). When importing
|
|
new files, beets will query the AcousticBrainz API using MBID and
|
|
set the appropriate metadata.
|
|
|
|
Configuration
|
|
-------------
|
|
|
|
To configure the plugin, make a ``acousticbrainz:`` section in your
|
|
configuration file. There are three options:
|
|
|
|
- **auto**: Enable AcousticBrainz during ``beet import``.
|
|
Default: ``yes``.
|
|
- **force**: Download AcousticBrainz data even for tracks that already have
|
|
it.
|
|
Default: ``no``.
|
|
- **tags**: Which tags from the list above to set on your files.
|
|
Default: [] (all)
|