summaryrefslogtreecommitdiff
path: root/dmenu.1
blob: db919db65b68ce0f4ebd5dfa8ba71483319f51bb (plain)
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
.TH DMENU 1 dmenu-VERSION
.SH NAME
dmenu \- dynamic menu
.SH SYNOPSIS
.B dmenu
.RB [ \-v ]
.SH DESCRIPTION
.SS Overview
.B dmenu
is a generic, highly customizable, and efficient menu for the X Window System,
originally designed for
.BR dwm (1).
It supports arbitrary, user defined menu contents.
.SS Options
.TP
.B \-v
prints version information to stdout, then exits.
.SH USAGE
.B 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, his choice
is printed to stdout and
.B dmenu
terminates.
.B dmenu
is completely controlled by the keyboard.  The following keys are recognized:
.TP
Any printable character
Appends the character to the text in the input field. This works as a filter:
only items containing this text will be displayed.
.TP
Left/Right
Select the previous/next item.
.TP
Tab
Copy the selected item to the input field.
.TP
Return
Confirm selection and quit (print the selected item to stdout).
.TP
Shift-Return
Confirm selection and quit (print the text in the input field to stdout).
.TP
Escape (Control-[)
Quit without selecting an item.
.TP
Backspace (Control-h)
Remove enough characters from the input field to change its filtering effect.
.TP
Control-u
Remove all characters from the input field.
.P
.B dmenu
returns
.B 0
if Return is pressed on termination,
.B 1
if Escape is pressed.
.SH CUSTOMIZATION
.B dmenu
is customized by creating a custom config.h and (re)compiling the source
code. This keeps it fast, secure and simple.
.SH SEE ALSO
.BR dwm (1)