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