Shell interactive menu (bash/zsh/ksh compatible)
usage: selector [-p <prompt>] -i <items>|-f <itemfile> [-P <y|n>]
args :
-p, --prompt menu prompt
-i, --items menu items \n separated
-f, --file file with items
-F, --filter regexp pattern filter items
-P, --powerline y or n, powerline symbol usage
-a, --autofilter y or n, filter at keystrokes
-k, --keyfunc Custom additional key function
selector can be used as command line or sourced to be used as function (bash/zsh/ksh compatible)
When sourced, the selected item is available as $selected.
| key | action |
|---|---|
| ⇩ | select next item |
| ⇧ | select prev item |
| End/⇨ | select last item |
| Home/⇦ | select first item |
| Shift+⇩/PgUp/Ctl+F | next page |
| Shift+⇧/PgDn/Ctl+B | previous page |
| Del/F8 | delete item in menu |
| Esc | exit |
| Ctrl+A | use all screen to display menu |
| Tab | apply/new filter |
| Enter | validate item selected |
- filter pattern can be applied entering text
- selection can be done entering item number
demo usage at:
- cdhist : navigate in directories from command line with arrow keys with dir history (bash/zsh/ksh)
- redo : replacement for Ctrl+R and Esc+/ to search in command history (bash/zsh)
- complete-ng : bash command line completion replacement for multiple choices output with interactive menu