dmenu.1 (view raw)
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 |
.TH DMENU 1 dmenu\-VERSION .SH NAME dmenu \- dynamic menu .SH SYNOPSIS .B dmenu .RB [ \-b ] .RB [ \-f ] .RB [ \-i ] .RB [ \-l .IR lines ] .RB [ \-p .IR prompt ] .RB [ \-fn .IR font ] .RB [ \-nb .IR color ] .RB [ \-nf .IR color ] .RB [ \-sb .IR color ] .RB [ \-sf .IR color ] .RB [ \-v ] .P .BR dmenu_run " ..." .SH DESCRIPTION .B dmenu is a dynamic menu for X, originally designed for .IR dwm (1). It manages huge numbers of user\-defined menu items efficiently. .P dmenu reads a list of newline\-separated items from stdin and creates a menu. When the user selects an item or enters any text and presses Return, their choice is printed to stdout and dmenu terminates. .P .B dmenu_run is a dmenu script used by dwm which lists programs in the user's $PATH and executes the selected item. .SH OPTIONS .TP .B \-b dmenu appears at the bottom of the screen. .TP .B \-f dmenu grabs the keyboard before reading stdin. This is faster, but may lock up X if stdin is from a terminal. .TP .B \-i dmenu matches menu items case insensitively. .TP .BI \-l " lines" dmenu lists items vertically, with the given number of lines. .TP .BI \-p " prompt" defines the prompt to be displayed to the left of the input field. .TP .BI \-fn " font" defines the font or font set used. .TP .BI \-nb " color" defines the normal background color. .IR #RGB , .IR #RRGGBB , and X color names are supported. .TP .BI \-nf " color" defines the normal foreground color. .TP .BI \-sb " color" defines the selected background color. .TP .BI \-sf " color" defines the selected foreground color. .TP .B \-v prints version information to stdout, then exits. .SH USAGE dmenu is completely controlled by the keyboard. Besides standard Unix line editing and item selection (arrow keys, page up/down, home and end), the following keys are recognized: .TP .B Tab (Ctrl\-i) Copy the selected item to the input field. .TP .B Return (Ctrl\-j) Confirm selection. Prints the selected item to stdout and exits, returning success. .TP .B Shift\-Return (Ctrl\-Shift\-j) Confirm input. Prints the input text to stdout and exits, returning success. .TP .B Escape (Ctrl\-c) Exit without selecting an item, returning failure. .TP .B Ctrl\-y Paste the current X selection into the input field. .SH SEE ALSO .IR dwm (1), .IR lsx (1) |