wayland-automation

Automate window management, input simulation, and screen capture on the niri Wayland compositor.

1|Updated Sep 5, 2025
One-click install
npx skills add https://github.com/Ramblurr/nix-devenv --skill wayland-automation
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wayland-automation
Source: https://github.com/Ramblurr/nix-devenv/tree/main/prompts/skills/wayland-automation
Command: npx skills add https://github.com/Ramblurr/nix-devenv --skill wayland-automation

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill enables programmatic control and interaction with the niri Wayland compositor, allowing for automation of window management, input simulation, and screen capture.

Core Features & Use Cases

  • Window Management: Query and manipulate windows, workspaces, and focus using niri's IPC.
  • Input Simulation: Send keyboard and mouse inputs to applications via wtype and wlrctl.
  • Screen Capture: Capture specific application windows using OBS Studio integration.
  • Clipboard Operations: Read from and write to the Wayland clipboard.
  • Use Case: Automate repetitive tasks like filling forms in GUI applications, taking screenshots of specific windows for reports, or scripting UI interactions within a controlled Wayland environment.

Quick Start

Automate Wayland by querying all open windows using niri's IPC.

Frequently Asked Questions about wayland-automation

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

FAQPage Schema
How do I automate GUI interactions on a Wayland compositor?

To automate GUI interactions on Wayland, you query niri's IPC for window management and use virtual input protocols for input simulation. This enables scripting repetitive desktop tasks like form filling and window manipulation.

Can I capture screenshots of specific application windows in Wayland?

Capturing specific application windows in Wayland is supported through OBS Studio integration. This feature enables precise screenshots of targeted applications for reporting or controlled screen capture tasks.

Does this automation approach work with niri and OBS Studio?

Yes, this automation approach works directly with the niri Wayland compositor by leveraging its IPC, and it integrates with OBS Studio specifically for dynamic screen capture and precise window screenshotting.

How do I simulate keyboard and mouse inputs in a Wayland environment?

Simulating keyboard and mouse inputs in Wayland is done using virtual input protocols via tools like wtype and wlrctl. This sends simulated user input directly to applications within the niri compositor.

What are the limitations of window management automation in Wayland?

Window management automation in Wayland is limited to environments using the niri compositor and its specific IPC. It requires a controlled Wayland setup and may not function under X11 or unsupported compositors.