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