blob: 9fe5d36a61c1eb32da49f25db354b4ebe5478893 (
plain)
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
|
.TH RIOW 1
.SH NAME
riow \- keyboard-controller for rio(1)
.SH SYNOPSIS
.B riow
[
.I -s label
]
.SH DESCRIPTION
.I riow
provides keyboard controlling for
.IR rio (1)
in the manner of
.IR i3 ,
.I sway
and
.IR ratpoison .
It does so by working with
.I /dev/kbdtap
(see \fIrio\fR(4)) and
.IR /dev/wsys .
.I riow
outputs the current desktop number onto fd 3, which can be used by programs like
.IR bar (1).
.SS Running
A minimal example of running
.I riow
with status output to
.IR bar (1):
.EX
</dev/kbdtap riow >/dev/kbdtap |[3] bar
.EE
Example of running
.I riow
with other programs handling input:
.EX
</dev/kbdtap ktrans |
reform/shortcuts |
riow >/dev/kbdtap |[3] bar
.EE
.SS Keyboard shortcuts
.TP
.B Kmod4+0…9
Switches to the specified virtual desktops. There are ten in total.
.TP
.B Kmod4+Shift+0…9
Moves the current window to the specified virtual desktop.
.TP
.B Kmod4+f
Toggle between fullscreen and normal mode for the current window.
.TP
.B Kmod4+s
Toggle "sticky" mode for the current window. In this mode the window is staying
while the user is switching between desktops. By default, programs like
.IR winwatch ,
.IR catclock ,
.IR kbmap ,
etc are in sticky mode. Additional programs can be added to that list on startup by
specifying their labels with
.I -s
option.
.TP
.B Kmod4+enter
Spawn a new
.IR window (1).
.TP
.B Kmod4+shift+q
Delete the current window.
.TP
.B Kmod4+h/j/k/l
Focus left/down/up/right.
.TP
.B Kmod4+arrows
Move the current window in the specified direction.
.TP
.B Kmod4+control+arrows
Same, but in bigger steps.
.TP
.B Kmod4+shift+arrows
Resize the current window.
.TP
.B Kmod4+shift+control+arrows
Same, but in bigger steps.
.SH SOURCE
/sys/src/cmd/riow.c
.SH SEE ALSO
.IR bar (1),
.IR rio (4),
.IR ktrans (1)
.SH HISTORY
Riow first appeared in 9front (September, 2022).
.SH BUGS
Yes.
|
