2019-03-07 09:50:16 +00:00
|
|
|
# whiptail
|
|
|
|
|
|
|
|
|
|
> Display text-based dialog boxes from shell scripts.
|
2021-10-05 04:35:50 +01:00
|
|
|
> More information: <https://manned.org/whiptail>.
|
2019-03-07 09:50:16 +00:00
|
|
|
|
|
|
|
|
- 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}}`
|
|
|
|
|
|
2023-06-13 18:14:43 +01:00
|
|
|
- Customise the text on the yes/no buttons:
|
2019-03-07 09:50:16 +00:00
|
|
|
|
|
|
|
|
`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)`
|
