About

git repo

91menu is a Plan9-inspired, mouse-oriented, graphical menu, which works with the standard input. It is an attempt at providing a better and more modern version alternative to 9menu. The 91 in 91menu stands for “9.1”.

The following sections are the formated version of the man page.

NAME

91menu - graphical mouse-driven menu

SYNOPSIS

91menu [-clmruv] [-f file] [-bd color] [-bg color] [-fg color] [-g geometry] [-nv color] [-sl color] [-ft font]

OPTIONS

-c: Aligns the items to the center of the window.
-l: Aligns the items to the left side of the window.
-m: Grabs every mouse buttons specified in config.h outside of the menu window.
-r: Aligns the items to the right side of the window.
-u: Displays the 91menu usage message.
-v: Displays the 91menu version.
-f file: Specifies the file where 91menu should read the last selected item and write the selected one.
-bd color: Specifies the border color of the menu.
-bg color: Specifies the background color of the menu.
-fg color: Specifies the foreground color of the menu.
-g geometry: Specifies the menu geometry. The form is [=][<width>{xX}<height>][{+-}<xoffset>{+-}<yoffset>]. See XParseGeometry(3)
-nv color: Specifies the inverted text color of the menu.
-sl color: Specifies the selection color of the menu.

DESCRIPTION

91menu is a graphical menu, meant to be a more versatile alternative to 9menu (to be more than a program launcher). The purpose of 91menu is to take a list of ordenated newline-separated items from the sandard input, and display them verticaly in the same order, into a menu where items are selectable.

An item can be selected by pressing any mouse buttons over it (see config.h for buttons). When an item is selected, it is printed on the standard output, 91menu terminates, and the selected item is written as "last selected item" to a file specified with the -f option (or by default in the file specified in config.h). The next time 91menu will be executed, it will popup with the last selected item under the mouse cursor. The file specified with the -f option (or config.h) is used for reading and writing, and the readed item is overwriten by the selected one. If some grabbed mouse buttons are pressed outside of the window, 91menu terminates, and nothing is printed on the standard output.

USAGE

Unlike 9menu, 91menu only prints the selected item to standard output (instead of running a given command), this point makes 91menu way more flexible, and particulary usefull combined with a bunch of shell scripts.