πmenu

<p align="center"> <img src="https://user-images.githubusercontent.com/63266536/159123820-7f1a5c97-87bd-4be2-a4a5-870cb695a3ba.png", title="demo"/> </p>

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.