forked from virt-mirrors/wayneko
161 lines
3.9 KiB
Groff
161 lines
3.9 KiB
Groff
.TH WAYNEKO 1 2024-03-24 "copeberg.org/virt/wayneko" "General Commands Manual"
|
|
.
|
|
.SH NAME
|
|
.P
|
|
wayneko \- Neko on Wayland but with phases
|
|
.
|
|
.
|
|
.SH SYNOPSIS
|
|
.SY wayneko
|
|
.OP \-h
|
|
.OP \-\-help
|
|
.OP \-?
|
|
.YS
|
|
.
|
|
.SY wayneko
|
|
.OP \-\-background\-colour 0xRRGGBB[AA]
|
|
.OP \-\-outline\-colour 0xRRGGBB[AA]
|
|
.OP \-\-type plain|striped|random
|
|
.OP \-\-wall none|left|right|both
|
|
.OP \-\-idle-sleep seconds
|
|
.OP \-\-sleep-phase seconds-seconds
|
|
.OP \-\-awake-phase seconds-seconds
|
|
.OP \-\-currently awake|asleep|random
|
|
.OP \-\-layer background|bottom|top|overlay
|
|
.OP \-\-output name
|
|
.OP \-\-position float
|
|
.OP \-\-survive\-close
|
|
.YS
|
|
.
|
|
.
|
|
.SH DESCRIPTION
|
|
.P
|
|
Display an animated neko cat on the bottom of an output.
|
|
Responds to the pointer being near the bottom edge of that output.
|
|
While most cats are usually active at night, wayneko likes to mostly sleep when
|
|
it's late, only occasionally waking.
|
|
.P
|
|
Requires the Wayland server to implement \fBzwlr-layer-shell-unstable-v1\fR.
|
|
.
|
|
.
|
|
.SH OPTIONS
|
|
.P
|
|
\fB\-h\fR, \fB\-\-help\fR, \fB\-?\fR
|
|
.RS
|
|
Print help text and exit.
|
|
.RE
|
|
.
|
|
.P
|
|
\fB\-\-background\-colour\fR \fI0xRRGGBB[AA]\fR
|
|
.RS
|
|
Set the background fill colour using a hexadecimal colour code prefixed by '0x'.
|
|
Alpha value is optional.
|
|
.RE
|
|
.
|
|
.P
|
|
\fB\-\-outline\-colour\fR \fI0xRRGGBB[AA]\fR
|
|
.RS
|
|
Set the outline colour using a hexadecimal colour code prefixed by '0x'.
|
|
Alpha value is optional.
|
|
.RE
|
|
.
|
|
.P
|
|
\fB\-\-type\fR \fBplain\fR|\fBstriped\fR|\fBrandom\fR
|
|
.RS
|
|
This option lets you set the fur of neko. You can choose by a plain single color or stripes. Default is plain.
|
|
.RE
|
|
.
|
|
.P
|
|
\fB\-\-wall\fR \fBnone\fR|\fBleft\fR|\fBright\fR|\fBboth\fR
|
|
.RS
|
|
Set which walls neko is allowed to scratch. By default, neko will any wall if she feels like it.
|
|
.RE
|
|
.
|
|
.P
|
|
\fB\-\-idle-sleep\fR \fIseconds\fR
|
|
.RS
|
|
Set the time in seconds after which neko will go to sleep when the user is
|
|
idle.
|
|
.RE
|
|
.
|
|
.P
|
|
\fB\-\-awake-phase\fR \fIseconds-seconds\fR
|
|
.RS
|
|
Set the duration of how long neko will be awake at a time. Takes a minimum
|
|
and a maximum amount of seconds, separated by a dash. Actual duration will
|
|
be drawn uniformly at random between the two values. Defaults to 120-600.
|
|
.RE
|
|
.
|
|
.P
|
|
\fB\-\-sleep-phase\fR \fIseconds-seconds\fR
|
|
.RS
|
|
Set the duration of how long neko will sleep at a time. Takes a minimum
|
|
and a maximum amount of seconds, separated by a dash. Actual duration will
|
|
be drawn uniformly at random between the two values. Defaults to 450-1800.
|
|
.RE
|
|
.
|
|
.P
|
|
\fB\-\-currently\fR \fBawake\fR|\fBasleep\fR|\fBrandom\fR
|
|
.RS
|
|
Set whether neko is currenly (at startup) awake or asleep.
|
|
.RE
|
|
.
|
|
.P
|
|
\fB\-\-layer\fR \fBbackground\fR|\fBbottom\fR|\fBtop\fR|\fBoverlay\fR
|
|
.RS
|
|
Set the layer for the surface.
|
|
Defaults to bottom.
|
|
Bottom is typically beneath regular windows and top above them.
|
|
Overlay is usually displayed even over fullscreen windows.
|
|
Background may conflict with wallpaper clients.
|
|
.RE
|
|
.
|
|
.P
|
|
\fB\-\-output\fR \fIname\fR
|
|
.RS
|
|
Sets the output where neko will live. Expects an output name (e.g. `eDP-1`)
|
|
and will fall back to the currently selected output if the monitor does not
|
|
exist. Defaults to the currently selected monitor.
|
|
.RE
|
|
.
|
|
.P
|
|
\fB\-\-position\fR \fIfloat\fR|\fBrandom\fR
|
|
.RS
|
|
Set the position neko is at on startup. Expects a float between 0 and 1, where
|
|
0 is the leftmost position and 1 is to the rightmost one. Defaults to the
|
|
center, i.e. 0.5.
|
|
.RE
|
|
.
|
|
.P
|
|
\fB\-\-survive\-close\fR
|
|
.RS
|
|
If this flag is used, wayneko will recreate the surface after it has been closed.
|
|
This allows neko to migrate outputs should the one she is currently on be
|
|
disconnected, but may cause some undesired behaviour should the server try to
|
|
close the surface for a different reason.
|
|
.RE
|
|
.
|
|
.
|
|
.SH SIGNALS
|
|
.P
|
|
\fBSIGUSR1\fR
|
|
.RS
|
|
You can send `wayneko` this signal to wake Neko up spontaneously. Neko won't notice
|
|
anything it she is already awake. Example usage: `pkill -10 wayneko`
|
|
.RE
|
|
.
|
|
.
|
|
.SH AUTHOR
|
|
.P
|
|
Original code by
|
|
.MT leonhenrik.plickat@stud.uni-goettingen.de
|
|
Leon Henrik Plickat
|
|
.ME .
|
|
.P
|
|
Fork with phases made by
|
|
.MT virtinstance@gmail.com
|
|
Virt
|
|
.ME .
|
|
.
|
|
.P
|
|
Neko bitmaps taken from public domain.
|