summaryrefslogtreecommitdiff
path: root/data/zenity.1
blob: 6fcc81df12d86d4a586c381ab97da480a47fecb4 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
.TH ZENITY 1 "December 2011"
.SH NAME
zenity \- display GTK+ dialogs
.SH SYNOPSIS
.B zenity
.RI [ options ]
.SH DESCRIPTION
\fBzenity\fP is a program that will display GTK+ dialogs, and return
(either in the return code, or on standard output) the users
input. This allows you to present information, and ask for information
from the user, from all manner of shell scripts.
.PP
For example, \fBzenity \-\-question\fP will return either 0, 1 or 5,
depending on whether the user pressed \fIOK\fP, \fICancel\fP or timeout
has been reached. \fBzenity --entry\fP will output on standard output
what the user typed into the text entry field.
.PP
Comprehensive documentation is available in the GNOME Help Browser,
under \fIGNOME/Utilities\fP.
.SH OPTIONS
This program follows the usual GNU command line syntax, with long
options starting with two dashes (`-').

.PP
Dialog options

.TP
.B \-\-calendar
Display calendar dialog
.TP
.B \-\-entry
Display text entry dialog
.TP
.B \-\-error
Display error dialog
.TP
.B \-\-file\-selection
Display file selection dialog
.TP
.B \-\-info
Display info dialog
.TP
.B \-\-list
Display list dialog
.TP
.B \-\-notification
Display notification
.TP
.B \-\-progress
Display progress indication dialog
.TP
.B \-\-question
Display question dialog
.TP
.B \-\-text-info
Display text information dialog
.TP
.B \-\-warning
Display warning dialog
.TP
.B \-\-scale
Display scale dialog
.TP
.B \-\-color-selection
Display color selection dialog
.TP
.B \-\-password
Display password dialog
.TP
.B \-\-forms
Display forms dialog

.PP
General options

.TP
.B \-\-title=TITLE
Set the dialog title
.TP
.B \-\-window-icon=ICONPATH
Set the window icon with the path to an image. Alternatively, one of the four stock icons can be used: 'error', 'info', 'question' or 'warning'
.TP
.B \-\-width=WIDTH
Set the dialog width
.TP
.B \-\-height=HEIGHT
Set the dialog height
.TP
.B \-\-timeout=TIMEOUT
Set the dialog timeout in seconds
.PP 
Calendar options

.TP
.B \-\-text=STRING
Set the dialog text
.TP
.B \-\-day=INT
Set the calendar day
.TP
.B \-\-month=INT
Set the calendar month
.TP
.B \-\-year=INT
Set the calendar year
.TP
.B \-\-date-format=PATTERN
Set the format for the returned date. The default depends on the user locale or be set with the strftime style. For example %A %d/%m/%y

.PP
Text entry options

.TP
.B \-\-text=STRING
Set the dialog text
.TP
.B \-\-entry-text=STRING
Set the entry text
.TP
.B \-\-hide-text
Hide the entry text

.PP
Error options
.TP
.B \-\-text=STRING
Set the dialog text
.TP
.B \-\-no\-wrap
Do not enable text wrapping
.TP
.B \-\-no\-markup
Do not enable pango markup

.PP
File selection options
.TP
.B \-\-filename=FILENAME
Set the file or directory to be selected by default
.TP
.B \-\-multiple
Allow selection of multiple filenames in file selection dialog
.TP
.B \-\-directory
Activate directory-only selection
.TP
.B \-\-save
Activate save mode
.TP
.B \-\-separator=SEPARATOR
Specify separator character when returning multiple filenames
.TP
.B \-\-confirm\-overwrite
Confirm file selection if filename already exists
.TP
.B \-\-file\-filter=NAME | PATTERN1 PATTERN2
Sets a filename filter


.PP
Info options
.TP
.B \-\-text=STRING
Set the dialog text
.TP
.B \-\-no\-wrap
Do not enable text wrapping
.TP
.B \-\-no\-markup
Do not enable pango markup

.PP
List options

.TP
.B \-\-text=STRING
Set the dialog text
.TP
.B \-\-column=STRING
Set the column header
.TP
.B \-\-checklist
Use check boxes for first column
.TP
.B \-\-radiolist
Use radio buttons for first column
.TP
.B \-\-separator=STRING
Set output separator character
.TP
.B \-\-multiple
Allow multiple rows to be selected
.TP
.B \-\-editable
Allow changes to text
.TP
.B \-\-print-column=NUMBER
Specify what column to print to standard output. The default is to return
the first column. 'ALL' may be used to print all columns.
.TP
.B \-\-hide\-column=NUMBER
Hide a specific column
.TP
.B \-\-hide\-header
Hides the column headers

.PP
Notification options

.TP
.B \-\-text=STRING
Set the notification text
.TP
.B \-\-listen
Listen for commands on stdin. Commands include 'message', 'tooltip', 'icon', and 'visible' separated by a colon. For example, 'message: Hello world', 'visible: false', or 'icon: /path/to/icon'. The icon command also accepts the four stock icon: 'error', 'info', 'question', and 'warning'

.PP
Progress options

.TP
.B \-\-text=STRING
Set the dialog text
.TP
.B \-\-percentage=INT
Set initial percentage
.TP
.B \-\-auto\-close
Close dialog when 100% has been reached
.TP
.B \-\-auto\-kill
Kill parent process if cancel button is pressed
.TP
.B \-\-pulsate
Pulsate progress bar
.TP
.B \-\-no\-cancel
Hides the cancel button

.PP
Question options

.TP
.B \-\-text=STRING
Set the dialog text
.TP
.B \-\-no\-wrap
Do not enable text wrapping
.TP
.B \-\-no\-markup
Do not enable pango markup
.TP
.B \-\-ok\-label
Set the text of the OK button
.TP
.B \-\-cancel\-label
Set the text of the cancel button

.PP
Text options

.TP
.B \-\-filename=FILENAME
Open file
.TP
.B \-\-editable
Allow changes to text
.TP
.B \-\-checkbox=TEXT
Enable a checkbox for use like a 'I read and accept the terms.'
.TP
.B \-\-ok\-label
Set the text of the OK button
.TP
.B \-\-cancel\-label
Set the text of the cancel button

.PP
Warning options

.TP
.B \-\-text=STRING
Set the dialog text
.TP
.B \-\-no\-wrap
Do not enable text wrapping
.TP
.B \-\-no\-markup
Do not enable pango markup

.PP
Scale options

.TP
.B \-\-text=STRING
Set the dialog text
.TP
.B \-\-value=VALUE
Set initial value
.TP
.B \-\-min\-value=VALUE
Set minimum value
.TP
.B \-\-max\-value=VALUE
Set maximum value
.TP
.B \-\-step=VALUE
Set step size
.TP
.B \-\-print\-partial
Print partial values
.TP
.B \-\-hide\-value
Hide value

.PP
Color selection options

.TP
.B \-\-color=VALUE
Set the initial color
.TP
.B \-\-show\-palette
Show the palette

.PP
Password dialog options

.TP
.B \-\-username
Display the username field

.PP
Forms dialog options

.TP
.B \-\-add\-entry=FIELDNAME
Add a new Entry in forms dialog
.TP
.B \-\-add\-password=FIELDNAME
Add a new Password Entry in forms dialog
.TP
.B \-\-add\-calendar=FIELDNAME
Add a new Calendar in forms dialog
.TP
.B \-\-text=STRING
Set the dialog text
.TP
.B \-\-separator=STRING
Set output separator character
.TP
.B \-\-forms\-date-format=PATTERN
Set the format for the returned date. The default depends on the user locale or be set with the strftime style. For example %A %d/%m/%y

.PP
Miscellaneous options

.TP
.B \-?, \-\-help
Show summary of options.
.TP
.B \-\-about
Display an about dialog.
.TP
.B \-\-version
Show version of program.

.PP
Also the standard GTK+ options are accepted. For more information about the GTK+ options, execute following command.
.IP
zenity \-\-help\-gtk

.SH ENVIRONMENT

Normally, zenity detects the terminal window from which it was launched and
keeps itself above that window.  This behavior can be disabled by unsetting the
WINDOWID environment variable.

.SH EXAMPLES

Display a file selector with the title \fISelect a file to
remove\fP. The file selected is returned on standard output.
.IP
zenity  \-\-title="Select a file to remove" \-\-file-selection
.PP
Display a text entry dialog with the title \fISelect Host\fP and the
text \fISelect the host you would like to flood-ping\fP. The entered
text is returned on standard output.
.IP
zenity  \-\-title "Select Host" \-\-entry \-\-text "Select the host you would like to flood-ping"
.PP
Display a dialog, asking \fIMicrosoft Windows has been found! Would
you like to remove it?\fP. The return code will be 0 (true in shell)
if \fIOK\fP is selected, and 1 (false) if \fICancel\fP is selected.
.IP
zenity  \-\-question \-\-title "Alert"  \-\-text "Microsoft Windows has been found! Would you like to remove it?"
.PP
Show the search results in a list dialog with the title \fISearch Results\fP
and the text \fIFinding all header files...\fP.
.IP
find . \-name '*.h' | zenity \-\-list \-\-title "Search Results" \-\-text "Finding all header files.." \-\-column "Files"
.PP
Show a notification in the message tray
.IP
zenity \-\-notification \-\-window-icon=update.png \-\-text "System update necessary!"
.PP
Display a weekly shopping list in a check list dialog with \fIApples\fP and \fIOranges\fP pre selected
.IP
zenity \-\-list \-\-checklist \-\-column "Buy" \-\-column "Item" TRUE Apples TRUE Oranges FALSE Pears FALSE Toothpaste
.PP
Display a progress dialog while searching for all the postscript files in your home directory
.P
find $HOME \-name '*.ps' | zenity \-\-progress \-\-pulsate
.SH AUTHOR
\fBZenity\fP was written by Glynn Foster <glynn.foster@sun.com>.
.P
This manual page was written by Ross Burton <ross@burtonini.com>.

.SH SEE ALSO
\fBgdialog\fP(1), \fBdialog\fP(1)