1ZENITY(1) General Commands Manual ZENITY(1)
2
6 zenity - display GTK+ dialogs
7
9 zenity [options]
10
12 zenity is a program that will display GTK+ dialogs, and return (either
13 in the return code, or on standard output) the users input. This allows
14 you to present information, and ask for information from the user, from
15 all manner of shell scripts.
16 For example, zenity --question will return either 0 or 1, depending on
18 whether the user pressed OK or Cancel. zenity --entry will output on
19 standard output what the user typed into the text entry field.
20 Comprehensive documentation is available in the GNOME Help Browser,
22 under GNOME/Utilities.
23
25 This program follows the usual GNU command line syntax, with long
26 options starting with two dashes (`-').
27 Dialog options
30 --calendar
33 Display calendar dialog
34 --entry
36 Display text entry dialog
37 --error
39 Display error dialog
40 --file-selection
42 Display file selection dialog
43 --info Display info dialog
45 --list Display list dialog
47 --notification
49 Display notification icon
50 --progress
52 Display progress indication dialog
53 --question
55 Display question dialog
56 --text-info
58 Display text information dialog
59 --warning
61 Display warning dialog
62 General options
65 --title=TITLE
68 Set the dialog title
69 --window-icon=ICONPATH
71 Set the window icon
72 --width=WIDTH
74 Set the dialog width
75 --height=HEIGHT
77 Set the dialog height
78 Calendar options
80 --text=STRING
83 Set the dialog text
84 --day=INT
86 Set the calendar day
87 --month=INT
89 Set the calendar month
90 --year=INT
92 Set the calendar year
93 --date-format=STRING
95 Set the format for the returned date
96 Text entry options
99 --text=STRING
102 Set the dialog text
103 --entry-text=STRING
105 Set the entry text
106 --hide-text
108 Hide the entry text
109 Error options
112 --text=STRING
114 Set the dialog text
115 File selection options
118 --filename=FILENAME
120 Set the filename
121 --multiple
123 Allow selection of multiple filenames in file selection dialog
124 --separator=SEPARATOR
126 Specify separator character when returning multiple filenames
127 Info options
130 --text=STRING
132 Set the dialog text
133 List options
136 --text=STRING
139 Set the dialog text
140 --column=STRING
142 Set the column header
143 --checklist
145 Use check boxes for first column
146 --radiolist
148 Use radio buttons for first column
149 --separator=STRING
151 Set output separator character
152 --editable
154 Allow changes to text
155 --print-column=STRING
157 Specify what column to print to standard output. The default is
158 to return the first column. 'ALL' may be used to print all col‐
159 umns.
160 Notification options
163 --text=STRING
166 Set the notification text
167 Progress options
170 --text=STRING
173 Set the dialog text
174 --percentage=INT
176 Set initial percentage
177 --auto-close
179 Close dialog when 100% has been reached
180 --pulsate
182 Pulsate progress bar
183 Question options
185 --text=STRING
187 Set the dialog text
188 Text options
191 --filename=FILENAME
194 Open file
195 --editable
197 Allow changes to text
198 Warning options
201 --text=STRING
204 Set the dialog text
205 Miscellaneous options
208 -?, --help
211 Show summary of options.
212 --about
214 Display an about dialog.
215 --version
217 Show version of program.
218 Also the standard GTK+ options are accepted.
221
224 Display a file selector with the title Select a file to remove. The
225 file selected is returned on standard output.
226 zenity --title="Select a file to remove" --file-selection
228 Display a text entry dialog with the title Select Host and the text
230 Select the host you would like to flood-ping. The entered text is
231 returned on standard output.
232 zenity --title "Select Host" --entry --text "Select the host
234 you would like to flood-ping"
235 Display a dialog, asking Microsoft Windows has been found! Would you
237 like to remove it?. The return code will be 0 (true in shell) if OK is
238 selected, and 1 (false) if Cancel is selected.
239 zenity --question --title "Alert" --text "Microsoft Windows
241 has been found! Would you like to remove it?"
242 Show the search results in a list dialog with the title Search Results
244 and the text Finding all header files....
245 find . -name '*.h' | zenity --list --title "Search Results"
247 --text "Finding all header files.." --column "Files"
248 Show an icon in the notification area
250 zenity --notification --window-icon=update.png --text "System
252 update necessary!"
253 Display a weekly shopping list in a check list dialog with Apples and
255 Oranges pre selected
256 zenity --list --checklist --column "Buy" --column "Item" TRUE
258 Apples TRUE Oranges FALSE Pears FALSE Toothpaste
259 Display a progress dialog while searching for all the postscript files
261 in your home directory
262 find $HOME -name '*.ps' | zenity --progress --pulsate
264
266 Zenity was written by Glynn Foster <glynn.foster@sun.com>.
267 This manual page was written by Ross Burton <ross@burtonini.com>.
269
272 gdialog(1), dialog(1)
273 February 1st, 2003 ZENITY(1)