Timer and Progress Bar

Dialog can be initiated with a timer that will close when the number of seconds has expired

--timer (<seconds>)

Replaces default button with a timer countdown after which dialog will close with exit code 4, Default timer value is 10 seconds. Optional value <seconds> can be specified to the desired value. If <seconds> is > 60 the countdown will be rendered in HH:MM:SS format, e.g. 280 seconds will display 4:40 for the initial countdown.

If used in conjuction with --button1text the default button will be displayed but will be disabled for the first 3 seconds of the timer, after which it becomes active and can be used to dismiss dialog with the standard button 1 exit code of 0

--hidetimerbar will hide the progress bar and countdown display.

Doing so forces default button to be visible to prevent un-dismissable dialogs with no indication of when the timer expires.

---

Progress Bar

Dialog can display an interactive progress bar that can be updated dynamically via the command file.

--progress [<int>]

Makes a progress bar visible with the specified number of steps. If no value is given, the default is 10 steps.

To advance the progress bar, send a command to the dialog command file:

echo "progress: <int>" >> /var/tmp/dialog.log

--progresstext <text>

Sets the initial text displayed underneath the progress bar. The text can be updated at any time:

echo "progresstext: Installing software..." >> /var/tmp/dialog.log

Progress text alignment

--progresstextalignment [left | right]

Sets the horizontal alignment of the progress text displayed underneath the progress bar. Default is centred.