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