zenity(1) User Commands zenity(1)NAME
zenity, gdialog - display simple GNOME dialogs
SYNOPSISzenity--calendar [--title=title] [--window-icon=path] [--width=width]
[--height=height] [--timeout=seconds] [--text=text] [--day=number]
[--month=number] [--year=number] [--date-format=format]
zenity--entry [--title=title] [--window-icon=path] [--width=width]
[--height=height] [--timeout=seconds] [--text=text] [--entry-text=text]
[--hide-text]
zenity--error | --info | --question | --warning [--title=title]
[--window-icon=path] [--width=width] [--height=height] [--timeout=sec‐
onds] [--text=text] [--nowrap]
zenity--file-selection [--title=title] [--window-icon=path]
[--width=width] [--height=height] [--timeout=seconds] [--filename=path]
[--multiple] [--directory] [--save] [--separator=character] [--confirm-
overwrite]
zenity--list [--title=title] [--window-icon=path] [--width=width]
[--height=height] [--timeout=seconds] --column=text [--checklist]
[--radiolist] [--separator=character] [--multiple] [--editable]
[--print-column=number] [--hide-column=number]
zenity--notification [--window-icon=path] [--timeout=seconds]
[--text=text] [--listen]
zenity--progress [--title=title] [--window-icon=path] [--width=width]
[--height=height] [--timeout=seconds] [--text=text] [--percentage=num‐
ber] [--pulsate] [--auto-close] [--auto-kill]
zenity--scale [--title=title] [--window-icon=path] [--width=width]
[--height=height] [--timeout=seconds] [--text=text] [--value=number]
[--min-value=number] [--max-value=number] [--step=number] [--print-par‐
tial] [--hide-value]
zenity--text-info [--title=title] [--window-icon=path] [--width=width]
[--height=height] [--timeout=seconds] [--filename=path] [--editable]
zenity--about | - -help | --usage | --version | - GTK+_options
DESCRIPTION
The zenity application displays simple GNOME dialogs. You can use Zen‐
ity to create scripts that interact graphically with the user. gdia‐
log(1) has been deprecated and is now a wrapper script around Zenity,
and will preserve compatibility with older scripts.
OPTIONS
Zenity supports several different types of options.
Zenity Miscellaneous Options
The following miscellaneous options are supported:
--about Display the About Zenity dialog, which provides
information about the Zenity application,
including the version number and the author.
--version Display the version number of Zenity.
Help Options
The following help options are supported:
-?, --help Display help text.
--help-* Display help text on specific dialogs.
GTK+ Options
Zenity supports the standard GTK+ options. For more information about
the GTK+ options, execute the zenity--help-gtk- command.
Dialog Options
The following dialog options are supported:
--calendar Display a calendar dialog.
--entry Display a text entry dialog.
--error Display an error dialog.
--file-selection Display a file-selection dialog.
--info Display an informational dialog.
--list Display a list dialog.
--notification Display a notification icon.
--progress Display a progress indication dialog.
--question Display a question dialog.
--scale Display a scale dialog.
--text-info Display a text information dialog.
--warning Display a warning dialog.
General Dialog Options
The following general dialog options are supported:
--title=title Set the dialog title.
--window-icon=path Set the dialog window icon with a full path to
an image.
--width=width Set the dialog width.
--height=height Set the dialog height.
--timeout=seconds Set the dialog timeout in seconds.
Calendar Dialog Options
The following calendar dialog options are supported:
--text=text Set the dialog text.
--day=number Set the calendar day.
--month=number Set the calendar month.
--year=number Set the calendar year.
--date-format=format Set the date format to return at the command
line. The default format depends on your
locale. The format must be of strftime style,
for example %A %d/%m/%y.
Text-Entry Dialog Options
The following text-entry dialog options are supported:
--text=text Set the dialog text.
--entry-text=text Set the dialog entry text.
--hide-text Use asterisks to hide the entry text.
Error, Info, Question and Warning Dialog Options
The following error, info, question and warning dialog options are sup‐
ported:
--text=text Set the dialog text.
--nowrap Do not enable text wrapping in the dialog.
File-Selection Dialog Options
The following file-selection dialog options are supported:
--filename=path Set the file or directory to select by default.
--multiple Allow multiple selections.
--directory Activate directory-only selection.
--save Activate save mode file selection.
--separator=character Set the separator character to return at the
command line. This option is used only when
the dialog allows multiple selections.
--confirm-overwrite Confirm overwrite of files.
List Dialog Options
The following list dialog options are supported:
--text=text Set the dialog text.
--column=text Set the text of a column.
--checklist Specify that the first column contains check
boxes.
--radiolist Specify that the first column contains radio
buttons.
--separator=character Set the separator character to return at the
command line. This option is used only when
the dialog allows multiple selections.
--editable Specify that the dialog contents are editable.
--print-column=number Specify which column to print on return.
--hide-column=number Specify which columns should be hidden from
view.
Notification Options
The following notification dialog options are supported:
--text=text Set the dialog text.
--listen Listen for commands on standard input. Commands
include 'message', 'tooltip', 'icon', and 'vis‐
ible' separated by a colon. For example, "mes‐
sage:Hello world", "icon:/path/to/icon", or
"visible:false".
Progress-Indication Dialog Options
The following progress-indication dialog options are supported:
--text=text Set the dialog text.
--percentage=number Set the initial percentage of the progress bar.
--pulsate Specify that the progress bar pulsates until an
EOF character is read from the command line.
--auto-close Close the dialog automatically when 100% has
been reached.
--auto-kill Kill the parent process if cancel button is
pressed.
Scale Dialog Options
The following scale dialog options are supported:
--text=text Set the dialog text.
--value=number Set the initial value.
--min-value=number Set the minimum value of the scale.
--max-value=number Set the maximum value of the scale.
--step=number Set the step size of the scale.
--print-partial Set the values of the scale as they are
selected.
--hide-value Set the value of the scale from view.
Text-Informational Dialog Options
The following text-informational dialog options are supported:
--filename=path Set the file to display in the dialog.
--editable Specify that the dialog contents are editable.
EXAMPLES
Example 1: Launching Zenity Using the List Dialog
example% zenity--list --title="Choose bugs you wish to view" \
--text="Select items from the list below." \
--column="Bug Number" --column="Severity" --column="Description" \
992383 Normal "GtkTreeView crashes on multiple selections" \
293823 High "GNOME Dictionary does not handle proxy" \
393823 Critical "Menu editing does not work in GNOME 2.0"
Example 2: Launching Zenity Using the Progress Dialog
example% find . -name '*.bk' | zenity--progress \
--title="Finding backups" --pulsate
Example 3: Launching Zenity Using the Text Informational Dialog
example% zenity--text-info --title="OpenSolaris License" \
--filename="/usr/src/OPENSOLARIS.LICENSE"
ENVIRONMENT VARIABLES
The following environment variables affect the execution of zenity:
ZENITY_OK, DIALOG_OK Set the return value for OK.
ZENITY_CANCEL, DIALOG_CANCEL Set the return value for Cancel.
ZENITY_ERROR, DIALOG_ERROR Set the return value for Error.
ZENITY_ESC, DIALOG_ESC Set the return value for Escape.
EXIT STATUS
The following exit values are returned:
-1 Error
0 OK
1 Cancel, Escape
FILES
The following files are used by this application:
/usr/bin/zenity Executable for Zenity.
/usr/bin/gdialog Symbolic link to run zenity.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
┌─────────────────────────────┬─────────────────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├─────────────────────────────┼─────────────────────────────┤
│Availability │gnome/zenity │
├─────────────────────────────┼─────────────────────────────┤
│Interface stability │Volitile │
└─────────────────────────────┴─────────────────────────────┘
SEE ALSO
Zenity Manual
Latest version of the GNOME Desktop User Guide for your platform.
attributes(5), environ(5), gnome-std-options(5)NOTES
Written by Glynn Foster, Sun Microsystems Inc., 2003, 2004, 2006, 2007.
SunOS 5.11 15 Nov 2007 zenity(1)