Skip to main content

Beets extension for Mopidy

Project description

Latest PyPI version Travis CI build status Test coverage

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

Installation

Install by running:

pip install Mopidy-Beets

Or, if available, install the Debian/Ubuntu package from apt.mopidy.com.

Configuration

  1. Setup the Beets web plugin.

  2. 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
  3. Restart Mopidy.

  4. Searches in Mopidy will now 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 installation. 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:8889;
    root /usr/share/beets/beetsplug/web;
    server_name beets.local;
    location / {
        proxy_pass http://localhost:8888;
        # 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 intead of the Beets port. Afterwards mopidy will be able to play file formats that require seeking.

Usage

  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

Credits

Changelog

v3.1.0 (2016-11-23)

  • Fix handling of non-ascii characters in album titles and artist names

  • Fix handling of empty titles and names

  • Reduce ressource consumption of string matching API requests

v3.0.0 (2016-05-28)

  • Support browsing albums by artist, genre and year

  • Improved search (more categories, more precise)

  • Align with Mopidy’s current extension guidelines

v2.0.0 (2015-03-25)

  • Require Mopidy >= 1.0.

  • Update to work with new playback API in Mopidy 1.0.

  • Update to work with new backend search API in Mopidy 1.0.

v1.1.0 (2014-01-20)

  • Require Requests >= 2.0.

  • Updated extension and backend APIs to match Mopidy 0.18.

v1.0.4 (2013-12-15)

  • Require Requests >= 1.0, as 0.x does not seem to be enough. (Fixes: #7)

  • Remove hacks for Python 2.6 compatibility.

  • Change search field track to track_name for compatibility with Mopidy 0.17. (Fixes: mopidy/mopidy#610)

v1.0.3 (2013-11-02)

  • Properly encode search queries containing non-ASCII chars.

  • Rename logger to mopidy_beets.

v1.0.2 (2013-04-30)

  • Fix search.

v1.0.1 (2013-04-28)

  • Initial release.

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-3.1.0.tar.gz (15.4 kB view details)

Uploaded Source

File details

Details for the file Mopidy-Beets-3.1.0.tar.gz.

File metadata

  • Download URL: Mopidy-Beets-3.1.0.tar.gz
  • Upload date:
  • Size: 15.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for Mopidy-Beets-3.1.0.tar.gz
Algorithm Hash digest
SHA256 bb0ad86c1ce70942a98a6d7e92efe71dbdbec411fbde7c5d8b3c745103a64a21
MD5 b6f1af444db32c0a5acc891b1ab5f889
BLAKE2b-256 01f1b5104e2fdd1cce139804bb2298dd7cdc295f7a257386cc0302cf5d794586

See more details on using hashes here.

Supported by

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