Screen Recorder GNOME

Purpose & User Intent: This tool solves the need to record GNOME desktop sessions for tutorials, bug reports, demos, and support workflows. Target users include IT staff, developers, technical writers, and educators documenting Linux software usage. When: during software demos or issue reproduction.
Core Logic & Features: The recording engine supports full-screen, window, and region captures, with optional microphone, system audio, and webcam overlays. Outputs include MP4, WebM, or GIF, with adjustable frame rate and quality. Required features ensure accurate capture and stable encoding; optional features include hotkeys, presets, and CLI automation for scripted workflows.
Inputs & Outputs: Inputs include capture_mode (full|window|region), region_coords, fps, output_format, output_quality, audio_source (none|mic|system), webcam_device, duration_seconds, and output_path. Outputs provide a recorded_file_path, duration, and file_size in bytes, using the requested format and quality. Validation ensures required inputs are present and compatible with the running GNOME session.
Algorithms & Calculations: Encoding uses target bitrate and frame rate to estimate file size: size ≈ duration × bitrate. When system audio is selected, sample rate and channel count are matched to the input devices. Edge cases adjust for variable frame rate and dynamic scene complexity to avoid stutters. Industry/Region & Localization: Aligns with Linux desktop conventions, uses SI units, and outputs widely compatible formats (MP4/WebM). Compatibility notes cover Wayland vs X11 and regional date/time formatting in metadata if present. Assumptions & Exclusions: Not an editor; no streaming; not a live collaboration tool; does not capture encrypted content without permission; not designed for remote sessions.