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