WLSHIINA(1)

2024-10-03

NAME

wlshiina - utility to manually power off displays on Wayland

SYNOPSIS

wlshiina [-hV] [-d seconds]

DESCRIPTION

wlshiina is a utility to manually power off all displays/outputs of a Wayland session. As soon as an activity is registered (for example by pressing a key or moving the mouse), the outputs will be powered on again.

The options are as follows:

-d seconds

The time in seconds to ignore user activities after starting the program. This is useful if the program is started and the user touches the mouse right after by accident. In this case, powering on the outputs is probably not intended. The default value is 2 seconds.

-h

Print the usage string and exit.

-V

Print the version information and exit.

EXIT STATUS

On success, the exit status is 0. Otherwise, the exit status is 1.

KNOWN BUGS

This program currently only works with wlroots-based compositors.

Currently, the program does not work if an idle inhibitor is active. The outputs will be powered on again after the the time specified using the -d option.

AUTHORS

Created and maintained by Hannes Braun <hannes@hannesbraun.net>. Up-to-date sources can be found at https://git.sr.ht/~hannes/wlshiina. Bugs and patches can be submitted by email to ~hannes/public-inbox@lists.sr.ht.