forked from Furumi/furumi-web
Document the proxy head check and the playback handoff details
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
7214c57624
commit
7aa2253e00
2 files changed
+13
-4
No files matched your search
+4
-1
@@ -52,7 +52,10 @@
|
||||
and 8443: names are resolved and checked once per connection (no DNS
|
||||
rebinding), IP literals and every redirect hop are checked, and no cookies,
|
||||
credentials or system proxies are used. Users see only the kind of a
|
||||
failure; details go to the logs without URLs.
|
||||
failure; details go to the logs without URLs. A host name that resolves to
|
||||
a blocked address gets the same answer as one that does not resolve.
|
||||
- The browser can add at most 10 000 episodes outside the account's feeds
|
||||
(handed-off queue items) through the playback endpoint (HTTP 422 beyond).
|
||||
|
||||
## v0.13.0 — 2026-11-19
|
||||
|
||||
|
||||
+9
-3
@@ -137,8 +137,11 @@ The runtime around the store lives next to it in `src/podcasts/`:
|
||||
`/api/podcasts`. The proxy takes an episode id, loads the URL from the
|
||||
account's catalog (`PodcastStore::audio_source`), forwards a single
|
||||
sanitized byte `Range`, passes 200/206/416 through, accepts audio content
|
||||
types only (a generic binary type is replaced by the stored enclosure type
|
||||
or the URL extension), and stops at 1 GiB, 20 s without headers, 30 s
|
||||
types only (a generic binary type needs an audio URL extension or a file
|
||||
that starts like audio, `sniff_audio`: read from the response when it
|
||||
starts at byte 0 and has at least 16 bytes, otherwise with its own
|
||||
`bytes=0-15` request; the feed's enclosure type is never trusted), and
|
||||
stops at 1 GiB, 20 s without headers, 30 s
|
||||
without data or 4 h per response. It is off unless
|
||||
`podcast_audio_proxy_enabled` is set; by default the browser streams from
|
||||
the publisher URL.
|
||||
@@ -177,7 +180,10 @@ at once on pause, stop or the end of the stream) records the old session and
|
||||
starts a new explicit one (`_takeOverEpisode`). A browser that loses the
|
||||
active role sends one final `stop` at its session generation (it records the
|
||||
listening; the new device's start keeps the register), unless it handed off
|
||||
itself. Marking the loaded episode played or unplayed in the same tab saves
|
||||
itself and the transfer went through (a failed transfer clears `handedOff` in
|
||||
the devices store's `select`). Preparing the same episode again (Play after
|
||||
its source failed) waits for the old session's final report, so the server
|
||||
resumes from where the audio stopped. Marking the loaded episode played or unplayed in the same tab saves
|
||||
and closes its session and pauses it. Prev on an episode goes back 15 s
|
||||
locally instead of resetting it. Jam guests never play or save episodes
|
||||
(they only ever see placeholders). The `podcasts` store backs the Podcasts
|
||||
|
||||
Reference in new issue
Block a user