Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
34 commits
Select commit Hold shift + click to select a range
9e8a3d2
quest: claim reference-announcements
kixelated Oct 22, 2026
380b038
feat(mux): follow referenced broadcasts' announcements
kixelated Oct 22, 2026
3bba0a2
quest: finish reference announcements
kixelated Oct 22, 2026
185dbc5
fix(mux): only export requests wait for a sibling's first announcement
kixelated Oct 22, 2026
8e1e7b2
Merge remote-tracking branch 'origin/main' into quest/m0/broadcast-ep…
kixelated Oct 22, 2026
24206ed
feat(mux): bind waits for a sibling's first announcement; rename to f…
kixelated Oct 22, 2026
3910d67
Merge remote-tracking branch 'origin/main' into ref-ann-iterate
kixelated Oct 22, 2026
cd9fb91
fix(gst,mux): share a restarted sibling's timeline; fail a contradict…
kixelated Oct 22, 2026
a36fb1c
fix(gst): key sibling timelines by instance; a finished sibling track…
kixelated Oct 22, 2026
92f6749
fix(gst): a delisted sibling rendition follows no later instance
kixelated Oct 22, 2026
94292e0
fix(gst): scope a finished track to the instance that served it
kixelated Oct 22, 2026
58be9a6
Merge remote-tracking branch 'origin/main' into agent-aaafe-6254
kixelated Oct 22, 2026
fe98261
refactor(gst): split moqsrc sibling following into its own PR
kixelated Oct 22, 2026
667a334
feat(gst): moqsrc follows referenced broadcasts' announcements
kixelated Oct 22, 2026
286f549
fix(mux): a sibling's decode error fails the export even once it closes
kixelated Oct 22, 2026
2800930
Merge branch 'agent-aaafe-6254' into agent-aaafe-moqsrc
kixelated Oct 22, 2026
a1dd7fc
fix(mux): only an orderly sibling shutdown ends its rendition
kixelated Oct 22, 2026
a795ae5
Merge branch 'agent-aaafe-6254' into agent-aaafe-moqsrc
kixelated Oct 22, 2026
f6ab8e6
fix(mux): a sibling's unfinished track fails the export
kixelated Oct 22, 2026
13c582d
Merge branch 'agent-aaafe-6254' into agent-aaafe-moqsrc
kixelated Oct 22, 2026
9776abf
refactor(moq-gst): one follower per referenced broadcast drives its r…
kixelated Oct 23, 2026
e940e7e
refactor(moq-gst): key followers by path and keep instance state in them
kixelated Oct 23, 2026
165a66c
test(moq-gst): make the joining-rendition timeline test deterministic
kixelated Oct 23, 2026
0f79bfe
fix(moq-gst): keep a finished sibling track finished across a re-enable
kixelated Oct 23, 2026
5c2444f
fix(moq-gst): follow siblings past a closed catalog until its broadca…
kixelated Oct 23, 2026
fbb897c
fix(moq-gst): idle sibling renditions when the catalog's broadcast ends
kixelated Oct 23, 2026
2cb8230
fix(moq-gst): keep a draining follower reachable across a relist
kixelated Oct 23, 2026
1f44597
fix(moq-gst): resume a sibling instance that is announced again
kixelated Oct 23, 2026
46ea01c
fix(moq-gst): let go of an emptied follower without another catalog u…
kixelated Oct 23, 2026
c2bfc01
fix(moq-gst): release a sibling instance at its end
kixelated Oct 23, 2026
93fad07
fix(moq-gst): keep finished tracks across a pinned failover and a tra…
kixelated Oct 23, 2026
9ce3862
fix(moq-gst): bound the finished records to one per rendition and ins…
kixelated Oct 23, 2026
3787aa6
fix(moq-gst): play what the catalog's final snapshot adds
kixelated Oct 23, 2026
e381fb7
Merge origin/main into quest/m0/broadcast-epoch/moqsrc-sibling-follow
kixelated Oct 23, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion doc/bin/gstreamer.md
Original file line number Diff line number Diff line change
Expand Up @@ -124,7 +124,7 @@ rewound timestamps forward.

Pads are named by kind and appear as the catalog announces renditions:
`video_0`, `video_1`, `audio_0`. A rendition referencing another broadcast reads
that broadcast on the same connection, waiting for it to be announced. Link the pad you want by name; the terse
that broadcast on the same connection and follows its announcements the same way. Link the pad you want by name; the terse
`moqsrc ! decodebin3` form links only the first pad offered, which may be
audio. `moqsrc` follows the broadcast's announcements: when the publisher
restarts, it switches to the new broadcast on the same pads, kept by rendition
Expand Down
2 changes: 1 addition & 1 deletion doc/concept/hang.md
Original file line number Diff line number Diff line change
Expand Up @@ -63,7 +63,7 @@ decoder once per track.
A few things the catalog can express beyond decoder config:

- **Labels.** Any rendition may carry a human-readable `label` for a track picker. The map key stays the rendition's ID, so labels need not be unique and renaming one doesn't rename the track.
- **Renditions in another broadcast.** A rendition may point at a relative broadcast path, so a transcoder can publish a ladder that adds low rungs and references the source's original rendition without re-publishing its bytes. The path resolves against where the consumer found the catalog, so a reference that escapes above the root names nothing and the catalog is rejected. `@moq/watch` follows a referenced path's announcements like its own, restarting the rendition on each instance that serves it; every other reader, such as `moqsrc`, `moq play`, the exporters, and the bindings, waits for the first one announced and keeps it, and an exporter ends the rendition with it. An optional `epoch` beside the path names the [publisher instance](/concept/moq-lite#publisher-epochs) it expects: a route proving another instance ends the rendition instead of falling back to it, while a route without an epoch (an older version) cannot prove one, so there it is best effort.
- **Renditions in another broadcast.** A rendition may point at a relative broadcast path, so a transcoder can publish a ladder that adds low rungs and references the source's original rendition without re-publishing its bytes. The path resolves against where the consumer found the catalog, so a reference that escapes above the root names nothing and the catalog is rejected. `@moq/watch` and `moqsrc` follow a referenced path's announcements like their own, restarting the rendition on each instance that serves it; every other reader, such as `moq play`, the exporters, and the bindings, waits for the first one announced and keeps it, and an exporter ends the rendition with it. An optional `epoch` beside the path names the [publisher instance](/concept/moq-lite#publisher-epochs) it expects: a route proving another instance ends the rendition instead of falling back to it, while a route without an epoch (an older version) cannot prove one, so there it is best effort.
- **Track names.** The map key is a rendition's ID and, by default, its track name. A rendition sets `track` only when the two must differ, such as two renditions of same-named tracks in different broadcasts, or a rendition whose media changed and so needs a new name; readers subscribe to `track` when present. An ID can't name both a video and an audio rendition.
- **Jitter.** A rendition can say how far its frames fell behind the media clock before the publisher flushed them, in whole milliseconds rounded up. Encoders report the spread of lateness above each rendition's own recent minimum, so a constant encoder delay is not jitter; container imports estimate batch spans without counting ingest delay. It describes the publisher, never the network, only grows over the life of a stream, and a player sizes its buffer to at least this much. A `0` is read as absent.
- **Delay.** A rendition can also say how far its frames reach the transport behind the broadcast's earliest rendition, measured the same way from each rendition's minimum lateness, so a video encoder running 200 ms behind audio advertises `delay: 200` on video. It follows the same rules as jitter. A player holds the largest `delay + jitter` among the renditions it subscribes to, and never subtracts one rendition's `delay` from another's.
Expand Down
8 changes: 2 additions & 6 deletions quest/m0/broadcast-epoch/README.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# Broadcast epochs
# [L] Broadcast epochs

## Goal

Expand Down Expand Up @@ -73,7 +73,7 @@ Decided:
resolution on epoch-aware transports and remain best effort on epochless
transports. Following never turns a replacement into seamless resume. The
schemas, shared resolution, compatibility documentation, and `moq_mux::follow`
landed; `moqsrc` following siblings with it remains.
(which `moqsrc` follows siblings with) landed.
- Every first-party publisher that can restart mints its own: the apps,
moq-boy, the ingest gateways, moqsink, OBS, and the bindings. Players
(`moq play`, `@moq/watch`, demo/web) follow the announce `Restart`. moq-stats mints one per
Expand Down Expand Up @@ -122,7 +122,3 @@ restarts that sibling while preserving the catalog's explicit epoch
constraints; it never mixes instances through an old handle. Check
exact and covering routes, matching/different/absent epochs, and legacy
End+Start. The child quests own their focused regressions.

## Required

- [moqsrc sibling follow](/quest/m0/broadcast-epoch/moqsrc-sibling-follow.md) - moqsrc restarts a referenced sibling's rendition on each instance its announcements hand out, never past a named epoch
41 changes: 0 additions & 41 deletions quest/m0/broadcast-epoch/moqsrc-sibling-follow.md

This file was deleted.

3 changes: 1 addition & 2 deletions quest/m1/sink-restart-follow.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,8 +16,7 @@ route dies, since its subscriptions then end with an error.

Decided with the maintainer on 2026-10-20: widened from the server and push
sinks to every moq-cli and moq-gst reader. Following a catalog's references
to other broadcasts is [moqsrc sibling follow](/quest/m0/broadcast-epoch/moqsrc-sibling-follow.md)
for `moqsrc`, through `moq_mux::Source::follow`;
to other broadcasts landed for `moqsrc` through `moq_mux::Source::follow`;
`moq play` resolves a reference once with `Source::resolve`, which waits for
a sibling's first announcement and keeps it.

Expand Down
Loading
Loading