Skip to main content

Beets extension for Mopidy

Project description

Latest PyPI version CircleCI build status Test coverage

Mopidy extension for browsing, searching and playing music from Beets via Beets’ web extension.


Install by running:

sudo python3 -m pip install Mopidy-Beets

See for alternative installation methods.


  1. Setup the Beets web plugin.

  2. Tell Mopidy where to find the Beets web interface by adding the following to your mopidy.conf:

    hostname =
    port = 8337
  3. Restart Mopidy.

  4. 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 {
    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.


  1. Run beet web to start the Beets web interface.

  2. 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


Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

Mopidy-Beets-4.0.1.tar.gz (14.5 kB view hashes)

Uploaded source

Built Distribution

Mopidy_Beets-4.0.1-py3-none-any.whl (14.5 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page