💬 listbox element for bash
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
LICENSE
README.md
demo.gif
listbox.sh

README.md

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 antigen

In your .zshrc

antigen bundle gko/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?

⭐️ this repo

License

MIT

Copyright (c) 2012-2016 Konstantin Gorodinskiy