Skip to content

joknarf/selector

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

bash

selector

Shell interactive menu (bash/zsh/ksh compatible)

image

usage

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.

demo

selector

keys

key action
select next item
select prev item
End/ select last item
Home/ select first item
Shift/PgUp/CtlF next page
Shift/PgDn/CtlB previous page
Del/F8 delete item in menu
Esc exit
CtrlA 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:

  • seedee : navigate in directories from command line with arrow keys with dir history (bash/zsh/ksh)
  • redo : replacement for CtrlR and Esc/ to search in command history (bash/zsh)
  • complete-ng : bash/zsh command line completion replacement for multiple choices output with interactive menu