Files
Piik/native/capture/linux
AAA cfc323adce feat(media): integrate embedded media services and shared native encoding
Embed STUN and SFU in the shared Go process, reuse native encoding pipelines with independent adaptation, and complete Client lifecycle, settings, diagnostics and packaging fixes. Retain standard Browser senders after measured encoded-reuse limitations.
2026-09-09 06:09:06 +08:00
..

Linux Capture Process

The Linux sidecar keeps the shared Native Client contract while delegating desktop integration to the standard Linux media stack. XDG Desktop Portal owns the screen/window choice, PipeWire supplies the selected stream, and GStreamer selects an installed element classified as a hardware H.264 video encoder. Screener adds only the current product profile, Annex-B access-unit framing, key-frame requests, and the bounded SMED output protocol.

The Portal restore token remains in the active share process and lets a live quality change reacquire the same selected source without inventing a second source picker. System playback audio uses the PipeWire PulseAudio compatibility service when its GStreamer source is installed. Per-process audio is not advertised.

Build on a Linux desktop with development packages for libportal and GStreamer:

sh native/capture/linux/build.sh /outside/repository/build

Runtime requirements are the desktop Portal/PipeWire services, a GStreamer PipeWire source, and an installed GStreamer hardware H.264 encoder. If any part is unavailable, the Client reports no Linux Native path and the same Browser capture choice remains available. These system libraries and services are not bundled; their distribution-provided license notices remain applicable. Linux Client packages repeat the dependency and source links in THIRD-PARTY-NOTICES.txt.

Primary references: