diff --git a/docs/plugins/absubmit.rst b/docs/plugins/absubmit.rst new file mode 100644 index 000000000..5c9e6025e --- /dev/null +++ b/docs/plugins/absubmit.rst @@ -0,0 +1,31 @@ +AcousticBrainz Submit Plugin +============================ + +The `absubmit` plugin uses the `streaming_extractor_music`_ program to analyse 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 options is set to ``yes``. + +Installation +------------ + +The `absubmit` plugin requires the 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 thier binary (see the AcousticBrainz `FAQ`_). + +The `absubmit` also plugin requires `requests`_, which you can install using `pip_` by typing: + + pip install requests + +After installing both the extractor binary and request you can enable the plgin ``absubmit`` in your configuration (see :ref:`using-plugins`). + +Configuration +------------- + +To configute 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 path to the `streaming_extractor_music`_ binary. + Default: search for the program in your ``$PATH`` + +.. _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 diff --git a/docs/plugins/index.rst b/docs/plugins/index.rst index e0f9521e2..0e851d7da 100644 --- a/docs/plugins/index.rst +++ b/docs/plugins/index.rst @@ -38,6 +38,7 @@ like this:: .. toctree:: :hidden: + absubmit acousticbrainz badfiles beatport @@ -105,6 +106,7 @@ Autotagger Extensions Metadata -------- +* :doc:`absubmit`: Analyse audio with the `streaming_extractor_music`_ program and submit the metadata to the AcousticBrainz server * :doc:`acousticbrainz`: Fetch various AcousticBrainz metadata * :doc:`bpm`: Measure tempo using keystrokes. * :doc:`edit`: Edit metadata from a text editor. @@ -128,6 +130,7 @@ Metadata * :doc:`zero`: Nullify fields by pattern or unconditionally. .. _KeyFinder: http://www.ibrahimshaath.co.uk/keyfinder/ +.. _streaming_extractor_music: http://acousticbrainz.org/download Path Formats ------------