Home

Awesome

Listbox

šŸ’¬ listbox element for bash

demo

Simple bash listbox to choose from options

Installation

Manually

git clone https://github.com/gko/listbox

then in .bashrc or .zshrc:

source ./listbox/listbox.sh

With Fig

Fig adds apps, shortcuts, and autocomplete to your existing terminal.

Install listbox in just one click.

<a href="https://fig.io/plugins/other/listbox_gko" target="_blank"><img src="https://fig.io/badges/install-with-fig.svg" /></a>

With antigen

In your .zshrc

antigen bundle gko/listbox

With oh-my-zsh

git clone https://github.com/gko/listbox.git ~/.oh-my-zsh/custom/plugins/listbox

then in your .zshrc

plugins=(
  ...
  listbox
  ...
)

Usage

Usage: listbox [options]
Example:
  listbox -t title -o "option 1|option 2|option 3" -r resultVariable -a '>'
Options:
  -h, --help                         help
  -t, --title                        list title
  -o, --options "option 1|option 2"  listbox options
  -r, --result <var>                 result variable
  -a, --arrow <symbol>               selected option symbol

General usage

source ./listbox.sh
listbox -t Title -o "option 1|option 2|option 3" -r result
echo "user chose: $result"

output:

  Title
  -----
  option 1
> option 2
  option 3
  
user chose: option 2

Specify arrow symbol

listbox -t Title -o "option 1|option 2|option 3" -a 'ā†’'

output:

  Title
  ---
ā†’ option 1
  option 2
  option 3
  
option 1

Pipe directly to variable

result=$(listbox -t Title -o "option 1|option 2|option 3" | tee /dev/tty | tail -n 1)
echo "user chose: $result"

output:

  Title
  ---
  option 1
> option 2
  option 3
  
user chose: option 2

Like it?

:star: this repo

License

MIT

Copyright (c) 2012-2016 Konstantin Gorodinskiy