Skip to content

Features Screen Recording

Tuck edited this page Jun 28, 2026 · 2 revisions

Screen Recording

PipeWire-based screen recording via the GNOME ScreenCast portal.

Note: The canonical documentation for screen recording is in screencast_video_recording.md. This page is a convenience alias.

  • Real-time video capture via PipeWire
  • Web dashboard at http://localhost:20129 for monitoring and control
  • Event broadcasting on screencast.* patterns for real-time updates
  • MCP-exposed actions for AI agent control

Start Recording

deskbrid screencast.start { output_path: "/tmp/recording.mp4" }

Parameters:

  • output_path: file path (required). Supports %Y%m%d_%H%M%S strftime.
  • audio: boolean (default: false)
  • camera: boolean (default: false)
  • cursor: boolean (default: true)

Stop Recording

deskbrid screencast.stop

Web Dashboard

The dashboard at http://localhost:20129 shows:

  • Live capture preview
  • Recording status and duration
  • Stop controls
  • Audio level visualization
  • Frame rate and resolution

Events

Subscribe to:

  • screencast.started
  • screencast.stopped
  • screencast.frame
  • screencast.error
{"type":"event.subscribe","events":["screencast.*"]}

Clone this wiki locally