Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
29 commits
Select commit Hold shift + click to select a range
61e5ee0
chore(quest): claim quest/m0/ux/go-live.md
kixelated Nov 15, 2026
754917e
feat!: go live and end the stream from the window
kixelated Nov 15, 2026
5bc0778
Merge remote-tracking branch 'origin/main' into quest/m0/ux/go-live
kixelated Nov 15, 2026
3757f54
chore: shots of the library and going live, for the PR body
kixelated Nov 15, 2026
e52fd8d
chore: drop the shots, linked from the PR by the commit before
kixelated Nov 15, 2026
00a08a6
Merge remote-tracking branch 'origin/main' into quest/m0/ux/go-live
kixelated Nov 15, 2026
c3664fc
chore(quest): follow-ups from going live: close the show, settings pa…
kixelated Nov 15, 2026
44bd343
fix: going live's review findings
kixelated Nov 15, 2026
48dc87c
fix: the probe and saves follow going live while the window hides
kixelated Nov 15, 2026
fd6625a
fix: a finished save asks for its frame after its result is in
kixelated Nov 15, 2026
51995f1
fix: saves leave the relays alone unless they moved, and one go-live …
kixelated Nov 15, 2026
9838a48
fix: relays saved on air are followed as the stream ends, window show…
kixelated Nov 15, 2026
22d7b05
fix: saved relays wait out a go-live in flight, and follow a failed o…
kixelated Nov 15, 2026
f2dd838
fix: a go-live follows the relays saved before it, after any follow u…
kixelated Nov 15, 2026
e80f19c
fix: a go-live follows and publishes to one snapshot of the settings
kixelated Nov 15, 2026
7fc8767
fix: an ended stream waits on every copy and scene encoder, and a rel…
kixelated Nov 15, 2026
9ce5017
Merge main into quest/m0/ux/go-live
kixelated Nov 16, 2026
2ba4058
fix: REVIEW tags the program ON AIR only while live, and main's copy …
kixelated Nov 16, 2026
5755c65
fix: a go-live no relay answers names each relay, and Recording names…
kixelated Nov 16, 2026
081faa3
fix: a go-live waits on every relay's redials until one connects
kixelated Nov 16, 2026
69c216c
Merge main (the MIX page, #178) into quest/m0/ux/go-live
kixelated Nov 16, 2026
fa56bb7
fix: a relay that gave up keeps its reason in the go-live timeout
kixelated Nov 16, 2026
dc0ed0c
fix: the show's first relay follow is ordered with saves and go-live
kixelated Nov 16, 2026
e51be3e
Merge main (the looping media test holds under load, #181) into quest…
kixelated Nov 16, 2026
9d1894f
Merge main (the macOS app, #170) into quest/m0/ux/go-live
kixelated Nov 16, 2026
dcc8304
fix: CodeRabbit's go-live findings on e51be3e
kixelated Nov 16, 2026
a118fa3
fix: every go-live waits out the encoder checks still running
kixelated Nov 16, 2026
e75ff2a
fix: review findings on a118fa3
kixelated Nov 16, 2026
21d8c2d
fix: a go-live lifts its probe gate before the next one may start
kixelated Nov 16, 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
251 changes: 206 additions & 45 deletions Cargo.lock

Large diffs are not rendered by default.

220 changes: 148 additions & 72 deletions README.md

Large diffs are not rendered by default.

2 changes: 2 additions & 0 deletions packaging/flatpak/live.kixel.studio.yml
Original file line number Diff line number Diff line change
Expand Up @@ -23,6 +23,8 @@ finish-args:
- --filesystem=xdg-run/pipewire-0
# Scene files, image sources, and recordings wherever the creator keeps them.
- --filesystem=home
# Relay tokens, kept in the Secret Service (GNOME Keyring, KWallet).
- --talk-name=org.freedesktop.secrets
modules:
- name: moq-studio
buildsystem: simple
Expand Down
6 changes: 2 additions & 4 deletions packaging/flatpak/moq-studio-desktop.sh
Original file line number Diff line number Diff line change
@@ -1,7 +1,5 @@
#!/bin/sh
# The menu entry's launch, which passes no arguments: the studio's default
# scene collection in its data directory, the one `flatpak run` opens too, so
# the first launch runs guided setup, with recordings in the Videos folder the
# desktop names.
# The menu entry's launch, which passes no arguments: the library of recent
# shows, and recordings in the Videos folder rather than beside each show.
set -eu
exec moq-studio --recordings "$(xdg-user-dir VIDEOS)" "$@"
5 changes: 4 additions & 1 deletion packaging/flatpak/smoke.sh
Original file line number Diff line number Diff line change
Expand Up @@ -64,7 +64,10 @@ SWAYSOCK=$(compgen -G "$runtime/sway-ipc.*.sock")
WAYLAND_DISPLAY=$(basename "$(compgen -G "$runtime/wayland-*[0-9]")")
export SWAYSOCK WAYLAND_DISPLAY

flatpak run --env=NO_COLOR=1 --command=moq-studio-desktop live.kixel.studio 2>"$log" &
# A show that does not exist yet, so the launch runs guided setup rather than
# opening the library.
# shellcheck disable=SC2016 # Expanded inside the sandbox.
flatpak run --env=NO_COLOR=1 --command=sh live.kixel.studio -c 'exec moq-studio-desktop "$XDG_DATA_HOME/smoke.toml"' 2>"$log" &
studio=$!
pids+=("$studio")

Expand Down
14 changes: 8 additions & 6 deletions packaging/macos/smoke.sh
Original file line number Diff line number Diff line change
@@ -1,8 +1,9 @@
#!/usr/bin/env bash
# Launch the app bundle given as Finder does, through Launch Services with no
# arguments, and check that it lists cameras and audio, opens its window, and
# quits when asked without crashing. A fresh home directory makes it open a
# new scene collection, so guided setup lists the devices.
# Launch the app bundle given through Launch Services, as Finder does, and
# check that it lists cameras and audio, opens its window, and quits when
# asked without crashing. Without arguments it opens the library of recent
# shows, so it is handed a show not yet made, whose guided setup lists the
# devices.
# Given a disk image instead, it mounts it as a download is and launches the
# app inside, after checking the image offers the drag to Applications.
set -euo pipefail
Expand Down Expand Up @@ -63,9 +64,10 @@ reports=~/Library/Logs/DiagnosticReports
marker=$home/started
touch "$marker"

open -n "$app" --stdout "$log" --stderr "$log" --env HOME="$home" --env NO_COLOR=1
show=$home/show.toml
open -n "$app" --stdout "$log" --stderr "$log" --env HOME="$home" --env NO_COLOR=1 --args "$show"
deadline=$((SECONDS + 30))
until pid=$(pgrep -nfx "$executable"); do
until pid=$(pgrep -nfx "$executable $show"); do
((SECONDS < deadline)) || fail "the studio never started"
sleep 0.1
done
Expand Down
5 changes: 2 additions & 3 deletions quest/m0/destinations.md
Original file line number Diff line number Diff line change
Expand Up @@ -74,13 +74,12 @@ Decided 2026-11-09 (maintainer, /quest-audit):

Changed 2026-11-09 (maintainer, /quest-plan): going live and stopping, as
actions and as hotkeys, are
[Going live from inside the app](/quest/m0/ux/go-live.md), which lands them
for MoQ relays. This quest adds its destinations to that sheet rather than
the go-live sheet and live control the studio has, which land them for MoQ
relays. This quest adds its destinations to that sheet rather than
building a second way to start a stream.

## Required

- [Going live from inside the app](/quest/m0/ux/go-live.md) - the go-live sheet, the live control, and the health list its destinations join
- [moq's egress dial changes are pinned](/quest/m0/pin-egress-dial.md) - RTMPS that keeps `tcUrl`, and a dial policy the caller supplies

## Related
Expand Down
29 changes: 29 additions & 0 deletions quest/m0/program-encoder-priority.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,29 @@
# [S] The program's encoder before the sources'

## Goal

Going live gets the program its hardware encode sessions even when the
sources on program took every one the GPU allows while off air. Today the
program opens its encoders at GO LIVE, after the sources' replay encoders
(`rs/moq-scene/src/publish.rs`, which encode a source shown on program so a
replay has its recent past) already hold theirs, so on a GPU with a session
cap, such as a GeForce card's, a show with many sources on program goes live
on the CPU encoder or not at all. Before going live from the window, the
program opened first, at launch.

## Plan

Raised by the review of
[moq-dev/studio#175](https://github.com/moq-dev/studio/pull/175). The go-live
sheet's Encoder check already opens the same encoder with the sources'
sessions held, so the failure shows before the confirm; this makes it not
happen. `Sessions` counts encoders but cannot know a cap, which a driver
reports only by refusing an open.

Decided by the maintainer: when the program's encoder cannot open, release
the replay encoders of the sources on program, open the program's, then let
each source reopen as sessions allow, its replay starting over (rejected:
opening the program's encoders when the show opens and holding them idle off
air, at one or two sessions and their memory for the whole session; leaving
it to the go-live sheet's Encoder check alone). A replay is a convenience and
the program is what viewers see; the cost falls only on a machine at its cap.
25 changes: 25 additions & 0 deletions quest/m0/ux/close-show.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
# [S] Close the show and return to the library

## Goal

A broadcaster switches shows without quitting: the show's menu in the title
bar has Close show, which returns the window to YOUR SHOWS, the library of
recent shows. Today the library appears only when the studio starts with no
scene file, so changing shows means quitting and starting again.

## Plan

Raised by [moq-dev/studio#175](https://github.com/moq-dev/studio/pull/175),
which added the library (`rs/moq-studio/src/library.rs`) and the
`App::Library` state in `rs/moq-studio/src/main.rs`.

- Closing does what quitting does for the show: it flushes the autosave,
saves the show's picture for its library card, records how long it last
went live, finishes a recording, and closes the watch sessions, encoders,
and capture. Then the window shows the library, its cards refreshed.
- While on air, Close show is disabled, its tooltip saying to end the stream
first. Recommended over ending the stream as a side effect of closing (a
menu click should not end a broadcast that END STREAM makes the
broadcaster hold for) and over keeping the stream up across the switch (the
stream belongs to the show being closed).
- Its README entry and a `just shots` view of the menu with the row.
1 change: 0 additions & 1 deletion quest/m0/ux/first-run.md
Original file line number Diff line number Diff line change
Expand Up @@ -44,4 +44,3 @@ machine with a real camera and microphone, watched without helping.
## Required

- [Adding a source by picking a picture](/quest/m0/ux/add.md) - the cards with live pictures and meters
- [Going live from inside the app](/quest/m0/ux/go-live.md) - the show library it starts from and the relay it measures
74 changes: 0 additions & 74 deletions quest/m0/ux/go-live.md

This file was deleted.

18 changes: 12 additions & 6 deletions quest/m0/ux/settings.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,8 +9,8 @@ title bar's gear, as in
- **Show:** landscape or portrait, the canvas size and frame rate as a few
named choices with the numbers behind Custom, and per-scene sizes behind a
disclosure.
- **Stream:** the relay, failover, and options from
[go live](/quest/m0/ux/go-live.md).
- **Stream:** the relay, its token, the failover, the broadcast's name, and
on demand, as today's Stream tab holds them in `<show>.stream.toml`.
- **Recording:** the folder, what a recording holds, and each source too.
- **Hotkeys:** today's Hotkeys panel, on keycaps.
- **Guests:** the room, its key, the join page, and how long a link lasts.
Expand Down Expand Up @@ -40,10 +40,16 @@ bar.
says so before it applies while on air.
- The scene graph (`rs/moq-studio/src/ui/graph.rs`) opens from Advanced in a
window of its own.
- The Recording pane's folder and the Guests pane's room, key, join page, and
link lifetime are already fields of `<show>.stream.toml` (`recordings`,
`room`, `room_key`, `join_page`, `guest_expiry`), which go live
([moq-dev/studio#175](https://github.com/moq-dev/studio/pull/175)) saves
but gives no UI; the Recording tab shows and opens the folder but cannot
change it. These panes edit them there, and a flag that overrides one
shows it as the flag's, as the Stream pane does.
- A room or relay change reaches the open show's guests at once: the guest
room renews its links against the new room and relay, instead of only after
the show is reopened, as go live left it.

Human check: whether each setting is where a streamer would look for it, and
the words on each pane.

## Required

- [Going live from inside the app](/quest/m0/ux/go-live.md) - the Stream pane's settings and where they are saved
6 changes: 6 additions & 0 deletions quest/m0/ux/try-live.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,6 +25,12 @@ says where to find it). What to try:
edge, snapping to a screen edge, and full screen.
- **macOS:** the system title bar stays after first-run setup until the next
launch, then the studio's own frame replaces it.
- **Going live** ([moq-dev/studio#175](https://github.com/moq-dev/studio/pull/175)):
opening a show from the library, a real stream to a relay with your token
set in Settings, Stream (kept in the OS credential store; only Linux's
Secret Service has been exercised, so macOS's keychain matters most), the
GO LIVE sheet's checks, ending by holding END STREAM for 1.2 s, and the Go
live and End stream hotkeys while another app is full screen.

An agent then turns each finding into a quest, or an edit to the quest that
owns that page, and deletes this one.
Expand Down
4 changes: 0 additions & 4 deletions quest/m1/dual-format.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,3 @@ program source, cropped. This quest makes that one switch.
beside it, and Studio mode cues both.

Human check: a phone and a desktop viewer watching the same show.

## Required

- [Going live from inside the app](/quest/m0/ux/go-live.md) - a format per destination
4 changes: 0 additions & 4 deletions quest/m2/phone-remote.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,3 @@ Planned 2026-11-09 (maintainer, /quest-plan), and held for later: ✅ m2
- Removing a remote stops renewing its token, as for a guest.
- The page follows the look of the studio's LIVE page
([mock-up](/quest/m0/ux/mock/shell-live.webp)) at a phone's width.

## Required

- [Going live from inside the app](/quest/m0/ux/go-live.md) - the relay and room it is reached through
Loading
Loading