whiptail

Display text-based dialog boxes from shell scripts.

• Display a simple message:

whiptail --title "{title}" --msgbox "{message}" {height_in_chars} {width_in_chars}

• Display a boolean choice, returning the result through the exit code:

whiptail --title "{title}" --yesno "{message}" {height_in_chars} {width_in_chars}

• Customise the text on the yes / no buttons:

whiptail --title "{title}" --yes-button "{text}" --no-button "{text}" --yesno "{message}" {height_in_chars} {width_in_chars}

• Display a text input box:

{result_variable_name}="$(whiptail --title "{title}" --inputbox "{message}" {height_in_chars} {width_in_chars} {default_text} 3>&1 1>&2 2>&3)"

• Display a password input box:

{result_variable_name}="$(whiptail --title "{title}" --passwordbox "{message}" {height_in_chars} {width_in_chars} 3>&1 1>&2 2>&3)"

• Display a multiple-choice menu:

{result_variable_name}=$(whiptail --title "{title}" --menu "{message}" {height_in_chars} {width_in_chars} {menu_display_height} "{value_1}" "{display_text_1}" "{value_n}" "{display_text_n}" ..... 3>&1 1>&2 2>&3)

Copyright © 2014—present the tldr-pages team and contributors.

This work is licensed under the Creative Commons Attribution 4.0 International License (CC-BY).