debug_capture

Diagnose Wayland screencopy capture issues in hdmi-wifi's src/screencopy_capture.rs.

Updated Jan 23, 2026
One-click install
npx skills add https://github.com/c4software/hdmi-wifi-hackathon --skill debug-capture
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug_capture
Source: https://github.com/c4software/hdmi-wifi-hackathon/tree/main/.agent/skills/debug_capture
Command: npx skills add https://github.com/c4software/hdmi-wifi-hackathon --skill debug-capture

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill guides developers through debugging and modifying the Wayland screencopy capture logic used by hdmi-wifi, helping diagnose issues in the capture pipeline and improve reliability.

Core Features & Use Cases

  • Navigate to src/screencopy_capture.rs and inspect capture flows, buffer handling, and frame callbacks.
  • Identify common issues such as missing Wayland global interfaces, black frames, or high latency, and apply targeted fixes.
  • Suitable for development-time debugging, code reviews, and onboarding new contributors to the hdmi-wifi capture module.

Quick Start

Run the debug_capture skill to inspect and adjust the screencopy_capture.rs logic in the hdmi-wifi project.

Frequently Asked Questions about debug_capture

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I debug black frames in a Wayland screencopy capture pipeline?

Debug Wayland screencopy black frames by inspecting buffer handling and frame callbacks in your capture logic. Diagnosing the capture flow helps identify missing Wayland global interfaces or incorrect buffer states causing the black frames.

What causes high latency in wlroots-based compositor screencopy?

High latency in wlroots-based screencopy stems from inefficient buffer handling or delayed frame callbacks. Diagnosing the capture flow allows you to identify these bottlenecks and apply targeted fixes to the capture logic.

How do I fix startup failures when capturing Wayland screencopy buffers?

Fix Wayland screencopy startup failures by checking for missing Wayland global interfaces. Inspecting the capture logic and verifying the environment helps diagnose initialization issues and apply necessary code corrections.

Do I need wayland-info to diagnose screencopy capture issues?

Yes, you need wayland-info and Wayland development tools to diagnose screencopy capture issues. These tools help inspect global interfaces and trace the capture flow, required for modifying the source code effectively.

What is the best way to trace Wayland screencopy frame callbacks?

The best way to trace Wayland screencopy frame callbacks is using Wayland tracing tools alongside inspecting the capture flow logic. This combination helps identify missing interfaces and high latency issues across wlroots-based compositors.

Why does my Wayland screencopy capture produce a black screen?

A Wayland screencopy capture produces a black screen due to improper buffer handling or missing Wayland global interfaces. Diagnosing the capture flow helps identify these specific issues and apply targeted fixes to the logic.