zenity(1) User Commands zenity(1)
NAME
zenity, gdialog - display simple GNOME dialogs
SYNOPSIS
zenity --calendar [--height=height] [--title=title] [--width=width] [--window-icon=path] [--date-format=format] [--day=number]
[--month=number] [--text=text] [--year=number]
zenity --entry [--height=height] [--title=title] [--width=width] [--window-icon=path] [--entry-text=text] [--hide-text] [--text=text]
zenity --error | --info | --question | --warning [--height=height] [--title=title] [--width=width] [--window-icon=path] [--text=text]
zenity --file-selection [--height=height] [--title=title] [--width=width] [--window-icon=path] [--filename=path] [--multiple] [--separa-
tor=character]
zenity --list --column=text [--height=height] [--title=title] [--width=width] [--window-icon=path] [--checklist] [--editable] [--radiolist]
[--separator=character]
zenity --progress [--height=height] [--title=title] [--width=width] [--window-icon=path] [--auto-close] [--percentage=number] [--pulsate]
[--text=text]
zenity --text-info [--height=height] [--title=title] [--width=width] [--window-icon=path] [--editable] [--filename=path]
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-Specific Options
The following Zenity-specific 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. You can also use -? to specify this option.
--usage Display brief usage text.
GTK+ Options
Zenity supports the standard GTK+ options. For more information about the GTK+ options, execute the zenity -? 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.
--progress Display a progress indication dialog.
--question Display a question dialog.
--text-info Display a text information dialog.
--warning Display a warning dialog.
General Dialog Options
The following general dialog options are supported:
--height=height Set the dialog height.
--title=title Set the dialog title.
--width=width Set the dialog width.
--window-icon=path Set the dialog window icon with a full path to an image.
Calendar Dialog Options
The following calendar dialog options are supported:
--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.
--day=number Set the calendar day.
--month=number Set the calendar month.
--text=text Set the dialog text.
--year=number Set the calendar year.
Text-Entry Dialog Options
The following text-entry dialog options are supported:
--entry-text=text Set the dialog entry text.
--hide-text Use asterisks to hide the entry text.
--text=text Set the dialog text.
Error Dialog Options
The following error dialog options are supported:
--text=text Set the dialog text.
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.
--separator=character Set the separator character to return at the command line. This option is used only when the dialog allows multi-
ple selections.
Informational Dialog Options
The following informational dialog options are supported:
--text=text Set the dialog text.
List Dialog Options
The following list dialog options are supported:
--checklist Specify that the first column contains check boxes.
--column=text Set the text of a column.
--editable Specify that the dialog contents are editable.
--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.
Progress-Indication Dialog Options
The following progress-indication dialog options are supported:
--auto-close Close the dialog automatically when 100% has been reached.
--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.
--text=text Set the dialog text.
Question Dialog Options
The following question dialog options are supported:
--text=text Set the dialog text.
Text-Informational Dialog Options
The following text-informational dialog options are supported:
--editable Specify that the dialog contents are editable.
--filename=path Set the file to display in the dialog.
Warning Dialog Options
The following warning dialog options are supported:
--text=text Set the dialog text.
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="LGPL License"
--filename="/home/user1/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 |SUNWzenity |
+-----------------------------+-----------------------------+
|Interface stability |External |
+-----------------------------+-----------------------------+
SEE ALSO
Zenity Manual
Latest version of the GNOME Desktop User Guide for your platform.
NOTES
Written by Glynn Foster, Sun Microsystems Inc., 2003, 2004.
SunOS 5.10 20 Jul 2004 zenity(1)