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, 1 or 5, depending
18 on whether the user pressed OK, Cancel or timeout has been reached.
19 zenity --entry will output on standard output what the user typed into
20 the text entry field.
21 Comprehensive documentation is available in the GNOME Help Browser.
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
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 --scale
64 Display scale dialog
65 --color-selection
67 Display color selection dialog
68 --password
70 Display password dialog
71 --forms
73 Display forms dialog
74 General options
77 --title=TITLE
80 Set the dialog title
81 --window-icon=ICONPATH
83 Set the window icon with the path to an image. Alternatively,
84 one of the four stock icons can be used: 'error', 'info', 'ques‐
85 tion' or 'warning'
86 --width=WIDTH
88 Set the dialog width
89 --height=HEIGHT
91 Set the dialog height
92 --timeout=TIMEOUT
94 Set the dialog timeout in seconds
95 Calendar options
97 --text=STRING
100 Set the dialog text
101 --day=INT
103 Set the calendar day
104 --month=INT
106 Set the calendar month
107 --year=INT
109 Set the calendar year
110 --date-format=PATTERN
112 Set the format for the returned date. The default depends on the
113 user locale or be set with the strftime style. For example %A
114 %d/%m/%y
115 Text entry options
118 --text=STRING
121 Set the dialog text
122 --entry-text=STRING
124 Set the entry text
125 --hide-text
127 Hide the entry text
128 Error options
131 --text=STRING
133 Set the dialog text
134 --no-wrap
136 Do not enable text wrapping
137 --no-markup
139 Do not enable pango markup
140 File selection options
143 --filename=FILENAME
145 Set the file or directory to be selected by default
146 --multiple
148 Allow selection of multiple filenames in file selection dialog
149 --directory
151 Activate directory-only selection
152 --save Activate save mode
154 --separator=SEPARATOR
156 Specify separator character when returning multiple filenames
157 --confirm-overwrite
159 Confirm file selection if filename already exists
160 --file-filter=NAME | PATTERN1 PATTERN2
162 Sets a filename filter
163 Info options
167 --text=STRING
169 Set the dialog text
170 --no-wrap
172 Do not enable text wrapping
173 --no-markup
175 Do not enable pango markup
176 List options
179 --text=STRING
182 Set the dialog text
183 --column=STRING
185 Set the column header
186 --checklist
188 Use check boxes for first column
189 --radiolist
191 Use radio buttons for first column
192 --separator=STRING
194 Set output separator character
195 --multiple
197 Allow multiple rows to be selected
198 --editable
200 Allow changes to text
201 --print-column=NUMBER
203 Specify what column to print to standard output. The default is
204 to return the first column. 'ALL' may be used to print all col‐
205 umns.
206 --hide-column=NUMBER
208 Hide a specific column
209 --hide-header
211 Hides the column headers
212 Notification options
215 --text=STRING
218 Set the notification text
219 --listen
221 Listen for commands on stdin. Commands include 'message',
222 'tooltip', 'icon', and 'visible' separated by a colon. For exam‐
223 ple, 'message: Hello world', 'visible: false', or 'icon:
224 /path/to/icon'. The icon command also accepts the four stock
225 icon: 'error', 'info', 'question', and 'warning'
226 Progress options
229 --text=STRING
232 Set the dialog text
233 --percentage=INT
235 Set initial percentage
236 --auto-close
238 Close dialog when 100% has been reached
239 --auto-kill
241 Kill parent process if cancel button is pressed
242 --pulsate
244 Pulsate progress bar
245 --no-cancel
247 Hides the cancel button
248 Question options
251 --text=STRING
254 Set the dialog text
255 --no-wrap
257 Do not enable text wrapping
258 --no-markup
260 Do not enable pango markup
261 --ok-label
263 Set the text of the OK button
264 --cancel-label
266 Set the text of the cancel button
267 Text options
270 --filename=FILENAME
273 Open file
274 --editable
276 Allow changes to text
277 --checkbox=TEXT
279 Enable a checkbox for use like a 'I read and accept the terms.'
280 --ok-label
282 Set the text of the OK button
283 --cancel-label
285 Set the text of the cancel button
286 Warning options
289 --text=STRING
292 Set the dialog text
293 --no-wrap
295 Do not enable text wrapping
296 --no-markup
298 Do not enable pango markup
299 Scale options
302 --text=STRING
305 Set the dialog text
306 --value=VALUE
308 Set initial value
309 --min-value=VALUE
311 Set minimum value
312 --max-value=VALUE
314 Set maximum value
315 --step=VALUE
317 Set step size
318 --print-partial
320 Print partial values
321 --hide-value
323 Hide value
324 Color selection options
327 --color=VALUE
330 Set the initial color
331 --show-palette
333 Show the palette
334 Password dialog options
337 --username
340 Display the username field
341 Forms dialog options
344 --add-entry=FIELDNAME
347 Add a new Entry in forms dialog
348 --add-password=FIELDNAME
350 Add a new Password Entry in forms dialog
351 --add-calendar=FIELDNAME
353 Add a new Calendar in forms dialog
354 --text=STRING
356 Set the dialog text
357 --separator=STRING
359 Set output separator character
360 --forms-date-format=PATTERN
362 Set the format for the returned date. The default depends on the
363 user locale or be set with the strftime style. For example %A
364 %d/%m/%y
365 Miscellaneous options
368 -?, --help
371 Show summary of options.
372 --about
374 Display an about dialog.
375 --version
377 Show version of program.
378 Also the standard GTK+ options are accepted. For more information about
381 the GTK+ options, execute following command.
382 zenity --help-gtk
384
387 Normally, zenity detects the terminal window from which it was launched
388 and keeps itself above that window. This behavior can be disabled by
389 unsetting the WINDOWID environment variable.
390
393 Display a file selector with the title Select a file to remove. The
394 file selected is returned on standard output.
395 zenity --title="Select a file to remove" --file-selection
397 Display a text entry dialog with the title Select Host and the text
399 Select the host you would like to flood-ping. The entered text is
400 returned on standard output.
401 zenity --title "Select Host" --entry --text "Select the host
403 you would like to flood-ping"
404 Display a dialog, asking Microsoft Windows has been found! Would you
406 like to remove it?. The return code will be 0 (true in shell) if OK is
407 selected, and 1 (false) if Cancel is selected.
408 zenity --question --title "Alert" --text "Microsoft Windows
410 has been found! Would you like to remove it?"
411 Show the search results in a list dialog with the title Search Results
413 and the text Finding all header files....
414 find . -name '*.h' | zenity --list --title "Search Results"
416 --text "Finding all header files.." --column "Files"
417 Show a notification in the message tray
419 zenity --notification --window-icon=update.png --text "System
421 update necessary!"
422 Display a weekly shopping list in a check list dialog with Apples and
424 Oranges pre selected
425 zenity --list --checklist --column "Buy" --column "Item" TRUE
427 Apples TRUE Oranges FALSE Pears FALSE Toothpaste
428 Display a progress dialog while searching for all the postscript files
430 in your home directory
431 find $HOME -name '*.ps' | zenity --progress --pulsate
433
435 Zenity was written by Glynn Foster <glynn.foster@sun.com>.
436 This manual page was written by Ross Burton <ross@burtonini.com>.
438
441 dialog(1)
442 December 2011 ZENITY(1)