NAME
riow – keyboard–controller for rio(1)

SYNOPSIS
riow [ –s label ]

DESCRIPTION
Riow provides keyboard controlling for rio(1) in the manner of i3, sway and ratpoison. It does so by working with /dev/kbdtap (see rio(4)) and /dev/wsys. Riow outputs the current desktop number onto fd 3, which can be used by programs like bar(1).

Running
A minimal example of running riow with status output to bar(1):
#!/bin/rc
</dev/kbdtap riow >/dev/kbdtap |[3] bar
Example of running riow with other programs handling input:
#!/bin/rc
</dev/kbdtap ktrans –G |
reform/shortcuts |
riow >/dev/kbdtap |[3] bar
Both examples assume putting the rc pipeline into a script and executing it with window(1) if they are required to start using riostart script.

Keyboard shortcuts
Kmod4+0…9
Switches to the specified virtual desktops. There are ten in total.
Kmod4+Shift+0…9
Moves the current window to the specified virtual desktop.
Kmod4+f
Toggle between fullscreen and normal mode for the current window.
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 winwatch, catclock, kbmap, etc are in sticky mode. Additional programs can be added to that list on startup by specifying their labels with –s option.
Kmod4+enter
Spawn a new window(1).
Kmod4+shift+q
Delete the current window.
Kmod4+h/j/k/l
Focus left/down/up/right.
Kmod4+arrows
Move the current window in the specified direction.
Kmod4+control+arrows
Same, but in bigger steps.
Kmod4+shift+arrows
Resize the current window.
Kmod4+shift+control+arrows
Same, but in bigger steps.

SOURCE
/sys/src/cmd/riow.c

SEE ALSO
bar(1), rio(4), ktrans(1)

HISTORY
Riow first appeared in 9front (September, 2022).

BUGS
Yes.