Skip to content

gko/listbox

master
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 

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.

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?

⭐ this repo

License

MIT

Copyright (c) 2012-2016 Konstantin Gorodinskiy