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

  
 
  

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

NAME
     dmenu-wl - dynamic menu

SYNOPSIS
     dmenu-wl  [-b]  [-i]  [-l	lines]	[-m monitor] [-p prompt] [-fn font] [-nb
     color] [-nf color] [-sb color] [-sf color] [-v]

     dmenu-wl_run ...

     dmenu-wl_path

DESCRIPTION
     dmenu-wl is a dynamic menu for  Wayland,  originally  designed  for  X  and
     dwm(1).  It manages huge numbers of user-defined menu items efficiently.

     dmenu-wl  reads  a  list of newline-separated items from standard input and
     creates a menu (or displays a notification if using -e). When the user  se-
     lects  an	item  or  enters  any  text  and presses Return, their choice is
     printed to standard output and dmenu-wl terminates.

     dmenu-wl_run is a dmenu-wl script used by dwm which lists programs  in  the
     user's PATH and executes the selected item.

     dmenu-wl_path is a program used by dmenu-wl_run to find and cache a list of
     executables.

OPTIONS
     -e dmenu displays text from stdin with no user interaction.

     -ec    same as -e but text is aligned centrally.

     -er    same as -e but text is aligned to the right.

     -et secs
	    when using -e, close the message after the given number of seconds

     -b     dmenu appears at the bottom of the screen.

     -h height
	    dmenu is drawn at least the given number of pixels high.

     -i     dmenu matches menu items case insensitively.

     -l lines
	    dmenu lists items vertically, within the given number of lines.

     -m monitor
	    dmenu appears on the given monitor (0-based index or monitor name)

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

     -po prompt
	    same  as  -p  but don't wait for stdin - useful for a prompt with no
	    selection options.

     -r     Return as soon as a single match is found. i.e. don't wait	for  the
	    user to press return.

     -fn font
	    defines the font or font set used.

     -nb color
	    defines  the normal background color.  #RRGGBBand #RRGGBBAA are sup-
	    ported.

     -nf color
	    defines the normal foreground color.

     -sb color
	    defines the selected background color.

     -sf color
	    defines the selected foreground color.

     -v     prints version information to standard output, then exits.

USAGE
     dmenu-wl is completely controlled by the keyboard.  Besides  standard  Unix
     line  editing  and  item  selection  (Up/Down/Left/Right,	PageUp/PageDown,
     Home/End), the following keys are recognized:

     Tab (Control-i)
	    Copy the selected item to the input field.

     Return (Control-j)
	    Confirm selection.	Prints the selected item to standard output  and
	    exits, returning success.

     Shift-Return (Control-Shift-j)
	    Confirm  input.  Prints the input text to standard output and exits,
	    returning success.

     Escape (Control-c)
	    Exit without selecting an item, returning failure.

     Control-y
	    Paste the current X selection into the input field.

SEE ALSO
     dwm(1)

				dmenu-wl-VERSION			DMENU(1)

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

home | help