forked from Furumi/furumi-web
87 lines
5.2 KiB
Markdown
87 lines
5.2 KiB
Markdown
# Changelog
|
|
|
|
## v0.14.0 — 2026-11-19
|
|
|
|
- Podcasts in the web player: a Podcasts section to add RSS feeds, browse
|
|
podcasts with unplayed counts and fetch errors, seasons, episode search,
|
|
filters and paging, refresh, unsubscribe (progress and history are kept)
|
|
and subscribe again, with Resume, Start over, Mark played/unplayed and the
|
|
recent listening history.
|
|
- The web player plays podcast episodes from the publisher (or the optional
|
|
proxy), resumes them from the synchronized position and saves progress in
|
|
the background: every 20 s and on pause, seek, item change, page hide and
|
|
handoff, with listening sessions and automatic completion by the shared
|
|
rule. A source that cannot seek to the saved position is shown as such
|
|
instead of playing from elsewhere. Handoffs to and from other devices keep
|
|
the episode, position and pause state; outgoing states carry the newest
|
|
progress generation. Play (also after a reload or a pause) continues from
|
|
the newest saved position of any device; a player that keeps listening
|
|
after another device wrote the episode saves again as a new session, and
|
|
one that loses the playback role records what it listened. Previous goes
|
|
back 15 s within an episode instead of resetting it.
|
|
- New endpoints under `/api/podcasts` (`/feeds`, `/feeds/{id}`,
|
|
`/feeds/{id}/episodes`, subscribe/unsubscribe, `/episodes/{id}/playback`,
|
|
`/progress`, `/restart`, `/played`, `/unplayed`). Request bodies must be
|
|
`application/json`.
|
|
- Jam guests still see the host's episodes only as private items and cannot
|
|
add episodes from the Podcasts section.
|
|
- Store podcast subscriptions, feed aliases, episodes, seasons, progress and
|
|
listening sessions of each account in PostgreSQL (`src/podcasts/`), with
|
|
the shared `music-dht` podcast rules. Received podcast operations and
|
|
snapshot sections are applied to this store, and snapshots are built from
|
|
it; the wire behavior towards other devices is unchanged. Migrations
|
|
`m_0056` and `m_0057` import the state that 0.13 relayed
|
|
(`furumusic__fed_podcast_relay`, kept but unused).
|
|
- Refresh subscribed podcast feeds in the background (`podcast_refresh` job,
|
|
every five minutes; each feed about hourly) with conditional requests,
|
|
permanent redirects learned as feed aliases, size and time limits and an
|
|
exponential backoff up to a day on errors. Accounts subscribed to the same
|
|
feed share one request; accounts take turns (at most 25 feeds each per
|
|
run). `POST /api/podcasts/{podcast_id}/refresh` refreshes one feed on
|
|
demand. Only metadata is fetched, never audio. An account can have up to
|
|
1000 subscriptions and two user-started feed downloads at once.
|
|
- Optional podcast audio proxy (`podcast_audio_proxy_enabled`, off by
|
|
default; browsers stream from the publisher otherwise):
|
|
`GET /api/podcasts/episodes/{episode_id}/audio` streams an episode of the
|
|
signed-in account from its publisher with Range pass-through, audio only
|
|
(a generic binary type needs an audio file extension or audio content; the
|
|
feed's enclosure type is not trusted), size/time limits and four streams
|
|
per account. `GET /api/podcasts/episodes/{episode_id}/source`
|
|
tells the player which URLs to use.
|
|
- Feed and proxy requests only reach public addresses on ports 80, 443, 8080
|
|
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.
|
|
|
|
## v0.13.0 — 2026-11-19
|
|
|
|
- Use the shared `music-dht` 0.6 device-sync types and announce device-sync
|
|
protocol 4. Podcast operations and snapshot sections from other devices are
|
|
kept and relayed; devices below protocol 4 never receive them.
|
|
- Keep podcast episodes and other non-library queue items through the web
|
|
player, with their explicit source. The player labels and skips them; the
|
|
typed queue is stored next to `queue_json` (migrations `m_0054`, `m_0055`).
|
|
A handoff through the web player keeps the position of the current episode.
|
|
- Refuse a playback transfer of a queue with podcast episodes to a device that
|
|
needs an update, and ignore its playback commands while the queue has them.
|
|
- Store the protocol version each device reports itself instead of this
|
|
server's version; invites carry the inviter's version.
|
|
- An episode that the web player selects without knowing its position (Next,
|
|
auto-advance, a click) resumes from its synchronized progress on the next
|
|
device instead of restarting at 0. Repeat all and shuffle continue past
|
|
episodes; Prev and seeking work on them.
|
|
- Jam guests see podcast episodes of the host as private items, without their
|
|
duration, and cannot add, remove or clear them; the host browser enforces
|
|
this on its own queue. Guests do not keep the placeholders after the Jam.
|
|
- Metadata Repair can still undo deletions recorded before the typed queue
|
|
column was added.
|
|
- Rolling back to 0.12 requires removing the relayed podcast operations first;
|
|
see "Rolling back to 0.12" in `docs/administration.md`. After a rollback, the
|
|
typed queue is used again only if 0.12 left the queue and its current track
|
|
unchanged.
|
|
|
|
## v0.10.6 — 2026-09-02
|
|
|
|
- Recover federation automatically after sleep, prolonged idle, or a degraded rendezvous transport.
|