.\" Generated by scdoc 1.11.3
.\" Complete documentation for this program is not available as a GNU info page
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.nh
.ad l
.\" Begin generated content:
.TH "WMENU" "1" "2025-05-01"
.PP
.SH NAME
.PP
wmenu - dynamic menu for Wayland
.PP
.SH SYNOPSIS
.PP
\fBwmenu\fR [-biPv] 
  [-f \fIfont\fR] 
  [-l \fIlines\fR] 
  [-o \fIoutput\fR] 
  [-p \fIprompt\fR] 
  [-N \fIcolor\fR] [-n \fIcolor\fR] 
  [-M \fIcolor\fR] [-m \fIcolor\fR] 
  [-S \fIcolor\fR] [-s \fIcolor\fR]
.PP
\fBwmenu-run\fR .\&.\&.\&
.PP
.SH DESCRIPTION
.PP
\fBwmenu\fR is a dynamic menu for Wayland, which reads a list of newline-separated
items from stdin.\& When the user selects an item and presses Return, their choice
is printed to stdout and wmenu terminates.\& Entering text will narrow the items
to those matching the tokens in the input.\&
.PP
\fBwmenu-run\fR is a special invocation of wmenu which lists programs in the user'\&s
$PATH and runs the result.\&
.PP
.SH OPTIONS
.PP
\fB-b\fR
.RS 4
wmenu appears at the bottom of the screen.\&
.PP
.RE
\fB-i\fR
.RS 4
wmenu matches menu items case insensitively.\&
.PP
.RE
\fB-P\fR
.RS 4
wmenu will not directly display the keyboard input, but instead replace it
with asterisks.\&
.PP
.RE
\fB-v\fR
.RS 4
prints version information to stdout, then exits.\&
.PP
.RE
\fB-f\fR \fIfont\fR
.RS 4
defines the font used.\& For more information, see
https://docs.\&gtk.\&org/Pango/type_func.\&FontDescription.\&from_string.\&html
.PP
.RE
\fB-l\fR \fIlines\fR
.RS 4
wmenu lists items vertically, with the given number of lines.\&
.PP
.RE
\fB-o\fR \fIoutput\fR
.RS 4
wmenu is displayed on the output with the given name.\&
.PP
.RE
\fB-p\fR \fIprompt\fR
.RS 4
defines the prompt to be displayed to the left of the input field.\&
.PP
.RE
\fB-N\fR \fIRRGGBB[AA]\fR
.RS 4
defines the normal background color.\&
.PP
.RE
\fB-n\fR \fIRRGGBB[AA]\fR
.RS 4
defines the normal foreground color.\&
.PP
.RE
\fB-M\fR \fIRRGGBB[AA]\fR
.RS 4
defines the prompt background color.\&
.PP
.RE
\fB-m\fR \fIRRGGBB[AA]\fR
.RS 4
defines the prompt foreground color.\&
.PP
.RE
\fB-S\fR \fIRRGGBB[AA]\fR
.RS 4
defines the selection background color.\&
.PP
.RE
\fB-s\fR \fIRRGGBB[AA]\fR
.RS 4
defines the selection foreground color.\&
.PP
.RE
.SH USAGE
.PP
wmenu is completely controlled by the keyboard.\& Items are selected using the
arrow keys, page up, page down, home, and end.\&
.PP
\fBTab\fR
.RS 4
Copy the selected item to the input field.\&
.PP
.RE
\fBReturn\fR
.RS 4
Confirm selection.\& Prints the selected item to stdout and exits, returning
success.\&
.PP
.RE
\fBCtrl-Return\fR
.RS 4
Confirm selection.\& Prints the selected item to stdout and continues.\&
.PP
.RE
\fBShift-Return\fR
.RS 4
Confirm input.\& Prints the input text to stdout and exits, returning success.\&
.PP
.RE
\fBEscape\fR
.RS 4
Exit without selecting an item, returning failure.\&
.PP
.RE
\fBCtrl-Left\fR
.RS 4
Move cursor to the start of the current word.\&
.PP
.RE
\fBCtrl-Right\fR
.RS 4
Move cursor to the end of the current word.\&
.PP
.RE
.TS
l lx.
T{
\fBC-a\fR
T}	T{
Home
T}
.TE
.sp 1
.TS
l lx.
T{
\fBC-b\fR
T}	T{
Left
T}
.TE
.sp 1
.TS
l lx.
T{
\fBC-c\fR
T}	T{
Escape
T}
.TE
.sp 1
.TS
l lx.
T{
\fBC-d\fR
T}	T{
Delete
T}
.TE
.sp 1
.TS
l lx.
T{
\fBC-e\fR
T}	T{
End
T}
.TE
.sp 1
.TS
l lx.
T{
\fBC-f\fR
T}	T{
Right
T}
.TE
.sp 1
.TS
l lx.
T{
\fBC-g\fR
T}	T{
Escape
T}
.TE
.sp 1
.TS
l lx.
T{
\fBC-[\fR
T}	T{
Escape
T}
.TE
.sp 1
.TS
l lx.
T{
\fBC-h\fR
T}	T{
Backspace
T}
.TE
.sp 1
.TS
l lx.
T{
\fBC-i\fR
T}	T{
Tab
T}
.TE
.sp 1
.TS
l lx.
T{
\fBC-j\fR
T}	T{
Return
T}
.TE
.sp 1
.TS
l lx.
T{
\fBC-J\fR
T}	T{
Shift-Return
T}
.TE
.sp 1
.TS
l lx.
T{
\fBC-k\fR
T}	T{
Delete line right
T}
.TE
.sp 1
.TS
l lx.
T{
\fBC-m\fR
T}	T{
Return
T}
.TE
.sp 1
.TS
l lx.
T{
\fBC-M\fR
T}	T{
Shift-Return
T}
.TE
.sp 1
.TS
l lx.
T{
\fBC-n\fR
T}	T{
Down
T}
.TE
.sp 1
.TS
l lx.
T{
\fBC-p\fR
T}	T{
Up
T}
.TE
.sp 1
.TS
l lx.
T{
\fBC-u\fR
T}	T{
Delete line left
T}
.TE
.sp 1
.TS
l lx.
T{
\fBC-w\fR
T}	T{
Delete word left
T}
.TE
.sp 1
.TS
l lx.
T{
\fBC-Y\fR
T}	T{
Paste from Wayland clipboard
T}
.TE
.sp 1
.TS
l lx.
T{
\fBM-b\fR
T}	T{
Move cursor to the start of the current word
T}
.TE
.sp 1
.TS
l lx.
T{
\fBM-f\fR
T}	T{
Move cursor to the end of the current word
T}
.TE
.sp 1
.TS
l lx.
T{
\fBM-g\fR
T}	T{
Home
T}
.TE
.sp 1
.TS
l lx.
T{
\fBM-G\fR
T}	T{
End
T}
.TE
.sp 1
.TS
l lx.
T{
\fBM-h\fR
T}	T{
Up
T}
.TE
.sp 1
.TS
l lx.
T{
\fBM-j\fR
T}	T{
Page down
T}
.TE
.sp 1
.TS
l lx.
T{
\fBM-k\fR
T}	T{
Page up
T}
.TE
.sp 1
.TS
l lx.
T{
\fBM-l\fR
T}	T{
Down
T}
.TE
.sp 1