Lexicon Garden

place.stream.live.getClip

Clip a livestream between two instants as a flat (faststart) MP4. The clip is cut on MUXL segment boundaries: it holds every segment whose start falls within [start, end], so it may begin up to one segment late and run up to one segment past end. Segments come from the node's livestream recordings and from the recent stream it holds in memory; each segment's C2PA signature passes through verbatim. Only published (live) segments are clipped. Requires a signed-in caller: an OAuth session, or a service-auth token bound to this method (lxm), so third-party apps can call it through the PDS with the rpc:place.stream.live.getClip scope.

Repository @stream.place did:plc:rbvrr34edl5ddpuwcubjiost not from the namespace authority
Details · query
Kindquery
Authoritylive.stream.place
Indexed
Compare Edit in builder → Fork →

Query

query · GET

Parameters

query string

end

requiredstring · datetime

End of the clip (wall-clock time). Must be after start, at most one hour later.

start

requiredstring · datetime

Start of the clip (wall-clock time).

streamer

requiredstring

The streamer: a DID or a Bluesky handle (resolved to its DID).

Output

video/mp4

Errors

ClipNotFound

This node has no published segments of the stream in the requested range.

ClipUnavailable

Part of the requested range is still being recorded and is held only by the node the streamer is streaming to; retry there, or later once the recording has been written.

Similar lexicons

semantic match

Lexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.

  • place.stream.playback.getLiveSegment

    query not from the namespace authority

    Fetch a single live HLS segment, or a track's init segment, from the in-memory live window. `seg` is `init` for the EXT-X-MAP init segment, otherwise the segment's media-sequence number; a cosmetic `.m4s` suffix is accepted (and ignored) so ffmpeg-based HLS players will fetch it. HTTP Range is honored. Segments are the verbatim signed canonical .m4s, so provenance travels with playback.

  • place.stream.playback.getLivePlaylist

    query not from the namespace authority

    Get an HLS CMAF playlist for a live stream. Returns a master playlist when `track` is omitted, or a single-track media playlist when `track` is supplied. The playlist references each segment + per-track init segment via getLiveSegment. Segments come from an in-memory sliding window fed as the stream is ingested (or replicated to this node), so a playlist is only available while the stream is live here.

  • place.stream.live.getSegments

    query

    Get a list of livestream segments for a user

  • place.stream.live.subscribeSegments

    subscription

    Subscribe to a stream's new segments as they come in!

  • place.stream.playback.getPlaybackSession

    query not from the namespace authority

    Mint the caller's own playback session for their live stream. Every playback URL carries a signed session as `sid`; the anonymous one a playlist hands out opens published streams only, while the owner session this returns also opens the caller's unpublished (pre-live) stream to their own player. Requires an authenticated session; the result is bound to the caller's DID. Pass it as `sid` on getLivePlaylist.