1ZENITY(1) User Commands ZENITY(1)
2
6 zenity - display GTK dialogs
7
9 zenity is a program that will display GTK+ dialogs, and return (either
10 in the return code, or on standard output) the users input. This allows
11 you to present information, and ask for information from the user, from
12 all manner of shell scripts.
13 For example, zenity --question will return either 0, 1 or 5, depending
15 on whether the user pressed OK, Cancel or timeout has been reached.
16 zenity --entry will output on standard output what the user typed into
17 the text entry field.
18 Comprehensive documentation is also available in the GNOME Help
20 Browser.
21 Usage:
23 zenity [OPTION?]
24 Help Options:
26 -h, --help
27 Show help options
28 --help-all
30 Show all help options
31 --help-general
33 Show general options
34 --help-calendar
36 Show calendar options
37 --help-entry
39 Show text entry options
40 --help-error
42 Show error options
43 --help-info
45 Show info options
46 --help-file-selection
48 Show file selection options
49 --help-list
51 Show list options
52 --help-notification
54 Show notification options
55 --help-progress
57 Show progress options
58 --help-question
60 Show question options
61 --help-warning
63 Show warning options
64 --help-scale
66 Show scale options
67 --help-text-info
69 Show text information options
70 --help-color-selection
72 Show color selection options
73 --help-password
75 Show password dialog options
76 --help-forms
78 Show forms dialog options
79 --help-misc
81 Show miscellaneous options
82 General options
84 --title=TITLE
86 Set the dialog title
87 --width=WIDTH
89 Set the width
90 --height=HEIGHT
92 Set the height
93 --timeout=TIMEOUT
95 Set dialog timeout in seconds
96 --ok-label=TEXT
98 Set the label of the OK button
99 --cancel-label=TEXT
101 Set the label of the Cancel button
102 --extra-button=TEXT
104 Add an extra button
105 --modal
107 Set the modal hint
108 --attach=WINDOW
110 DEPRECATED; does nothing
111 Calendar options
113 --text=TEXT
115 Set the dialog text
116 --day=DAY
118 Set the calendar day
119 --month=MONTH
121 Set the calendar month
122 --year=YEAR
124 Set the calendar year
125 --date-format=PATTERN
127 Set the format for the returned date
128 Text entry options
130 --text=TEXT
132 Set the dialog text
133 --entry-text=TEXT
135 Set the entry text
136 --hide-text
138 Hide the entry text
139 Error options
141 --text=TEXT
143 Set the dialog text
144 --icon=ICON-NAME
146 Set the icon name
147 --no-wrap
149 Do not enable text wrapping
150 --no-markup
152 Do not enable Pango markup
153 --ellipsize
155 Enable ellipsizing in the dialog text. This fixes the high win‐
156 dow size with long texts
157 Info options
159 --text=TEXT
161 Set the dialog text
162 --icon=ICON-NAME
164 Set the icon name
165 --no-wrap
167 Do not enable text wrapping
168 --no-markup
170 Do not enable Pango markup
171 --ellipsize
173 Enable ellipsizing in the dialog text. This fixes the high win‐
174 dow size with long texts
175 File selection options
177 --filename=FILENAME
179 Set the filename
180 --multiple
182 Allow multiple files to be selected
183 --directory
185 Activate directory-only selection
186 --save Activate save mode
188 --separator=SEPARATOR
190 Set output separator character
191 --file-filter=NAME | PATTERN1 PATTERN2 ...
193 Set a filename filter
194 --confirm-overwrite
196 DEPRECATED; does nothing
197 List options
199 --text=TEXT
201 Set the dialog text
202 --column=COLUMN
204 Set the column header
205 --checklist
207 Use check boxes for the first column
208 --radiolist
210 Use radio buttons for the first column
211 --imagelist
213 Use an image for the first column
214 --separator=SEPARATOR
216 Set output separator character
217 --multiple
219 Allow multiple rows to be selected
220 --editable
222 Allow changes to text
223 --print-column=NUMBER
225 Print a specific column (Default is 1. 'ALL' can be used to
226 print all columns)
227 --hide-column=NUMBER
229 Hide a specific column
230 --hide-header
232 Hide the column headers
233 --mid-search
235 DEPRECATED; does nothing
236 Notification options
238 --text=TEXT
240 Set the notification text
241 --icon=ICON-NAME
243 Set the icon name
244 --listen
246 Listen for commands on stdin
247 --hint=TEXT
249 DEPRECATED; does nothing
250 Progress options
252 --text=TEXT
254 Set the dialog text
255 --percentage=PERCENTAGE
257 Set initial percentage
258 --pulsate
260 Pulsate progress bar
261 --auto-close
263 Dismiss the dialog when 100% has been reached
264 --auto-kill
266 Kill parent process if Cancel button is pressed
267 --no-cancel
269 Hide Cancel button
270 --time-remaining
272 Estimate when progress will reach 100%
273 Question options
275 --text=TEXT
277 Set the dialog text
278 --icon=ICON-NAME
280 Set the icon name
281 --no-wrap
283 Do not enable text wrapping
284 --no-markup
286 Do not enable Pango markup
287 --default-cancel
289 Give Cancel button focus by default
290 --ellipsize
292 Enable ellipsizing in the dialog text. This fixes the high win‐
293 dow size with long texts
294 --switch
296 Suppress OK and Cancel buttons
297 Warning options
299 --text=TEXT
301 Set the dialog text
302 --icon=ICON-NAME
304 Set the icon name
305 --no-wrap
307 Do not enable text wrapping
308 --no-markup
310 Do not enable Pango markup
311 --ellipsize
313 Enable ellipsizing in the dialog text. This fixes the high win‐
314 dow size with long texts
315 Scale options
317 --text=TEXT
319 Set the dialog text
320 --value=VALUE
322 Set initial value
323 --min-value=VALUE
325 Set minimum value
326 --max-value=VALUE
328 Set maximum value
329 --step=VALUE
331 Set step size
332 --print-partial
334 Print partial values
335 --hide-value
337 Hide value
338 Text information options
340 --filename=FILENAME
342 Open file
343 --editable
345 Allow changes to text
346 --font=TEXT
348 Set the text font
349 --checkbox=TEXT
351 Enable an I read and agree checkbox
352 --auto-scroll
354 Auto scroll the text to the end. Only when text is captured from
355 stdin
356 Color selection options
358 --color=VALUE
360 Set the color
361 --show-palette
363 Show the palette
364 Password dialog options
366 --username
368 Display the username option
369 Forms dialog options
371 --add-entry=Field name
373 Add a new Entry in forms dialog
374 --add-password=Field name
376 Add a new Password Entry in forms dialog
377 --add-calendar=Calendar field name
379 Add a new Calendar in forms dialog
380 --add-list=List field and header name
382 Add a new List in forms dialog
383 --list-values=List of values separated by |
385 List of values for List
386 --column-values=List of values separated by |
388 List of values for columns
389 --add-combo=Combo box field name
391 Add a new combo box in forms dialog
392 --combo-values=List of values separated by |
394 List of values for combo box
395 --show-header
397 Show the columns header
398 --text=TEXT
400 Set the dialog text
401 --separator=SEPARATOR
403 Set output separator character
404 --forms-date-format=PATTERN
406 Set the format for the returned date
407 Miscellaneous options
409 --about
411 About zenity
412 --version
414 Print version
415 Application Options:
417 --calendar
418 Display calendar dialog
419 --entry
421 Display text entry dialog
422 --error
424 Display error dialog
425 --info Display info dialog
427 --file-selection
429 Display file selection dialog
430 --list Display list dialog
432 --notification
434 Display notification
435 --progress
437 Display progress indication dialog
438 --question
440 Display question dialog
441 --warning
443 Display warning dialog
444 --scale
446 Display scale dialog
447 --text-info
449 Display text information dialog
450 --color-selection
452 Display color selection dialog
453 --password
455 Display password dialog
456 --forms
458 Display forms dialog
459
461 Display a file selector with the title Select a file to remove. The
462 file selected is returned on standard output.
463 zenity --title="Select a file to remove" --file-selection
465 Display a text entry dialog with the title Select Host and the text Se‐
467 lect the host you would like to flood-ping. The entered text is re‐
468 turned on standard output.
469 zenity --title "Select Host" --entry --text "Select the host
471 you would like to flood-ping"
472 Display a dialog, asking Microsoft Windows has been found! Would you
474 like to remove it?. The return code will be 0 (true in shell) if OK is
475 selected, and 1 (false) if Cancel is selected.
476 zenity --question --title "Alert" --text "Microsoft Windows
478 has been found! Would you like to remove it?"
479 Show the search results in a list dialog with the title Search Results
481 and the text Finding all header files....
482 find . -name '*.h' | zenity --list --title "Search Results"
484 --text "Finding all header files.." --column "Files"
485 Show a passive notification
487 zenity --notification --icon=software-update-available --text
489 "System update necessary!"
490 Display a weekly shopping list in a check list dialog with Apples and
492 Oranges pre selected
493 zenity --list --checklist --column "Buy" --column "Item" TRUE
495 Apples TRUE Oranges FALSE Pears FALSE Toothpaste
496 Display a progress dialog while searching for all the postscript files
498 in your home directory
499 find $HOME -name '*.ps' | zenity --progress --pulsate
501
503 Zenity was originally written by Glynn Foster <glynn.foster@sun.com>.
504 It has since been maintained by a number of contributors since then.
505 This manual page was originally written by Ross Burton <ross@bur‐
507 tonini.com>. It currently contains portions which are automatically
508 generated, and other portions written by its original author.
509
511 dialog(1)
512zenity May 2023 ZENITY(1)