skills.rest
biodoia
biodoiaCOMMUNITY
Explore all skills by this author →
GitHub

wayland-multimonitor

Configure and troubleshoot multi-monitor setups on Wayland compositors.

Updated Aug 27, 2026
Search Tags:#troubleshooting#wayland#sway#hyprland#multimonitor#display-setup#vrr
One-click install
npx skills add https://github.com/biodoia/biodoia-skills-marketplace --skill wayland-multimonitor
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: wayland-multimonitor
Source: https://github.com/biodoia/biodoia-skills-marketplace/tree/main/plugins/wayland-multimonitor/skills/wayland-multimonitor
Command: npx skills add https://github.com/biodoia/biodoia-skills-marketplace --skill wayland-multimonitor

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

The Wayland multi-monitor skill helps users configure, troubleshoot, and optimize multi-display setups across Hyprland, Sway, KDE Plasma, and GNOME, including fractional scaling, per-monitor positioning, and screen sharing issues.

Core Features & Use Cases

  • Detect and analyze monitor layouts across major Wayland compositors.
  • Provide tailored configuration examples for Hyprland, Sway, KDE Plasma, and GNOME including monitor placement, scaling, and runtime commands.
  • Troubleshoot common issues such as hotplug, XWayland blurriness, VRR, and screen sharing with portals.

Quick Start

Install and open the Wayland Multi-Monitor skill, then follow the interactive prompts to tailor your setup.

Frequently Asked Questions about wayland-multimonitor

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

FAQPage Schema
How do I configure multi-monitor setups on Wayland compositors like Sway and Hyprland?▼

To configure multi-monitor setups on Wayland, you can use compositor-specific commands for monitor placement, scaling, and runtime adjustments. This skill provides tailored configuration examples and diagnostic workflows for Hyprland, Sway, KDE Plasma, and GNOME.

Why does my Wayland screen sharing fail during multi-monitor usage?▼

Wayland screen sharing failures during multi-monitor usage often stem from portal configuration issues. This skill troubleshoots screen sharing scenarios alongside hotplug handling and XWayland blurriness using a formalized diagnostic workflow.

Does this support fractional scaling on KDE Plasma and GNOME Wayland?▼

Yes, fractional scaling on KDE Plasma and GNOME is explicitly supported. The skill detects and analyzes monitor layouts across major Wayland compositors to provide tailored configuration examples for scaling and per-monitor positioning.

What is the best way to troubleshoot VRR and hotplug issues on Wayland?▼

The best way to troubleshoot VRR and hotplug issues on Wayland is to follow a formalized diagnostic workflow with compositor-specific commands. This skill provides troubleshooting steps and references configuration templates to resolve these display problems.

Related Skills

Explore More Software Engineering Skills→
viralcodeviralcode
61

niri-ipc

Control the Niri Wayland compositor via its IPC interface.

Community
Intermediate
austinprayaustinpray
5

sway-config

Configure Sway window manager keybindings, window rules, outputs, and inputs.

Community
Advanced
olafkfreundolafkfreund
21

niri

Configure Niri on NixOS with Home Manager for scrollable-tiling Wayland desktops.

Community
Advanced
olafkfreundolafkfreund
21

dankms

Configure DankMaterialShell for Wayland compositors on NixOS with theming and IPC.

Community
Advanced