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

FreeBSD Manual Pages

  
 
  

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

NAME
       pmenu - pie menu	utility	for X

SYNOPSIS
       pmenu

DESCRIPTION
       pmenu  is  a pie	menu for X, it reads a list of newline-separated items
       from stdin, shows a pie menu for	the user to select one of  the	items,
       and  outputs  the  item	selected to stdout.  The pie menu contains one
       slice for each item.

       Each item read from stdin has the following format:

	      ITEM := [TABS] (IMAGE|LABEL) [TABS OUTPUT] NEWLINE

       That means that each item is composed by	tabs, followed by an  optional
       image  specificationor  a  label, followed by more tabs,	followed by an
       output, and ended by a newline.	Brackets group optional	elements; ver-
       tical line (|) separates	elements that cannot be	used together.

	      The  initial  tabs  indicate  the	menu hierarchy:	items indented
	      with a tab is shown in a submenu of the preceding	item  not  in-
	      dented.  An item without initial tabs is a top-level item.

	      The  image is a string of	the form "IMG:/path/to/image.png".  It
	      specifies	a image	to be shown as icon in the slice.

	      The label	is the string that will	be shown  as  a	 item  in  the
	      menu.

	      The output is the	string that will be output after selecting the
	      item.  If	an item	does not have an output, its label is used  as
	      its output.

	      The newline terminates the item specification.

USAGE
       pmenu  is  controlled  by  the mouse, but can also be controlled	by the
       keyboard.  Pie slices can be  selected  using  Tab  (with  and  without
       Shift), Enter and Esc.

       Tab    Cycle through the	slices in the clockwise	direction.

       Shift-Tab
	      Cycle through the	items in the anticlockwise direction.

       Enter  Select the highlighted item.

       Esc    Go to the	menu above or exit pmenu.

RESOURCES
       pmenu understands the following X resources.

       pmenu.font
	      The font in which	the labels should be drawn.

       pmenu.background
	      The background color of non-selected slices in the menu.

       pmenu.foreground
	      The color	of the label text of non-selected slices in the	menu.

       pmenu.selbackground
	      The background color of selected slices in the menu.

       pmenu.selforeground
	      The color	of the label text of selected slices in	the menu.

       pmenu.border
	      The color	of the border around the menu.

       pmenu.separator
	      The color	of the separator between slices	in the menu.

       pmenu.borderWidth
	      The size in pixels of the	border around the menu.

       pmenu.separatorWidth
	      The size in pixels of the	slice separator.

       pmenu.diameterWidth
	      The size in pixels of the	pie menu.

EXAMPLES
       The following script illustrates	the use	of pmenu.  The output is redi-
       rected to sh(1),	creating a command to be run by	the shell.

	      #!/bin/sh

	      cat <<EOF	| pmenu	| sh &
	      Applications
		   IMG:./firefox.png   firefox
		   IMG:./chrome.png    chrome
		   IMG:./vivaldi.png   vivaldi
		   IMG:./qute.png      qutebrowser
		   IMG:./otter.png	    otterbrowser
		   IMG:./gimp.png	  gimp
	      xterm		       xterm
	      urxvt		       urxvt
	      st		  st

	      Shutdown		  poweroff
	      Reboot		       reboot
	      EOF

       For example, by selecting "Applications", a new menu will appear.   Se-
       lecting "Web Browser" in	the new	menu opens firefox.

SEE ALSO
       xmenu(1)

								      PMENU(1)

NAME | SYNOPSIS | DESCRIPTION | USAGE | RESOURCES | EXAMPLES | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=pmenu&sektion=1&manpath=FreeBSD+13.0-RELEASE+and+Ports>

home | help