Metadata-Version: 2.1
Name: Mopidy-Listenbrainz
Version: 0.2.1
Summary: Mopidy extension for recording played tracks as listens to Listenbrainz
Home-page: https://github.com/suaviloquence/mopidy-listenbrainz
Author: suaviloquence
Author-email: m@mcarr.one
License: Apache License, Version 2.0
Classifier: Environment :: No Input/Output (Daemon)
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Multimedia :: Sound/Audio :: Players
Requires-Python: >=3.7
License-File: LICENSE
Requires-Dist: Mopidy >=3.0.0
Requires-Dist: Pykka >=2.0.1
Requires-Dist: setuptools
Provides-Extra: lint
Requires-Dist: black ; extra == 'lint'
Requires-Dist: check-manifest ; extra == 'lint'
Requires-Dist: flake8 ; extra == 'lint'
Requires-Dist: flake8-black ; extra == 'lint'
Requires-Dist: flake8-bugbear ; extra == 'lint'
Requires-Dist: flake8-import-order ; extra == 'lint'

*******************
Mopidy-Listenbrainz
*******************

.. image:: https://img.shields.io/pypi/v/Mopidy-Listenbrainz
    :target: https://pypi.org/project/Mopidy-Listenbrainz/
    :alt: Latest PyPI version

.. image:: https://img.shields.io/github/actions/workflow/status/suaviloquence/mopidy-listenbrainz/ci.yml
    :target: https://github.com/suaviloquence/mopidy-listenbrainz/actions
    :alt: CI build status

`Mopidy <https://www.mopidy.com/>`_ extension for 
`Listenbrainz <https://www.listenbrainz.org/>`_.

This extension requires a free user account at Listenbrainz.


Installation
============

Install by running::

    sudo python3 -m pip install Mopidy-Listenbrainz

See https://mopidy.com/ext/listenbrainz/ for alternative installation methods.


Configuration
=============

The extension is enabled by default when it is installed. You just need to add
your `Listenbrainz user token <https://listenbrainz.org/profile/>`_ to your Mopidy configuration file::

    [listenbrainz]
    token = 240420-249429-29449

The following configuration values are available:

- ``listenbrainz/enabled``: If the extension should be enabled or not.
  Defaults to enabled.
- ``listenbrainz/token``: Your `Listenbrainz user token <https://listenbrainz.org/profile/>`_
- ``listenbrainz/url``: The URL of the API of the Listenbrainz instance to record listens to (default: api.listenbrainz.org)
- ``listenbrainz/import_playlists``: Whether to import Listenbrainz playlists (default: ``false``)
- ``listenbrainz/search_schemes``: If non empty, the search for tracks in Mopidy's library is limited to results with the given schemes. The default value is ``"local:"`` to search tracks in Mopidy-Local library. It's recommended to customize the value according to your favorite backend but beware that not all backends support the required track search by ``musicbrainz_trackid`` (Mopidy-File, Mopidy-InternetArchive, Mopidy-Podcast, Mopidy-Somafm, Mopidy-Stream don't support such searches).

Project resources
=================

- `Source code <https://github.com/suaviloquence/mopidy-listenbrainz>`_
- `Issue tracker <https://github.com/suaviloquence/mopidy-listenbrainz/issues>`_
- `Changelog <https://github.com/suaviloquence/mopidy-listenbrainz/releases>`_


Credits
=======

- Fork of `Mopidy-Scrobbler <https://github.com/mopidy/mopidy-scrobbler>`__ by `Stein Magnus Jodal <https://github.com/jodal>`__
- Current maintainer: `suaviloquence <https://github.com/suaviloquence>`__
- Playlist support by `Matthias Meulien <https://github.com/orontee>`__
- `Contributors <https://github.com/suaviloquence/mopidy-listenbrainz/graphs/contributors>`_
