overthinkos/wf-recorder
selkies/skills/wf-recorder/SKILL.md
Wayland screen recorder for wlroots compositors. Use when working with the wf-recorder candy.
tools
Updated Jun 12, 2026
$ install --global
skillsauthnpx skillsauth add overthinkos/overthink-plugins wf-recorderInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Jun 12, 2026, 6:50 AM47.8s1 file scanned
SKILL.md
- name:
- wf-recorder
- description:
- |
wf-recorder -- Wayland screen recorder
Candy Properties
| Property | Value |
|----------|-------|
| Install files | charly.yml (packages only) |
| Depends | none |
Packages
RPM: wf-recorder
What It Does
Native Wayland screen recorder for wlroots-based compositors (sway, labwc, etc.). Captures frames via the wlr-screencopy protocol and encodes to MP4/MKV using system ffmpeg. Supports audio capture with --audio.
Note: Does NOT work on selkies-desktop — use wl-record-pixelflux instead (labwc nested in pixelflux can't deliver screencopy frames).
Usage
# box or candy charly.yml
candy:
- wf-recorder
CLI Usage
# Direct usage (inside container)
wf-recorder -f output.mp4 # Record to MP4
wf-recorder -f output.mp4 --audio # With audio
wf-recorder -f output.mp4 -r 60 # 60fps
# Stop with Ctrl-C
Integration with charly eval record
# Start recording sway desktop (auto-detects wf-recorder)
charly eval record start sway-browser-vnc -n demo --mode desktop
# Interact with desktop
charly eval wl click sway-browser-vnc 640 360
charly eval record cmd sway-browser-vnc "neofetch" -n demo
# Stop and copy to host
charly eval record stop sway-browser-vnc -n demo -o demo.mp4
Included In
sway-desktopmetalayer (and all boxes using sway-desktop-vnc)
Used In Boxes
/charly-selkies:sway-browser-vnc(viasway-desktopmetalayer)
Cross-References
/charly-eval:record—charly eval record start --mode desktopauto-detects wf-recorder/charly-selkies:wl-record-pixelflux— Alternative for selkies-desktop (pixelflux pipeline)/charly-selkies:wl-screenshot-grim— Screenshot companion (same wlr-screencopy protocol)/charly-selkies:sway-desktop— Parent metalayer
When to Use This Skill
Use when the user asks about:
- Desktop video recording on sway
- wf-recorder in containers
- The
wf-recordercandy
Related
/charly-image:layer— candy authoring reference (charly.ymlschema, task verbs, service declarations)/charly-eval:eval— declarative testing (eval:block,charly eval box,charly eval live)
Related Skills
overthinkos/charly
tools
VerifiedTrustedCommunity
OpenCharly CLI (charly) binary installed into container/VM images for in-container use. Use when working with charly binary deployment inside containers, native D-Bus support, or the full charly toolchain (charly binary + virtualization + gocryptfs + socat).
SKILL.mdUpdated Jun 10, 2026
overthinkos/charly-cachyos
development
VerifiedTrustedCommunity
Operator CachyOS workstation profile — a kind:local template + target:local deploy that installs the full dev stack (30 candies) onto a CachyOS host via ShellExecutor. Lives in the overthinkos/cachyos submodule. MUST be invoked before editing or applying the charly-cachyos workstation profile.
SKILL.mdUpdated Jun 10, 2026
overthinkos/charly-fedora
tools
VerifiedTrustedCommunity
Fedora box with the full charly toolchain using shared candies. Rootless-first — runs as uid=1000 with passwordless sudo (no root, no cap_add: ALL). Same candy list as charly-arch. Includes NVIDIA GPU runtime. MUST be invoked before building, deploying, configuring, or troubleshooting the charly-fedora box.
SKILL.mdUpdated Jun 10, 2026
overthinkos/charly-arch
tools
VerifiedTrustedCommunity
Arch Linux box with the full charly toolchain. Rootless-first — runs as uid=1000 with passwordless sudo (no root, no cap_add: ALL). Composes /charly-coder:charly-mcp so the box is reachable as an MCP gateway on port 18765. NVIDIA GPU runtime composed in. MUST be invoked before building, deploying, configuring, or troubleshooting the charly-arch box.
SKILL.mdUpdated Jun 10, 2026