zenity(1) User Commands zenity(1)
NAME
zenity, gdialog - display simple GNOME dialogs
SYNOPSIS
zenity --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=seconds]
[--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] [--percent-
age=number] [--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-partial] [--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 Zenity 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 supported:
--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 multi-
ple 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 multi-
ple 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 'visible' separated by a
colon. For example, "message: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.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
+-----------------------------+-----------------------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+-----------------------------+-----------------------------+
|Availability |SUNWgnome-dialog |
+-----------------------------+-----------------------------+
|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)