NAME

slmenu - single line menu

SYNOPSIS

slmenu [-b] [-t] [-i] [-l lines] [-p prompt] [-v]

DESCRIPTION

slmenu is a dynamic menu for the console, based on the wonderful dmenu(1). It also manages huge numbers of user-defined menu items efficiently.

slmenu reads a list of newline-separated items from stdin and creates a menu. Then it re-opens the tty and prompts for user input. When the user selects an item or enters any text and presses Return, their choice is printed to stdout and slmenu terminates. The user interface is drawn in stderr, so it does not interfere with the result.

OPTIONS

-b or -t

slmenu appears at the bottom (-b) or top (-t) of the terminal. By default, slmenu appears in the current line.

-i

slmenu matches menu items case insensitively.

-l lines

puts slmenu in multiline mode and chooses the number of lines to display

-p prompt

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

-v

prints version information to stdout, then exits.

USAGE

slmenu is completely controlled by the keyboard. Besides standard Unix line editing and item selection (arrow keys, page up/down, home and end), the following keys are recognized:

Tab (Ctrl-i)

Copy the selected item to the input field.

Return (Ctrl-j or Ctrl-m)

Confirm selection. Prints the selected item to stdout and exits, returning success.

Ctrl-] or Ctrl-

Confirm input. Prints the input text to stdout and exits, returning success.

Escape-Escape (Ctrl-c)

Exit without selecting an item, returning failure.

Ctrl-y

Paste the current X selection into the input field.

SEE ALSO

dmenu(1), sandy(1),