dmenu.1 (3140B)
1.TH DMENU 1 dmenu\-VERSION 2.SH NAME 3dmenu \- dynamic menu 4.SH SYNOPSIS 5.B dmenu 6.RB [ \-bfiv ] 7.RB [ \-l 8.IR lines ] 9.RB [ \-m 10.IR monitor ] 11.RB [ \-p 12.IR prompt ] 13.RB [ \-fn 14.IR font ] 15.RB [ \-nb 16.IR color ] 17.RB [ \-nf 18.IR color ] 19.RB [ \-sb 20.IR color ] 21.RB [ \-sf 22.IR color ] 23.RB [ \-w 24.IR windowid ] 25.P 26.BR dmenu_run " ..." 27.SH DESCRIPTION 28.B dmenu 29is a dynamic menu for X, which reads a list of newline\-separated items from 30stdin. When the user selects an item and presses Return, their choice is printed 31to stdout and dmenu terminates. Entering text will narrow the items to those 32matching the tokens in the input. 33.P 34.B dmenu_run 35is a script used by 36.IR dwm (1) 37which lists programs in the user's $PATH and runs the result in their $SHELL. 38.SH OPTIONS 39.TP 40.B \-b 41dmenu appears at the bottom of the screen. 42.TP 43.B \-f 44dmenu grabs the keyboard before reading stdin if not reading from a tty. This 45is faster, but will lock up X until stdin reaches end\-of\-file. 46.TP 47.B \-i 48dmenu matches menu items case insensitively. 49.TP 50.BI \-l " lines" 51dmenu lists items vertically, with the given number of lines. 52.TP 53.BI \-m " monitor" 54dmenu is displayed on the monitor number supplied. Monitor numbers are starting 55from 0. 56.TP 57.BI \-p " prompt" 58defines the prompt to be displayed to the left of the input field. 59.TP 60.BI \-fn " font" 61defines the font or font set used. 62.TP 63.BI \-nb " color" 64defines the normal background color. 65.IR #RGB , 66.IR #RRGGBB , 67and X color names are supported. 68.TP 69.BI \-nf " color" 70defines the normal foreground color. 71.TP 72.BI \-sb " color" 73defines the selected background color. 74.TP 75.BI \-sf " color" 76defines the selected foreground color. 77.TP 78.B \-v 79prints version information to stdout, then exits. 80.TP 81.BI \-w " windowid" 82embed into windowid. 83.SH USAGE 84dmenu is completely controlled by the keyboard. Items are selected using the 85arrow keys, page up, page down, home, and end. 86.TP 87.B Tab 88Copy the selected item to the input field. 89.TP 90.B Return 91Confirm selection. Prints the selected item to stdout and exits, returning 92success. 93.TP 94.B Ctrl-Return 95Confirm selection. Prints the selected item to stdout and continues. 96.TP 97.B Shift\-Return 98Confirm input. Prints the input text to stdout and exits, returning success. 99.TP 100.B Escape 101Exit without selecting an item, returning failure. 102.TP 103.B Ctrl-Left 104Move cursor to the start of the current word 105.TP 106.B Ctrl-Right 107Move cursor to the end of the current word 108.TP 109.B C\-a 110Home 111.TP 112.B C\-b 113Left 114.TP 115.B C\-c 116Escape 117.TP 118.B C\-d 119Delete 120.TP 121.B C\-e 122End 123.TP 124.B C\-f 125Right 126.TP 127.B C\-g 128Escape 129.TP 130.B C\-h 131Backspace 132.TP 133.B C\-i 134Tab 135.TP 136.B C\-j 137Return 138.TP 139.B C\-J 140Shift-Return 141.TP 142.B C\-k 143Delete line right 144.TP 145.B C\-m 146Return 147.TP 148.B C\-M 149Shift-Return 150.TP 151.B C\-n 152Down 153.TP 154.B C\-p 155Up 156.TP 157.B C\-u 158Delete line left 159.TP 160.B C\-w 161Delete word left 162.TP 163.B C\-y 164Paste from primary X selection 165.TP 166.B C\-Y 167Paste from X clipboard 168.TP 169.B M\-b 170Move cursor to the start of the current word 171.TP 172.B M\-f 173Move cursor to the end of the current word 174.TP 175.B M\-g 176Home 177.TP 178.B M\-G 179End 180.TP 181.B M\-h 182Up 183.TP 184.B M\-j 185Page down 186.TP 187.B M\-k 188Page up 189.TP 190.B M\-l 191Down 192.SH SEE ALSO 193.IR dwm (1), 194.IR stest (1)