Improve absumbit docs (c.f.
AcousticBrainz Submit Plugin
============================
-The `absubmit` plugin uses the `streaming_extractor_music`_ program to analyze an audio file and calculate different acoustic properties of the audio. The plugin then uploads this metadata to the AcousticBrainz server. The plugin does this when calling the ``beet absumbit [QUERY]`` command or on importing if the `auto` configuration option is set to ``yes``.
+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` also plugin requires `requests`_, which you can install using `pip_` by typing:
+The `absubmit` also plugin 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. This will work on any
+music with a MusicBrainz track ID attached.
+
Configuration
-------------
@@ -24,12 +35,9 @@ To configure the plugin, make a ``absubmit:`` section in your configuration file
- **extractor**: The absolute path to the `streaming_extractor_music`_ binary.
Default: search for the program in your ``$PATH``
-Notes
------
-MusicBrainz track id is needed to use AcousticBrainz. Check the `streaming_extractor_music`_ download page for more information.
-
.. _streaming_extractor_music: http://acousticbrainz.org/download
.. _FAQ: http://acousticbrainz.org/faq
.. _pip: http://www.pip-installer.org/
.. _requests: http://docs.python-requests.org/en/master/
.. _github: https://github.com/MTG/essentia
+.. _AcousticBrainz: https://acousticbrainz.org
