Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
DMENU2(1)		    General Commands Manual		     DMENU2(1)

NAME
       dmenu2 -	dynamic	menu 2

SYNOPSIS
       dmenu2  [-b]  [-f]  [-r]	 [-i] [-z] [-t]	[-mask]	[-noinput] [-s screen]
       [-name name] [-class class] [-o opacity]	[-dim opacity] [-dc color] [-l
       lines] [-h height] [-uh height] [-w width] [-p prompt] [-fn font]  [-nb
       color]  [-nf  color]  [-sb color] [-sf color] color] [-hist <filename>]
       [-v]

       dmenu2_run ...

DESCRIPTION
       dmenu2 is a dynamic menu	for X, which reads a list of newline-separated
       items from stdin.  When the user	selects	an item	 and  presses  Return,
       their choice is printed to stdout and dmenu2 terminates.	 Entering text
       will narrow the items to	those matching the tokens in the input.

       dmenu2_run  is  a  script  used	by  dwm(1) which lists programs	in the
       user's $PATH and	runs the result	in their $SHELL.

OPTIONS
       -b     dmenu2 appears at	the bottom of the screen.

       -q     dmenu2 will not show any items if	the search string is empty.

       -f     dmenu2 grabs the keyboard	before reading stdin.  This is faster,
	      but will lock up X until stdin reaches end-of-file.

       -r     activates	filter mode. All matching items	currently shown	in the
	      list will	be selected, starting with  the	 item  that  is	 high-
	      lighted and wrapping around to the beginning of the list.

       -i     dmenu2 matches menu items	case insensitively.

       -z     dmenu2 uses fuzzy	matching. It matches items that	have all char-
	      acters  entered,	in sequence they are entered, but there	may be
	      any number of characters between matched characters.  For	 exam-
	      ple  it takes "txt" makes	it to "*t*x*t" glob pattern and	checks
	      if it matches.

       -t     dmenu2 uses space-separated tokens to match  menu	 items.	 Using
	      this overrides -z	option.

       -mask  dmenu2 masks input with asterisk characters (*).

       -noinput
	      dmenu2 ignores input from	stdin (equivalent to: echo | dmenu2).

       -s screen
	      dmenu2 apears on the specified screen number. Number given core-
	      spondes to screen	number in X configuration.

       -name name
	      defines window name for dmenu2. Defaults to "dmenu2".

       -class class
	      defines window class for dmenu2. Defaults	to "Dmenu2".

       -o opacity
	      defines window opacity for dmenu2. Defaults to 1.0.

       -dim opacity
	      enables  screen dimming when dmenu2 appers. Takes	dim opacity as
	      argument.

       -dc color
	      defines color of screen dimming. Active only when	 -dim  in  ef-
	      fect. Defautls to	black (#000000)

       -l lines
	      dmenu2 lists items vertically, with the given number of lines.

       -h height
	      defines the height of the	bar in pixels.

       -uh height
	      defines the height of the	underline in pixels.

       -p prompt
	      defines  the  prompt  to	be  displayed to the left of the input
	      field.

       -fn font
	      defines the font	or  font  set  used.  eg.  "fixed"  or	"Mono-
	      space-12:normal" (an xft font)

       -x xoffset
	      defines the offset from the left border of the screen.

       -y yoffset
	      defines the offset from the top border of	the screen.

       -w width
	      defines the desired menu window width.

       -nb color
	      defines the normal background color.  #RGB, #RRGGBB, and X color
	      names are	supported.

       -nf color
	      defines the normal foreground color.

       -sb color
	      defines the selected background color.

       -sf color
	      defines the selected foreground color.

       -uc color
	      defines the underline color.

       -hist <histfile>
	      the file to use for history

       -v     prints version information to stdout, then exits.

USAGE
       dmenu2  is  completely  controlled by the keyboard.  Items are selected
       using the arrow keys, page up, page down, home, and end.

       Tab    Copy the selected	item to	the input field.

       Return Confirm selection.  Prints the selected item to stdout  and  ex-
	      its, returning success.

       Shift-Return
	      Confirm  input.	Prints the input text to stdout	and exits, re-
	      turning success.

       Escape Exit without selecting an	item, returning	failure.

       C-a    Home

       C-b    Left

       C-c    Escape

       C-d    Delete

       C-e    End

       C-f    Right

       C-g    Escape

       C-h    Backspace

       C-i    Tab

       C-j    Return

       C-J    Shift-Return

       C-k    Delete line right

       C-m    Return

       C-n    Down

       C-p    Up

       C-u    Delete line left

       C-w    Delete word left

       C-y    Paste from primary X selection

       C-Y    Paste from X clipboard

       M-g    Home

       M-G    End

       M-h    Up

       M-j    Page down

       M-k    Page up

       M-l    Down

SEE ALSO
       dwm(1), stest2(1)

				  dmenu2-0.2			     DMENU2(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=dmenu2&sektion=1&manpath=FreeBSD+Ports+15.0>

home | help