skills.rest
milojarow
milojarowCOMMUNITY
Explore all skills by this author →
GitHub

swaybg

Manage wallpaper and background color settings for Wayland compositors.

Updated Aug 27, 2026
Search Tags:#configuration#background#wayland#sway#wallpaper#wlr-layer-shell
One-click install
npx skills add https://github.com/milojarow/dotfiles --skill swaybg
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: swaybg
Source: https://github.com/milojarow/dotfiles/tree/main/.claude/skills/swaybg
Command: npx skills add https://github.com/milojarow/dotfiles --skill swaybg

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill simplifies the process of setting and managing wallpapers or solid color backgrounds across multiple monitors in a Wayland environment, ensuring your desktop looks exactly how you want it.

Core Features & Use Cases

  • Set Backgrounds: Apply images or solid colors to your desktop.
  • Per-Output Configuration: Use different wallpapers or colors for each monitor.
  • Scaling Modes: Control how images fit your screen (fill, fit, stretch, center, tile).
  • Use Case: You have a high-resolution ultrawide monitor and a smaller portrait monitor. Use this Skill to set a wide panoramic image on the ultrawide and a simple color or a vertically oriented image on the portrait monitor.

Quick Start

Use the swaybg skill to set the wallpaper image '/home/user/wallpapers/main.jpg' with 'fill' scaling on all outputs.

Frequently Asked Questions about swaybg

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

FAQPage Schema
How do I set different wallpapers on multiple monitors in a Wayland compositor?▼

Set different wallpapers on multiple monitors in a Wayland compositor by using per-output configuration. This allows you to apply specific images or solid colors to individual screens, such as an ultrawide and a portrait monitor, simultaneously.

What image scaling modes are available for Wayland desktop backgrounds?▼

Available image scaling modes for Wayland desktop backgrounds include fill, fit, stretch, center, and tile. These options control how your wallpaper image fits the dimensions of your specific screen output.

Does swaybg work with any Wayland compositor or only sway?▼

swaybg works with Wayland compositors supporting the wlr-layer-shell protocol, not exclusively sway. It integrates directly with sway's output configuration and swaybg_command directive, but functions on any compatible wlroots-based desktop.

Can I use a solid color instead of an image for my Wayland wallpaper?▼

You can use a solid color instead of an image for your Wayland wallpaper. The tool manages both image display and solid color background settings for your desktop outputs.

How do I apply a panoramic image to an ultrawide monitor using sway?▼

Apply a panoramic image to an ultrawide monitor using sway by setting the wallpaper file path with the fill scaling mode. This ensures the high-resolution image stretches appropriately across the wide screen output.

Related Skills

Explore More Software Engineering Skills→
kettleofketchupkettleofketchup

hyprland

Configures Hyprland Wayland compositor settings on NixOS systems.

Community
Advanced
GodBlfGodBlf
1

firefly-background-wallpaper-config

Modify Firefly blog theme wallpaper and banner settings in src/config/backgroundWallpaper.ts.

Community
Basic
austinprayaustinpray
5

sway-config

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

Community
Advanced
dotBeepsdotBeeps

quickshell

Standardize QML-based Wayland desktop shell development with file structure and singleton conventions.

Community
Intermediate