Metadata-Version: 2.1
Name: beets-beatport4
Version: 0.1.0
Summary: Plugin for beets (http://beets.io) to replace stock beatport plugin which is not yet compatible with Beatport API v4.
Home-page: https://github.com/Samik081/beets-beatport4
Download-URL: https://github.com/unrblt/beets-bandcamp/archive/v0.1.3.tar.gz
Author: Szymon "Samik" Tarasiński
Author-email: st.samik@gmail.com
License: MIT
Platform: ALL
Classifier: Topic :: Multimedia :: Sound/Audio
Classifier: Topic :: Multimedia :: Sound/Audio :: Players :: MP3
Classifier: License :: OSI Approved :: MIT License
Classifier: Environment :: Console
Classifier: Environment :: Web Environment
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
License-File: LICENSE

.. image:: http://img.shields.io/pypi/v/beets-beatport4.svg
    :target: https://pypi.python.org/pypi/beets-beatport4

Plugin for `beets <https://github.com/beetbox/beets>`_ to replace stock beatport plugin and use Beatport API v4 as an
autotagger source.

As Beatport had killed their API v3, the stock beatport plugin does not work anymore. It is also currently not possible to request the access to the API "normal" way, so I have found workaround and updated the code to use the new specification.

Installation
------------

Install this plugin with

..

   $ pip install beets-beatport4

and add ``beatport4`` to the ``plugins`` list in your beets config file.

Beatport Authorization (workaround)
-----------------------------------
1. Visit https://api.beatport.com/v4/docs/
2. Open Network tab in your browser and start capturing the traffic
3. Login with your Beatport account
4. Search for the following request: ``https://api.beatport.com/v4/auth/o/token/?code=...``
5. Copy the response (json access token)
6. Paste it to the `beatport_token.json` file next to your ``beets/config.yaml`` (you can check the path by running ``beet config --paths`` command)
7. Add ``beatport4`` plugin to your ``beets/config.yaml`` plugins list

Configuration and Usage
-----------------------
Apart from the authorization part, plugin should work exactly the same way as the stock one, so please refer to the `official documentation <https://beets.readthedocs.io/en/v1.6.0/plugins/index.html#metadata-source-plugin-configuration>`_
