aboutsummaryrefslogtreecommitdiffstats
path: root/swaylock/swaylock.1.txt
blob: 9dbc00a27df9e585a2700228be7ee0eed5b213b8 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
/////
vim:set ts=4 sw=4 tw=82 noet:
/////
:quotes.~:

swaylock (1)
============

Name
----
swaylock - Screen locker for sway

Synopsis
--------
'swaylock' [options]

Lock the current sway session.

Options
-------

*-h, --help*::
	Show help message and quit.

*-c, \--color* <rrggbb[aa]>::
	Turn the screen into the given color. If -i is used, this sets the
	background of the image to the given color. Defaults to white (ffffff), or
	transparent (00000000) if an image is in use.

*-f, \--daemonize*::
	Fork into the background after spawning. Note: this is the default behavior of
	i3lock.

*-i, \--image* [<output>:]<path>::
	Display the given image, optionally only on the given output. Use -c to set
	a background color.

*--scaling*::
	Scaling mode for images: stretch, fill, fit, center, or tile.

*-t, --tiling*::
	Same as --scaling=tile.

*-u, --no-unlock-indicator*::
	Disable the unlock indicator.

*-v, \--version*::
	Show the version number and quit.

*--socket <path>*::
	Use the specified socket path. Otherwise, swaymsg will ask sway where the
	socket is (which is the value of $SWAYSOCK, then of $I3SOCK).

Appearance
----------

*--bshlcolor* <rrggbb[aa]>::
	Sets the color of backspace highlight segments.

*--font* <font>::
	Sets the font of the text inside the indicator.

*--insidecolor* <rrggbb[aa]>::
	Sets the color of the inside of the indicator when typing or idle.

*--insidevercolor* <rrggbb[aa]>::
	Sets the color of the inside of the indicator when verifying.

*--insidewrongcolor* <rrggbb[aa]>::
	Sets the color of the inside of the indicator when invalid.

*--keyhlcolor* <rrggbb[aa]>::
	Sets the color of keypress highlight segments.

*--linecolor* <rrggbb[aa]>::
	Sets the color of the lines that separate the inside and outside of the
	indicator.

*-s, \--line-uses-inside*::
	Use the color of the inside of the indicator for the line separating the
	inside and outside of the indicator.

*-r, \--line-uses-ring*::
	Use the outer ring's color for the line separating the inside and outside of
	the indicator.

*--ringcolor* <rrggbb[aa]>::
	Sets the color of the outside of the indicator when typing or idle.

*--ringvercolor* <rrggbb[aa]>::
	Sets the color of the outside of the indicator when verifying.

*--ringwrongcolor* <rrggbb[aa]>::
	Sets the color of the outside of the indicator when invalid.

*--separatorcolor* <rrggbb[aa]>::
	Sets the color of the lines that seperate highlight segments.

*--textcolor* <rrggbb[aa]>::
	Sets the color of the text inside the indicator.

*--indicator-radius* <radius>::
	Sets the radius of the indicator to _radius_ pixels. The default value is
	50.

*--indicator-thickness* <thickness>::
	Sets the thickness of the indicator to _thickness_ pixels. The default value
	is 10.

Authors
-------

Maintained by Drew DeVault <sir@cmpwn.com>, who is assisted by other open
source contributors. For more information about sway development, see
<https://github.com/swaywm/sway>.