skills.rest
kettleofketchup
kettleofketchupCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

sway

Configure a stable Sway Wayland compositor session on NixOS.

Updated Apr 3, 2026
Search Tags:#wayland#nixos#home-manager#sway#wails#multi-gpu#webkit2gtk
One-click install
npx skills add https://github.com/kettleofketchup/KettleOfSkills --skill sway
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: sway
Source: https://github.com/kettleofketchup/KettleOfSkills/tree/main/plugins/sway/skills/sway
Command: npx skills add https://github.com/kettleofketchup/KettleOfSkills --skill sway

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill eliminates the tedious, error-prone process of manually configuring a Sway Wayland compositor session on NixOS, especially for developers working with Wails desktop apps or multi-GPU hardware, and prevents common configuration mistakes that break XDG portals, screen sharing, and application rendering.

Core Features & Use Cases

  • Complete Sway Module Guidance: Covers all NixOS programs.sway options, including auto-wired services to avoid duplicate conflicting configurations.
  • Multi-GPU Support: Provides vendor-specific configuration for Intel, AMD, and NVIDIA (including hybrid PRIME offload setups) with correct environment variable placement for Sway.
  • Wails App Rendering Fixes: Resolves blank window and rendering glitches for webkit2gtk-based Wails applications on integrated and discrete GPUs.
  • Animated Wallpaper Setup: Guides implementation of video and animated image wallpapers using wlroots-compatible tools like mpvpaper and awww.
  • Use Case: A developer with a NixOS laptop featuring hybrid Intel/NVIDIA graphics can use this skill to configure a working Sway session with proper GPU offloading, functional Wails app rendering, and animated video wallpapers without manual trial and error.

Quick Start

Use the sway skill to generate a complete, working NixOS configuration for a Sway Wayland session with Wails app support and multi-GPU handling tailored to your hardware.

Frequently Asked Questions about sway

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

FAQPage Schema
How do I configure a Sway Wayland session on NixOS without breaking XDG portals?▼

Configuring Sway on NixOS without breaking XDG portals requires using the NixOS `programs.sway` module to auto-wire services and avoid duplicate configurations. This prevents conflicting service definitions that typically break screen sharing and application rendering.

How do I set up Sway with NVIDIA hybrid graphics on NixOS?▼

Setting up Sway with NVIDIA hybrid graphics on NixOS involves placing vendor-specific GPU environment variables correctly for PRIME offload. This ensures the discrete GPU activates properly within the wlroots-based Wayland session.

Why do Wails desktop apps show blank windows in Sway and how do I fix it?▼

Wails desktop apps show blank windows in Sway due to webkit2gtk DMA-BUF renderer issues. Fix this by applying specific webkit2gtk renderer workarounds and configuring correct GPU offloading for integrated and discrete graphics.

Can I use home-manager to manage my Sway configuration on NixOS?▼

Yes, you can use home-manager to manage Sway on NixOS. Proper home-manager Sway module integration ensures your user-specific desktop settings do not conflict with the system-level NixOS `programs.sway` service definitions.

How do I set animated video wallpapers in a Sway Wayland session?▼

To set animated video wallpapers in a Sway Wayland session, deploy wlroots-compatible tools like mpvpaper or awww. These tools render video and animated image wallpapers directly on the compositor without requiring X11 dependencies.

What causes duplicate service conflicts when starting Sway on NixOS?▼

Duplicate service conflicts when starting Sway on NixOS are caused by manually enabling services that the `programs.sway` module already auto-wires. Relying on the module's auto-wired services prevents these session-breaking configuration overlaps.

Related Skills

Explore More Software Engineering Skills→
olafkfreundolafkfreund
21

niri

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

Community
Advanced
LamseyahEliasLamseyahElias

hermes-agent

Configure and extend Hermes Agent for multi-agent orchestration across gateways.

Community
Advanced
kettleofketchupkettleofketchup

hyprland

Configures Hyprland Wayland compositor settings on NixOS systems.

Community
Advanced
c4softwarec4software

debug_capture

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

Community
Intermediate