Repository navigation
Layer 0.7.0 replaces Python capture orchestration with a Rust, GSR-only recording core. The native Python/Qt editor remains; existing projects and the local control protocol stay compatible.
Install
For current Arch / CachyOS x86_64, download the package and matching SHA256SUMS below. Install vendor drivers and the distribution GPU Screen Recorder package first (its compatible system-managed KMS broker remains required). Keep the system fully updated, then:
sha256sum --check --ignore-missing layer-recorder-0.7.0-SHA256SUMS
sudo pacman -U ./layer-recorder-0.7.0-1-x86_64.pkg.tar.zst
layer doctor
layer uiThe package includes compiled GSR, the Rust recorder daemon, patched GSR overlay and offline subtitle engine. It does not install personal preferences or model weights, grant capture privileges, enable services, or restart existing captures. Save/stop active recordings before changing an installed source/service setup. Installation and migration.
Capture changes
- Rust now owns GSR producer processes, control IPC, private tmpfs allocation, incremental segment indexing, replay retention, normal-recording disk spooling and independent-source snapshots.
- Every video and audio producer is GSR. The wf-recorder fallback and pw-record → external-FFmpeg FLAC producer pipeline are removed.
- Independent application roles use exact PipeWire node selectors in the bundled GSR fork. Voice/media remain separate when the sound server exposes separate streams. New audio capture is Opus 256 kbps, rather than lossless FLAC; the editor still opens earlier media.
- One persistent PipeWire event stream replaces repeated full graph-dump subprocesses. Cached status stays responsive during replay saving; control work is queued separately.
- Native Settings, 60/300-second defaults, RAM replay, original GSR shortcut mirroring, silent saves and the editor remain available.
Hyprland is optional for capture
GSR supplies the authoritative source inventory. Hyprland may enrich geometry, focus naming and owned shortcuts. Without it, geometry is explicitly synthetic side-by-side and application folders use Desktop. Configure capture_targets: ["portal"] for an explicit permission-based GSR portal selection; direct monitor discovery is not required to succeed for this path.
Other desktops may bind the existing Layer CLI commands themselves. KDE/GNOME/X11 session certification and portal global-shortcut support are not claimed. Advanced X11-window/camera selectors are source-level integrations with upstream requirements and still need hardware/session verification.
Upgrade notes and remaining gaps
The independent-track core requires the matching Layer GSR fork; an unmodified system engine lacks its node-selector/timing extensions and is rejected. Legacy capture_backend: wf-recorder, nonempty wf_recorder_binary, or wf_no_dmabuf: true must be migrated to GSR settings. There is no silent alternate-engine or CPU capture fallback.
GSR compatibility matrix lists upstream capture features, Layer support, missing HDR/10-bit/Vulkan controls, region/screenshot/streaming capture, native-GSR IPC/pause, automatic monitor hotplug and platform limitations. Native GSR audio-only replay is unsupported upstream; Layer preserves independent audio through its own segmented RAM ring.
Validation and source rebuild
- 10 Rust tests passed.
- 81 Python tests ran: 78 passed, 3 opt-in GPU tests skipped. This includes real Rust socket/lifecycle tests using explicitly synthetic video.
- GitHub CI passed the Rust job and Python 3.12/3.13/3.14 jobs.
- Native Settings smoke test passed. Actual NVIDIA GSR HEVC video plus independent GSR Opus application/microphone capture was saved without warnings, including complete 60-second and 300-second replay saves in the installed core, with replay continuing afterward.
- The compiled package installed and opened in a clean Arch container. Complete corresponding sources rebuilt the Rust core offline with networking disabled.
- Package/source/checksum audits passed. No personal settings, recordings or downloaded speech weights are included.
Physical AMD/Intel validation of the new Rust capture path remains open. Earlier vendor/export results are documented as baseline evidence, not certification of this migration. No multi-hour soak is claimed.
Build guide · Configuration · Architecture
Use the corresponding-sources archive for the exact patched GSR UI, its submodules, whisper.cpp and vendored Rust dependencies matching the binaries. GitHub's automatic source archive alone omits separately fetched dependencies. GPL-3.0-only and original component notices are retained; compiled packages include dependency licenses.