sway-outputs

Configure Sway display outputs with resolution, scaling, and power settings.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/milojarow/dotfiles --skill sway-outputs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sway-outputs
Source: https://github.com/milojarow/dotfiles/tree/main/.claude/skills/sway-outputs
Command: npx skills add https://github.com/milojarow/dotfiles --skill sway-outputs

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill allows for precise configuration and management of display outputs within the Sway window manager, ensuring optimal multi-monitor setups and visual presentation.

Core Features & Use Cases

  • Display Configuration: Set resolution, refresh rate, scaling, and positioning for multiple monitors.
  • Wallpaper & Power Management: Define desktop backgrounds and control display power states (DPMS).
  • Advanced Rendering: Configure adaptive sync, HDR, and color profiles for enhanced visual fidelity.
  • Use Case: Setting up a new workstation with two external monitors and a laptop screen, ensuring they are correctly positioned, scaled, and have a consistent wallpaper applied.

Quick Start

Use the sway-outputs skill to configure the HDMI-A-1 output to a resolution of 1920x1080 at 60Hz and place it to the right of the primary display.

Frequently Asked Questions about sway-outputs

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

FAQPage Schema
How do I configure multi-monitor displays in the Sway window manager?

Use declarative directives in the Sway configuration file to set resolution, refresh rate, scaling, and positioning for each output. This manages multi-monitor setups by defining individual display parameters directly in the configuration.

Can I set fractional scaling for Wayland outputs in Sway?

Yes, Sway supports fractional scaling for Wayland outputs. You define scaling values through declarative directives in the Sway configuration file to achieve precise display scaling on high-resolution monitors.

Does Sway support adaptive sync and HDR configuration?

Yes, Sway supports adaptive sync and HDR configuration. You can configure these advanced rendering features alongside color profiles through declarative directives in the Sway configuration file to enhance visual fidelity.

How do I manage display power states and wallpapers in Sway?

Manage display power states and wallpapers in Sway by defining desktop backgrounds and power management directives in the Sway configuration file. This controls DPMS power states and applies visual presentation settings to outputs.

What is the best way to position external monitors relative to a laptop screen in Sway?

Position external monitors in Sway by using output directives in the Sway configuration file to place displays relative to one another. You can set an HDMI output to the right of the primary display using declarative positioning.