Swaylock - Revision history

Phobos at 03:30, 1 January 2026

2026-01-01T03:30:12Z

← Older revision		Revision as of 03:30, 1 January 2026
Line 8:		Line 8:
	];\|name=/etc/nixos/configuration.nix\|lang=nix}}		];\|name=/etc/nixos/configuration.nix\|lang=nix}}

	~~=== Through Sway ===~~		=== Home Manager - Standalone ===
	~~{{File\|3=programs.sway.extraPackages = with pkgs; [swaylock];\|name=/etc/nixos/configuration.nix\|lang=nix}}~~

	=== Home Manager ===
	{{file\|~/.config/home-manager/home.nix\|nix\|3=		{{file\|~/.config/home-manager/home.nix\|nix\|3=
	programs.swaylock.enable = true;		programs.swaylock.enable = true;
	}}		}}

			=== Home Manager - Through Sway ===
			{{File\|3=programs.sway.extraPackages = with pkgs; [swaylock];\|name=/etc/nixos/configuration.nix\|lang=nix}}

	{{Warning\|1=If you don't use the Sway module (<code>programs.sway.enable</code>) you need to set <code>security.pam.services.swaylock = {};</code> manually.}}		{{Warning\|1=If you don't use the Sway module (<code>programs.sway.enable</code>) you need to set <code>security.pam.services.swaylock = {};</code> manually.}}

Phobos: Updated Swaylock page

2026-01-01T03:18:09Z

Updated Swaylock page

← Older revision		Revision as of 03:18, 1 January 2026
Line 1:		Line 1:
	swaylock is a screen locking utility for Wayland compositors.		[https://github.com/swaywm/swaylock Swaylock] is a screen locking utility for Wayland compositors.

	== Installation ==		== Installation ==

	~~Install via~~ [~~[Home Manager]~~]:		=== Standalone ===
			{{File\|3=environment.systemPackages = with pkgs; [
			swaylock
			];\|name=/etc/nixos/configuration.nix\|lang=nix}}

			=== Through Sway ===
			{{File\|3=programs.sway.extraPackages = with pkgs; [swaylock];\|name=/etc/nixos/configuration.nix\|lang=nix}}

			=== Home Manager ===
	{{file\|~/.config/home-manager/home.nix\|nix\|3=		{{file\|~/.config/home-manager/home.nix\|nix\|3=
	programs.swaylock.enable = true;		programs.swaylock.enable = true;
	}}		}}

	~~The following settings may be required.~~		{{Warning\|1=If you don't use the Sway module (<code>programs.sway.enable</code>) you need to set <code>security.pam.services.swaylock = {};</code> manually.}}

	{{~~file~~\|/~~etc/nixos/configuration.nix\|nix\|3=~~
	security.pam.services.swaylock = {};
	}}

	== Configuration ==		== Configuration ==

	~~swaylock can~~ be configured using [[Home Manager]]:		Swaylock may be configured using [[Home Manager]], options may be found under the [https://nix-community.github.io/home-manager/options.xhtml#opt-programs.swaylock.enable Home Manager Appendix - programs.sway.enable].

	~~{{file\|~~~/.~~config~~/home-manager/~~home~~.~~nix\|nix\|3=~~
	programs.swaylock.~~settings = { color = "808080"; };~~
	}}

	~~Alternatively, you may write configuration without using Nix language:~~		{{File\|3=programs.swaylock = {
			enable = true;
			settings = {
			color = "808080";
			font-size = 24;
			indicator-idle-visible = false;
			indicator-radius = 100;
			line-color = "ffffff";
			show-failed-attempts = true;
			};
			};\|name=/etc/nixos/home.nix\|lang=nix}}

	{{file~~\|~/.~~config~~/home-manager/home.nix\|nix\|3=~~		If you would like to use a config file instead you may instead specify a config file.
	~~xdg.configFile."swaylock/config".source =~~ .~~/swaylock-theme;~~
	}}

	~~You may find~~ "~~Swaylock~~ theme~~"s shared on the web~~.		{{File\|3=xdg.configFile."swaylock/config".source = ./swaylock-theme;\|name=/etc/nixos/home.nix\|lang=nix}}

	=== Adding background ===		=== Adding background ===

34j: /* Adding background */

2025-07-05T03:06:36Z

Adding background

← Older revision		Revision as of 03:06, 5 July 2025
Line 33:		Line 33:
	=== Adding background ===		=== Adding background ===

	You can add background declaratively using {{Nixpkgs Manual\|name=fetchurl\|anchor=#sec-pkgs-fetchers-fetchurl}} similar to [[Wallpapers for Wayland]]. In this example, a wallpaper in [https://github.com/NixOS/nixos-artwork/tree/master/wallpapers nixos-artwork] is ~~used~~.		You can add background declaratively using {{Nixpkgs Manual\|name=fetchurl\|anchor=#sec-pkgs-fetchers-fetchurl}} similar to [[Wallpapers for Wayland]]. In this example, a wallpaper in [https://github.com/NixOS/nixos-artwork/tree/master/wallpapers nixos-artwork] is set to {{ic\|image}} attribute and the remaining configuration from {{ic\|./swaylock}} are merged.

	{{file\|~/.config/home-manager/home.nix\|nix\|3=		{{file\|~/.config/home-manager/home.nix\|nix\|3=

34j: /* Configuration */ Add Adding Background

2025-07-05T03:04:28Z

Configuration: Add Adding Background

← Older revision		Revision as of 03:04, 5 July 2025
Line 30:		Line 30:

	You may find "Swaylock theme"s shared on the web.		You may find "Swaylock theme"s shared on the web.

			=== Adding background ===

			You can add background declaratively using {{Nixpkgs Manual\|name=fetchurl\|anchor=#sec-pkgs-fetchers-fetchurl}} similar to [[Wallpapers for Wayland]]. In this example, a wallpaper in [https://github.com/NixOS/nixos-artwork/tree/master/wallpapers nixos-artwork] is used.

			{{file\|~/.config/home-manager/home.nix\|nix\|3=
			xdg.configFile."swaylock/config".text =
			let
			src = pkgs.fetchurl {
			url = "https://raw.githubusercontent.com/NixOS/nixos-artwork/8957e93c95867faafec7f9988cedddd6837859fa/wallpapers/nix-wallpaper-binary-black.png";
			sha256 = "0v3111a1ihsh4ajijbjh6y7a8p5cb5g3rdxqjbzx37pn1k9s254s";
			};
			in
			''
			image=${src}
			''
			+ builtins.readFile ./swaylock;
			}}

	== Forks ==		== Forks ==

34j at 13:30, 4 July 2025

2025-07-04T13:30:16Z

← Older revision		Revision as of 13:30, 4 July 2025
Line 26:		Line 26:

	{{file\|~/.config/home-manager/home.nix\|nix\|3=		{{file\|~/.config/home-manager/home.nix\|nix\|3=
	xdg.configFile."swaylock/config" = ./swaylock		xdg.configFile."swaylock/config".source = ./swaylock-theme;
	}}		}}

34j at 13:27, 4 July 2025

2025-07-04T13:27:54Z

← Older revision		Revision as of 13:27, 4 July 2025
Line 20:		Line 20:

	{{file\|~/.config/home-manager/home.nix\|nix\|3=		{{file\|~/.config/home-manager/home.nix\|nix\|3=
	programs.swaylock.settings = {};		programs.swaylock.settings = { color = "808080"; };
	}}		}}

34j: Add Configuration

2025-07-04T13:27:15Z

Add Configuration

@@ Line 14: / Line 14: @@
 security.pam.services.swaylock = {};
 }}
 == Forks ==

34j: Add Swaylock

2025-07-04T10:25:25Z

Add Swaylock

New page

swaylock is a screen locking utility for Wayland compositors.

== Installation ==

Install via [[Home Manager]]:

{{file|~/.config/home-manager/home.nix|nix|3=
programs.swaylock.enable = true;
}}

The following settings may be required.

{{file|/etc/nixos/configuration.nix|nix|3=
security.pam.services.swaylock = {};
}}

== Forks ==

{{nixos:package|swaylock-effects}} allows built-in screenshots and image manipulation effects like blurring.

{{file|~/.config/home-manager/home.nix|nix|3=
programs.swaylock.package = pkgs.swaylock-effects;
}}

[[Category:Applications]]