Skip to content

Commit

Permalink
Merge pull request #41 from mgoltzsche/enhance-nginx-conf
Browse files Browse the repository at this point in the history
docs: hide Range header from flask to workaround beets web bug
  • Loading branch information
jodal authored Jan 4, 2025
2 parents 26a9563 + bca6dab commit 2b1f238
Showing 1 changed file with 8 additions and 4 deletions.
12 changes: 8 additions & 4 deletions README.rst
Original file line number Diff line number Diff line change
Expand Up @@ -52,10 +52,12 @@ Configuration
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).
In case you use a beets version older than 1.6.1, you may need to configure
an HTTP reverse-proxy server in front of the Beets web plugin (not mopidy)
because `it does not handle HTTP "Range" requests properly <https://github.com/beetbox/beets/pull/5057>`_.
If you don't apply this workaround, mopidy may not be able to stream/play
large audio files and/or does not allow you to seek.
The is the case for OGG files in particular.

The following Nginx configuration snippet is sufficient::

Expand All @@ -67,6 +69,8 @@ The following Nginx configuration snippet is sufficient::
proxy_pass http://localhost:8337;
# this statement forces Nginx to emulate "Range" responses
proxy_force_ranges on;
# Hide Range header from beets/flask, preventing range handling
proxy_set_header "Range" "";
}
}

Expand Down

0 comments on commit 2b1f238

Please sign in to comment.