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:
sanapachandClaude Opus 5.5 committed 2026-11-20 15:12:38 +02:00
1 parent 7214c57624
commit 7aa2253e00
2 files changed
+13 -4

No files matched your search

+4 -1
View File
@@ -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
View File
@@ -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