mirror of
https://github.com/beetbox/beets.git
synced 2025-12-06 16:42:42 +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!)
49 lines
1.9 KiB
ReStructuredText
49 lines
1.9 KiB
ReStructuredText
AcousticBrainz Submit Plugin
|
|
============================
|
|
|
|
The ``absubmit`` plugin lets you submit acoustic analysis results to the
|
|
`AcousticBrainz`_ server.
|
|
|
|
Installation
|
|
------------
|
|
|
|
The ``absubmit`` plugin requires the `streaming_extractor_music`_ program to run. Its source can be found on `GitHub`_, and while it is possible to compile the extractor from source, AcousticBrainz would prefer if you used their binary (see the AcousticBrainz `FAQ`_).
|
|
|
|
The ``absubmit`` plugin also requires `requests`_, which you can install using `pip`_ by typing::
|
|
|
|
pip install requests
|
|
|
|
After installing both the extractor binary and requests you can enable the plugin ``absubmit`` in your configuration (see :ref:`using-plugins`).
|
|
|
|
Submitting Data
|
|
---------------
|
|
|
|
Type::
|
|
|
|
beet absubmit [QUERY]
|
|
|
|
to run the analysis program and upload its results.
|
|
|
|
The plugin works on music with a MusicBrainz track ID attached. The plugin
|
|
will also skip music that the analysis tool doesn't support.
|
|
`streaming_extractor_music`_ currently supports files with the extensions
|
|
``mp3``, ``ogg``, ``oga``, ``flac``, ``mp4``, ``m4a``, ``m4r``, ``m4b``,
|
|
``m4p``, ``aac``, ``wma``, ``asf``, ``mpc``, ``wv``, ``spx``, ``tta``,
|
|
``3g2``, ``aif``, ``aiff`` and ``ape``.
|
|
|
|
Configuration
|
|
-------------
|
|
|
|
To configure the plugin, make a ``absubmit:`` section in your configuration file. The available options are:
|
|
|
|
- **auto**: Analyze every file on import. Otherwise, you need to use the ``beet absubmit`` command explicitly.
|
|
Default: ``no``
|
|
- **extractor**: The absolute path to the `streaming_extractor_music`_ binary.
|
|
Default: search for the program in your ``$PATH``
|
|
|
|
.. _streaming_extractor_music: https://acousticbrainz.org/download
|
|
.. _FAQ: https://acousticbrainz.org/faq
|
|
.. _pip: https://pip.pypa.io
|
|
.. _requests: https://docs.python-requests.org/en/master/
|
|
.. _github: https://github.com/MTG/essentia
|
|
.. _AcousticBrainz: https://acousticbrainz.org
|