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

swaylock

Secure Wayland sessions with swaylock and customize the unlock indicator.

Updated Aug 27, 2026
Search Tags:#security#customization#wayland#swayidle#screen lock#swaylock
One-click install
npx skills add https://github.com/milojarow/dotfiles --skill swaylock
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: swaylock
Source: https://github.com/milojarow/dotfiles/tree/main/.claude/skills/swaylock
Command: npx skills add https://github.com/milojarow/dotfiles --skill swaylock

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill provides a robust and highly customizable screen locking utility for Wayland environments, ensuring your session is secure while allowing for personalized visual themes.

Core Features & Use Cases

  • Secure Locking: Implements the ext-session-lock-v1 protocol for secure screen locking.
  • Visual Customization: Offers extensive options for background images, solid colors, and detailed indicator theming (colors, shapes, fonts).
  • Integration: Works seamlessly with swayidle for automatic locking before sleep or after inactivity.
  • Use Case: Lock your Wayland session with a custom background image and a themed indicator that changes color based on input status, ensuring both security and aesthetic appeal.

Quick Start

Lock your screen using swaylock with a custom background image and a solid dark color.

Frequently Asked Questions about swaylock

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

FAQPage Schema
How do I lock my Wayland session with a custom background image?▼

Yes, you can customize the unlock indicator by configuring detailed visual theming options, allowing the indicator to change colors and shapes based on your input status for a personalized lock screen experience.

Does swaylock work with swayidle for automatic screen locking?▼

Yes, swaylock integrates seamlessly with swayidle to enable automatic screen locking, triggering the lock screen before system sleep or after a defined period of inactivity to secure your Wayland session.

What protocol does swaylock use for secure screen locking on Wayland?▼

Swaylock implements the ext-session-lock-v1 protocol to provide secure screen locking for Wayland environments, ensuring your session remains protected during inactivity and system sleep states.

Can I configure swaylock to use a solid color background instead of an image?▼

Yes, you can configure swaylock to use solid colors for the background and various visual theming elements, providing a clean and minimal lock screen alternative to custom background images.

Related Skills

Explore More Software Engineering Skills→
olafkfreundolafkfreund
21

dankms

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

Community
Advanced
Sounder25Sounder25
27

Project-Wide Rename

Renames a selected project in-place across a Git worktree for you.

Community
Advanced
aaronbassettaaronbassett
4

settings-presets:configure-powerline

Configure Claude Code's powerline status line by updating JSON settings.

Community
Advanced
venomez-vipervenomez-viper
1

test-contract

Generate contract test suites that validate protocol implementations.

Community
Advanced