Skip to content

phillbush/pmenu

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

πmenu

WARNING: The options -r, -m and -p are deprecated and were replaced by -x and -X. The option -P (used to provide path) is now replaced by the environment variable $ICONPATH, an environment variable which supports several paths delimited by colons. Read the manual for more information. Update your scripts after updating πmenu.

πmenu is a pie menu utility for X. πmenu receives a menu specification in stdin, shows a menu for the user to select one of the options, and outputs the option selected to stdout.

πmenu comes with the following features:

  • πmenu reads something in and prints something out, the UNIX way.
  • Submenus (some pie-menu slices can spawn another menu).
  • Icons (pie-menu slices can contain icon image).
  • X resources support (you don't need to recompile πmenu for configuring it).

Files

The files are:

  • ./README.md: This file.
  • ./Makefile: The makefile.
  • ./config.h: The hardcoded default configuration for πmenu.
  • ./pmenu.1: The manual file (man page) for πmenu.
  • ./pmenu.c: The source code of πmenu.
  • ./pmenu.sh: A sample script illustrating how to use πmenu.
  • ./ctrlfnt.*: Routines for drawing text.

Installation

First, edit ./Makefile or set the proper environment variables to match your local setup.

In order to build πmenu you need the Imlib2, Xlib and Xft header files (and some X extensions: XShape and Xinerama). The default configuration for πmenu is specified in the file config.h, you can edit it, but most configuration can be changed at runtime via X resources. Enter the following command to build πmenu. This command creates the binary file ./pmenu.

make

By default, πmenu is installed into the /usr/local prefix. Enter the following command to install πmenu (if necessary as root). This command installs the binary file ./pmenu into the ${PREFIX}/bin/ directory, and the manual file ./pmenu.1 into ${MANPREFIX}/man1/ directory.

make install

Running πmenu

πmenu receives as input a menu specification where each line is a menu entry. Each line can be indented with tabs to represent nested menus. Each line is made out of a label and a command separated by any number of tabs.

See the script ./pmenu.sh for an example of how to use πmenu to draw a simple pie menu.

Read the manual for more information on running πmenu.