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 nar-
     row 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 highlighted
	    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  charac-
	    ters  entered,  in	sequence  they are entered, but there may be any
	    number of characters between matched  characters.	For  example  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 corespon-
	    des 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 ar-
	    gument.

     -dc color
	    defines color of screen dimming. Active only when  -dim  in  effect.
	    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 "Monospace-12:nor-
	    mal" (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 exits,
	    returning success.

     Shift-Return
	    Confirm input.  Prints the input text to stdout and exits, returning
	    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.1.quarterly>

home | help