Beruflich Dokumente
Kultur Dokumente
systutorials.com
NAME
SYNOPSIS
yad
[
OPTIONS
]
DESCRIPTION
YAD
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.
1 de 43 16/06/18 2:32
yad - display GTK+ dialogs in shell scripts about:reader?url=https://www.systutorials.com/docs/linux/man/...
OPTIONS
Dialog options
--calendar
Display calendar dialog.
--color
Display color selection dialog.
--dnd
Display drag-and-drop box.
--entry
Display text entry dialog.
--icons
Display box with shortcut icons.
--file
Display file selection dialog.
--font
Display font selection dialog.
--form
Display form dialog
--html
Display HTML dialog
--list
Display list dialog
--multi-progress
2 de 43 16/06/18 2:32
yad - display GTK+ dialogs in shell scripts about:reader?url=https://www.systutorials.com/docs/linux/man/...
General options
--title=TITLE
Set the dialog title.
--window-icon=ICON
Set the window icon.
--width=WIDTH
Set the dialog window width.
--height=HEIGHT
Set the dialog window height.
--posx=NUMBER
Set the X position of dialog window. NUMBER can be
3 de 43 16/06/18 2:32
yad - display GTK+ dialogs in shell scripts about:reader?url=https://www.systutorials.com/docs/linux/man/...
negative.
--posy=NUMBER
Set the Y position of dialog window. NUMBER can be
negative.
--geometry=WIDTHxHEIGHT+X+Y
Use standard X Window geometry notation for placing
dialog. When this option is used, width, height, posx,
posy, mouse and center options are ignored. This option
is obsolete for gtk3 builds.
--timeout=TIMEOUT
Set the dialog timeout in seconds.
--timeout-indicator=POSITION
Show timeout indicator in given position. Positions are
top, bottom, left or right. Style of indicator may be set
through the gtkrc file. See http://code.google.com/p/yad
/wiki/TimeoutIndicator for details.
--parent-win=XID
Specify a parent window for the dialog. This makes YAD
possible to use as embedded GUI tool.
--kill-parent[=SIGNAL]
Send SIGNAL to parent process. Default value of SIGNAL
is a SIGTERM. SIGNAL may be specified by it's number
or symbolic name with or without SIG prefix. See signal(7)
for details about signals.
--plug=KEY
Run dialog in plug mode for swallow as a notebook tab.
See NOTEBOOK section for more.
4 de 43 16/06/18 2:32
yad - display GTK+ dialogs in shell scripts about:reader?url=https://www.systutorials.com/docs/linux/man/...
--tabnum=NUMBER
Set the tab number for plugged dialog. See NOTEBOOK
section for more.
--text=STRING
Set the dialog text.
--text-align=TYPE
Set type of dialog text justification. TYPE may be left,
right, center or fill.
--image=IMAGE
Set the dialog image which appears on the left side of
dialog. IMAGE might be file name or icon name from
current icon theme.
--image-on-top
Show image above main widget instead of left. This option
is always on for print dialog.
--icon-theme=THEME
Use specified GTK icon theme instead of default.
--expander=TEXT
Hide main widget with expander. TEXT is an optional
argument with expander's label.
--button=BUTTON:ID
Add the dialog button. May be used multiply times. ID is
an exit code or a command. BUTTON may be gtk stock
item name for predefined buttons (like gtk-close or gtk-ok)
or text in a form LABEL[!ICON[!TOOLTIP]] where `!' is an
item separator. Full list of stock items may be found in gtk-
demo program, in snippet called "Stock Items and Icon
5 de 43 16/06/18 2:32
yad - display GTK+ dialogs in shell scripts about:reader?url=https://www.systutorials.com/docs/linux/man/...
6 de 43 16/06/18 2:32
yad - display GTK+ dialogs in shell scripts about:reader?url=https://www.systutorials.com/docs/linux/man/...
7 de 43 16/06/18 2:32
yad - display GTK+ dialogs in shell scripts about:reader?url=https://www.systutorials.com/docs/linux/man/...
Calendar options
8 de 43 16/06/18 2:32
yad - display GTK+ dialogs in shell scripts about:reader?url=https://www.systutorials.com/docs/linux/man/...
--day=NUMBER
Set the calendar day.
--month=NUMBER
Set the calendar month.
--year=NUMBER
Set the calendar year.
--date-format=PATTERN
Set the format for the returned date. By default is `%x'.
See strftime(3) for more details.
--show-weeks
Show the week numbers at the left side of calendar.
--details=FILENAME
Read days description from FILENAME.
<date> <description>
--init-color=COLOR
Set initial color value.
--gtk-palette
Show system palette inside color dialog.
--extra
9 de 43 16/06/18 2:32
yad - display GTK+ dialogs in shell scripts about:reader?url=https://www.systutorials.com/docs/linux/man/...
--tooltip
Use dialog text as a tooltip for Drag-and-Drop box.
--command=CMD
Run command when data received. Data strings pass to
command as an argument. By default data just prints to
stdout.
10 de 43 16/06/18 2:32
yad - display GTK+ dialogs in shell scripts about:reader?url=https://www.systutorials.com/docs/linux/man/...
--entry-label=STRING
Set the entry label text.
--entry-text=STRING
Set the initial entry text or default item in combo-box.
--hide-text
Hide the entry text.
--completion
Use completion instead of combo-box.
--complete=TYPE
Use specific type for extended completion. TYPE can be
any for match any of typed words, all for match all of
typed words or regex when typed text treats as regular
expression.
--editable
Allow make changes to text in combo-box.
--numeric
Use spin button instead of text entry. Additional
parameters in command line treats as minimum and
maximum values, step value and precisions (in that
order). All this values are optional. Default range is from 0
to 65535 with step 1.
--float-precision=NUMBER
Set precision of floating point numbers. By default
precision is three digits after point.
--licon=IMAGE
Set an icon on a left side of entry.
--licon-action=CMD
11 de 43 16/06/18 2:32
yad - display GTK+ dialogs in shell scripts about:reader?url=https://www.systutorials.com/docs/linux/man/...
If icon specified and icon action is not given, click on icon just
clear the entry. Numeric fields will ignore the icons.
Iconbox options
--read-dir=PATH
Read .desktop files from specified directory.
--monitor
Watch for changes in directory and automatically update
content of iconbox.
--generic
Use field GenericName instead of Name for shortcut
label.
--sort-by-name
Use field Name instead of filename for sorting items.
12 de 43 16/06/18 2:32
yad - display GTK+ dialogs in shell scripts about:reader?url=https://www.systutorials.com/docs/linux/man/...
--descend
Sort items in descending order. If data reads from stdin
this option is useless without --sort-by-name.
--listen
Read data from stdin. Data must be in order - Name,
Tooltip, Icon, Command, InTerm separated by newline.
InTerm is a case insensitive boolean constant (TRUE or
FALSE).
--item-width
Set items width.
--compact
Use compact mode. Icon and name of each item is
placed in a single row.
--single-click
Activate items by single mouse click. This option may not
works properly in case of compact mode.
--term
Pattern for terminal. By default use `xterm -e %s' where
%s replaced by the command.
--filename=FILENAME
Set the filename.
--multiple
13 de 43 16/06/18 2:32
yad - display GTK+ dialogs in shell scripts about:reader?url=https://www.systutorials.com/docs/linux/man/...
--fontname=FONTNAME
Set the initial font. FONTNAME is a string with font
representation in the form "[FAMILY-LIST] [STYLE-
OPTIONS] [SIZE]".
--preview
Set the preview text.
--separate-output
Separate output of selected font description.
--separator=STRING
14 de 43 16/06/18 2:32
yad - display GTK+ dialogs in shell scripts about:reader?url=https://www.systutorials.com/docs/linux/man/...
Form options
--field=LABEL[:TYPE]
Add field to form. Type may be H, RO, NUM, CHK, CB,
CBE, CE, FL, SFL, DIR, CDIR, FN, MFL, MDIR, DT, SCL,
CLR, BTN, FBTN, LBL or TXT.
H - hidden field type. All characters are displayed as the
invisible char.
RO - field is in read-only mode.
NUM - field is a numeric. Initial value format for this field is
VALUE[!RANGE[!STEP![PREC]]], where RANGE must be
in form MIN..MAX. `!' is a default item separator. PREC is
a precision for decimals.
CHK - checkbox field. Initial value is a case insensitive
boolean constant (TRUE or FALSE).
CB - combo-box field. Initial value is a list VAL1!VAL2!....
The separator is the same as in NUM field. Value started
with `^' threats as default for combo-box.
CBE - editable combo-box field. Initial value same as for
combo-box.
CE - entry with completion. Initial value same as for
combo-box.
15 de 43 16/06/18 2:32
yad - display GTK+ dialogs in shell scripts about:reader?url=https://www.systutorials.com/docs/linux/man/...
16 de 43 16/06/18 2:32
yad - display GTK+ dialogs in shell scripts about:reader?url=https://www.systutorials.com/docs/linux/man/...
button.
LBL - text label. If field name is empty, horizontal
separator line will be shown.
TXT - multiline text entry. This field is always occupy all of
form width.
Without type field will be a simple text entry.
--align=TYPE
Set alignment of field labels. Possible types are left,
center or right. Default is left.
--columns=NUMBER
Set number of columns in form. Fields will be placed from
top to bottom.
--separator=STRING
Set output separator character. Default is `|'.
--focus-field=NUMBER
Set focused field.
--cycle-read
Cycled reading of stdin data. Sending FormFeed
character clears the form. This symbol may be sent as
echo -e '\f'.
--item-separator=STRING
Set separator character for combo-box or scale values.
Default is `!'.
--date-format=PATTERN
Set the format for the date fields (same as in calendar
dialog).
--float-precision=NUMBER
17 de 43 16/06/18 2:32
yad - display GTK+ dialogs in shell scripts about:reader?url=https://www.systutorials.com/docs/linux/man/...
HTML options
18 de 43 16/06/18 2:32
yad - display GTK+ dialogs in shell scripts about:reader?url=https://www.systutorials.com/docs/linux/man/...
--uri=URI
Open specified location. URI can be a filename or internet
address. If URI is not an existing file and protocol is not
specified a prefix http:// will be added to URI.
--browser
Turn on browser mode. In this mode all clicked links will
be opened in html widget and command Open will be
added to context menu.
--print-uri
Print clicked links to standard output. By default clicked
links opens with xdg-open.
--mime=MIME
Set mime type of data passed to standard input to MIME.
Default is text/html.
--encodintg=ENCODING
Set encoding of data passed to standard input to
ENCODING. Default is UTF-8.
List options
--column=STRING[:TYPE]
Set the column header. Types are TEXT, NUM, SZ, FLT,
CHK, RD, BAR, IMG, HD or TIP. TEXT type is default.
Use NUM for integers and FLT for double values. TIP is
used for define tooltip column. SZ size column type.
Works exactly like NUM column but shows human
19 de 43 16/06/18 2:32
yad - display GTK+ dialogs in shell scripts about:reader?url=https://www.systutorials.com/docs/linux/man/...
--checklist
Use check boxes for first column.
--radiolist
Use radio toggle for first column.
--separator=STRING
Set output separator characters.
--multiple
Allow multiple rows to be selected.
--editable
Allow changes to text.
--editable-cols=LIST
Set the list of editable columns. LIST must be a string of
numbers separated by comma.
--no-headers
20 de 43 16/06/18 2:32
yad - display GTK+ dialogs in shell scripts about:reader?url=https://www.systutorials.com/docs/linux/man/...
21 de 43 16/06/18 2:32
yad - display GTK+ dialogs in shell scripts about:reader?url=https://www.systutorials.com/docs/linux/man/...
22 de 43 16/06/18 2:32
yad - display GTK+ dialogs in shell scripts about:reader?url=https://www.systutorials.com/docs/linux/man/...
23 de 43 16/06/18 2:32
yad - display GTK+ dialogs in shell scripts about:reader?url=https://www.systutorials.com/docs/linux/man/...
--quoted-output
Output values will be shell-style quoted.
--float-precision=NUMBER
Set precision of floating point numbers. By default
precision is three digits after point.
Sending FormFeed character to list clears it. This symbol may
be sent as echo -e '\f'.
--bar=LABEL[:TYPE]
Add progress bar. LABEL is a text label for progress bar.
TYPE is a progress bar type. Types are: NORM for normal
progress bar, RTL for inverted progress bar and PULSE
for pulsate progress bar.
--vertical
Set vertical orientation of progress bars.
--align=TYPE
Set alignment of bar labels. Possible types are left, center
or right. Default is left.
--auto-close
Close dialog when 100% has been reached for all of non-
pulsating progress bars.
--watch-barNUMBER
Watch for 100% of bar NUMBER for close dialog.
--auto-kill
24 de 43 16/06/18 2:32
yad - display GTK+ dialogs in shell scripts about:reader?url=https://www.systutorials.com/docs/linux/man/...
Notebook options
--key=KEY
Set the key of the children.
--tab=TEXT
Add tab with specified label to notebook. TEXT may be in
a form LABEL[!ICON[!TOOLTIP]] where `!' is an item
separator.
--tab-pos=TYPE
Set the tabs position. Value may be top, bottom, left, or
right. Default is top.
--tab-borders=NUMBER
Set the borders width around widget in tabs.
Notification options
--command=CMD
Set the command running when clicked on the icon.
Default action is quit if --listen not specified.
--listen
25 de 43 16/06/18 2:32
yad - display GTK+ dialogs in shell scripts about:reader?url=https://www.systutorials.com/docs/linux/man/...
Paned options
--key=KEY
Set the key of the children.
--orient=TYPE
Set orientation of panes inside dialog. TYPE may be in
hor[izontal] or vert[ical].
--splitter=POS
Set the initial splitter position.
Picture options
26 de 43 16/06/18 2:32
yad - display GTK+ dialogs in shell scripts about:reader?url=https://www.systutorials.com/docs/linux/man/...
--size=VALUE
Set initial size of picture. Available values are fit for fitting
image in window or orig for show picture in original size.
--inc=NUMBER
Set increment value for scaling image.
--filename=FILENAME
Set picture filename.
Print options
--type=TYPE
Set source file type. TYPE may be a TEXT for text files,
IMAGE for image files or RAW for files in postscript or pdf
formats.
--filename=FILENAME
Set name or path to the source file.
--headers
Add headers to the top of page with filename and page
number. This option doesn't work for RAW type.
--add-preview
Add Preview button to the print dialog. This option doesn't
work for RAW type.
--fontname=FONTNAME
Set the font for printing text. FONTNAME is a string with
27 de 43 16/06/18 2:32
yad - display GTK+ dialogs in shell scripts about:reader?url=https://www.systutorials.com/docs/linux/man/...
Progress options
--progress-text=TEXT
Set text in progress bar to TEXT.
--percentage=NUMBER
Set initial percentage.
--rtl
Set Right-To-Left progress bar direction.
--auto-close
Close dialog when 100% has been reached.
--auto-kill
Kill parent process if cancel button is pressed.
--pulsate
Pulsate progress bar.
--enable-log[=TEXT]
Show log window. This window gathers all of lines from
stdin, started from # instead of setting appropriate
progress labels. Optional argument TEXT is a text label
for window expander.
28 de 43 16/06/18 2:32
yad - display GTK+ dialogs in shell scripts about:reader?url=https://www.systutorials.com/docs/linux/man/...
--log-on-top
Place log window above progress bar.
--log-expanded
Start with expanded log window.
--log-height
Set the height of log window.
Multiprogress options
--bar=LABEL[:TYPE]
Add the progress bar with type TYPE. TYPE can be one
of the norm for average progress bar, rtl for progress bar
with inverted direction, pulse for pulsating progress bar
(m,oves on receiving data) or perm for permanent pulsatin
progress bar. prem progress bar understant two
commands - start for start movement and stop for stop it.
--watch-bar=NUMBER
Watch for specific bar for auto closing.
--align=TYPE
Set alignment of bar labels. TYPE can be left, center or
right.
--auto-close
Dismiss the dialog when 100% of all bars (or only
watching bar) has been reached.
--auto-kill
Kill parent process if cancel button was pressed.
29 de 43 16/06/18 2:32
yad - display GTK+ dialogs in shell scripts about:reader?url=https://www.systutorials.com/docs/linux/man/...
--filename=FILENAME
Open specified file.
--editable
Allow changes to text.
--fore=COLOR
Set foreground color of text.
--back=COLOR
Set background color of text.
--fontname=FONTNAME
Set text font. FONTNAME must be in a Pango font
description format. By default Monospace is used.
--wrap
Enable text wrapping.
--justify=TYPE
Set justification. TYPE may be left, right, center or fill.
Default is left.
--margins=NUMBER
Set text margins to NUMBER.
--tail
Autoscroll to end when new text appears. Works only
when text is read from stdin.
--show-cursor
Show cursor in read-only mode.
--show-uri
30 de 43 16/06/18 2:32
yad - display GTK+ dialogs in shell scripts about:reader?url=https://www.systutorials.com/docs/linux/man/...
Scale options
--value=VALUE
Set initial value.
--min-value=VALUE
Set minimum value.
--max-value=VALUE
Set maximum value.
--step=VALUE
Set step size.
--page=VALUE
Set paging size. By default page value is STEP*10.
--print-partial
31 de 43 16/06/18 2:32
yad - display GTK+ dialogs in shell scripts about:reader?url=https://www.systutorials.com/docs/linux/man/...
32 de 43 16/06/18 2:32
yad - display GTK+ dialogs in shell scripts about:reader?url=https://www.systutorials.com/docs/linux/man/...
Miscellaneous options
-?, --help
Show summary of options.
--about
Display an about dialog.
--version
Show version of program.
33 de 43 16/06/18 2:32
yad - display GTK+ dialogs in shell scripts about:reader?url=https://www.systutorials.com/docs/linux/man/...
#! /bin/sh
NOTIFICATION
command:args
. Possible commands are
icon
,
tooltip
,
visible
,
action
,
34 de 43 16/06/18 2:32
yad - display GTK+ dialogs in shell scripts about:reader?url=https://www.systutorials.com/docs/linux/man/...
menu
and
quit
.
icon:ICONNAME
Set notification icon to ICONNAME.
tooltip:STRING
Set notification tooltip.
visible:[true|false|blink]
Set notification icon to visible, invisible or blinking states.
action:COMMAND
Specify the command running when click on the icon.
Special string "quit" exit the program.
menu:STRING
Set popup menu for notification icon. STRING must be in
form name1[!action1[!icon1]]|name2[!action2[!icon2]]....
Empty name add separator to menu. Separator character
for values (e.g. `|') sets with --separator argument.
Separator character for menu items (e.g. `!') sets with
--item-separator argument.
quit
Exit the program. Middle click on icon also send quit
command.
ENVIRONMENT VARIABLES
35 de 43 16/06/18 2:32
yad - display GTK+ dialogs in shell scripts about:reader?url=https://www.systutorials.com/docs/linux/man/...
YAD_OPTIONS
This variable can holds some default options for yad. All
options in this variable may be redefined from command
line.
YAD_PID
This variable sets to the value of current dialog's pid and
accessible in all dialog children.
YAD_XID
This variable sets to the value of current dialog's X
Window ID and accessible in all dialog children. This
variable is not set in print and notification dialogs, and in a
dialogs which acts as a notebook children.
SIGUSR1
Close dialog with 0 exit code.
SIGUSR2
Close dialog with 1 exit code.
EXIT STATUS
0
The user has pressed OK button
1
36 de 43 16/06/18 2:32
yad - display GTK+ dialogs in shell scripts about:reader?url=https://www.systutorials.com/docs/linux/man/...
WIDGETS NAMES
yad-dialog-
GtkDialog Dialog window
window
yad-dialog-
GtkImage Dialog image
image
yad-dialog-
GtkLabel Dialog text
label
yad-
calendar- GtkCalendar Calendar widget
widget
37 de 43 16/06/18 2:32
yad - display GTK+ dialogs in shell scripts about:reader?url=https://www.systutorials.com/docs/linux/man/...
38 de 43 16/06/18 2:32
yad - display GTK+ dialogs in shell scripts about:reader?url=https://www.systutorials.com/docs/linux/man/...
spin in form
yad-form- Checkbox field in
GtkCheckButton
check form
yad-form- Combo field in
GtkComboBox
combo form
yad-form- Editable combo
GtkComboBoxEntry
edit-combo field in form
File or directory
yad-form-file GtkFileChooserButton
field in form
yad-form-font GtkFontChooserButton Font field in form
yad-form-
GtkColorChooserButton Color field in form
color
yad-form-
GtkLabel Label field in form
label
yad-form- Scale widget in
GtkScale
scale form
yad-form-
GtkSeparator Separator in form
separator
Multiline text field
yad-form-text GtkTextView
in form
Icons widget for
yad-icons-full GtkIconView
normal mode
yad-icons- Icons widget for
GtkTreeView
compact compact mode
yad-list-
GtkTreeView List widget
39 de 43 16/06/18 2:32
yad - display GTK+ dialogs in shell scripts about:reader?url=https://www.systutorials.com/docs/linux/man/...
widget
yad-
notebook- GtkNotebook Notebook widget
widget
Horizontal or
yad-paned-
GtkPaned vertical pane
widget
widget
yad-
Progressbar
progress- GtkProgressBar
widget
widget
yad-scale-
GtkScale Scale widget
widget
yad-text-
GtkTextView Text info widget
widget
yad-timeout-
GtkProgreeBar Timeout indicator
indicator
FILES
yad.conf
YAD default settings. yad.conf placed in
$XDG_CONFIG_HOME or $HOME/.config directory. This
file contain comments on every defaults and will be
automatically recreated on yad'd start if it doesn't exists.
40 de 43 16/06/18 2:32
yad - display GTK+ dialogs in shell scripts about:reader?url=https://www.systutorials.com/docs/linux/man/...
EXAMPLES
Display a text entry dialog with the title Select Host and the
text Select the host you would like to flood-ping. The entered
text is returned on standard output.
yad --title "Select Host" --entry --text "Select the host you
would like to flood-ping"
Show the search results in a list dialog with the title Search
Results and the text Finding all header files....
41 de 43 16/06/18 2:32
yad - display GTK+ dialogs in shell scripts about:reader?url=https://www.systutorials.com/docs/linux/man/...
DEVELOPMENT
42 de 43 16/06/18 2:32
yad - display GTK+ dialogs in shell scripts about:reader?url=https://www.systutorials.com/docs/linux/man/...
AM_PATH_YAD([MINIMUM-VERSION],\ [ACTION-IF-
FOUND],\ [ACTION-IF-NOT-FOUND])
AUTHORS
Yad
was written by Victor Ananjevsky <ananasik [at] gmail.com>.
Yad icon created by Bogdan Lisovich.
SEE ALSO
gdialog
(1),
dialog
(1),
zenity
(1)
SysTutorials
. All Rights Reserved.
43 de 43 16/06/18 2:32