https://github.com/mopidy/mopidy-beets

Mopidy extension for playing music from a Beets collection
https://github.com/mopidy/mopidy-beets

beets mopidy mopidy-backend python

Last synced: about 2 months ago
JSON representation

Mopidy extension for playing music from a Beets collection

• Host: GitHub
• URL: https://github.com/mopidy/mopidy-beets
• Owner: mopidy
• License: mit
• Created: 2013-04-20T22:15:20.000Z (over 11 years ago)
• Default Branch: main
• Last Pushed: 2024-01-22T11:13:48.000Z (12 months ago)
• Last Synced: 2024-04-14T07:45:11.286Z (9 months ago)
• Topics: beets, mopidy, mopidy-backend, python
• Language: Python
• Homepage: https://mopidy.com/ext/beets/
• Size: 130 KB
• Stars: 49
• Watchers: 14
• Forks: 14
• Open Issues: 10
• Metadata Files:
  • Readme: README.rst
  • License: LICENSE

Awesome Lists containing this project

README

        
************

Mopidy-Beets

************

.. image:: https://img.shields.io/pypi/v/Mopidy-Beets

    :target: https://pypi.org/project/Mopidy-Beets/

    :alt: Latest PyPI version

.. image:: https://img.shields.io/github/actions/workflow/status/mopidy/mopidy-beets/ci.yml?branch=main

    :target: https://github.com/mopidy/mopidy-beets/actions

    :alt: CI build status

.. image:: https://img.shields.io/codecov/c/gh/mopidy/mopidy-beets

    :target: https://codecov.io/gh/mopidy/mopidy-beets

    :alt: Test coverage

`Mopidy `_ extension for browsing, searching and

playing music from a music collection managed via `Beets `_.

This extension uses the

`Beets plugin "web" `_.

Installation

============

Install by running::

    sudo python3 -m pip install Mopidy-Beets

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

Configuration

=============

#. Setup the `Beets web plugin

   `_.

#. Tell Mopidy where to find the Beets web interface by adding the following to

   your ``mopidy.conf``::

    [beets]

    hostname = 127.0.0.1

    port = 8337

#. Restart Mopidy.

#. The Beets library is now accessible in the "browser" section of your Mopidy

   client. Additionally searches in Mopidy return results from your Beets

   library.

Proxy configuration for OGG files (optional)

--------------------------------------------

You may want to configure an http proxy server in front of your Beets plugin

(not mopidy). Otherwise you could have problems with playing OGG files and

other formats that require seeking (in technical terms: support for http

"Range" requests is required for these files).

The following Nginx configuration snippet is sufficient::

    server {

        listen 127.0.0.1:8338;

        root /usr/share/beets/beetsplug/web;

        server_name beets.local;

        location / {

            proxy_pass http://localhost:8337;

            # this statement forces Nginx to emulate "Range" responses

            proxy_force_ranges on;

        }

    }

Now you should change the mopidy configuration accordingly to point to the

Nginx port above instead of the Beets port. Afterwards mopidy will be able to

play file formats that require seeking.

Usage

=====

#. Run ``beet web`` to start the Beets web interface.

#. Start Mopidy and access your Beets library via any Mopidy client:

   * Browse your collection by album

   * Search for tracks or albums

   * Let the music play!

Project resources

=================

- `Source code `_

- `Issue tracker `_

- `Changelog `_

Credits

=======

- Original author: `Janez Troha `_

- Current maintainer: `Lars Kruse `_

- `Contributors `_