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

swayimg

Provides an image viewer and browser for Wayland environments with Lua-based configuration.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides a fast and efficient way to view and manage images on Wayland-based systems, offering both a detailed viewer and a convenient gallery mode.

Core Features & Use Cases

  • Image Viewing: View individual images with zoom, pan, rotate, and flip capabilities.
  • Gallery Browsing: Browse directories of images in a thumbnail grid.
  • Sway/Hyprland Integration: Display images as overlays within your terminal.
  • Use Case: Quickly review a directory of screenshots, applying custom configurations for appearance and keybindings to streamline your workflow.

Quick Start

Use the swayimg skill to open the image file '~/Pictures/my_photo.png' in viewer mode.

Frequently Asked Questions about swayimg

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

FAQPage Schema
How do I view images on Wayland with Lua configuration?▼

View images on Wayland using a viewer that supports Lua configuration to customize appearance and keybindings. It loads images from files, pipes, or external commands, offering zoom, pan, rotate, and flip capabilities.

Can I browse a directory of images as thumbnails in Sway or Hyprland?▼

Yes, you can browse directories of images in a thumbnail grid using gallery mode. The image browser integrates with Sway and Hyprland to display images as overlays directly within your terminal environment.

Does this Wayland image viewer support loading images from pipes and external commands?▼

Yes, the Wayland image viewer supports loading images directly from files, pipes, and external commands. This allows flexible image sourcing for various workflow automation scenarios on Wayland systems.

What is the best way to review a directory of screenshots on Wayland?▼

The best way to review screenshots on Wayland is using an image viewer with gallery and slideshow modes. It allows quick directory browsing and detailed individual image inspection with custom keybindings.

How do I set up a slideshow for multiple image formats on Wayland?▼

Set up a slideshow by opening multiple image formats in the viewer's slideshow mode. The Wayland image viewer supports various image formats and allows sequential viewing of multiple images.

What are the limitations of using Lua for image viewer configuration on Wayland?▼

Lua configuration is limited to customizing appearance and keybindings for the image viewer. It does not modify core Wayland compositor behavior or underlying image format support capabilities.

Related Skills

Explore More Software Engineering Skills→
olafkfreundolafkfreund
21

dankms

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

Community
Advanced
KaiserWhoLearnsKaiserWhoLearns

image_editing

Modify images via ImageMagick command-line tools for batch resizing, cropping, blurring, and format conversion.

Community
Intermediate
austinprayaustinpray
5

sway-config

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

Community
Advanced
benjaminshafiibenjaminshafii
10

telegram

Send Telegram messages to configured chats via the Bot API.

Community
Basic