Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
YAD(1)				 User Commands				YAD(1)

       yad - display GTK+ dialogs in shell scripts

       yad [OPTIONS]

       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.

       YAD is the fork of Zenity program.

       This program follows the	usual GNU command line syntax, with  long  op-
       tions starting with two dashes (`-').

   Dialog options
       --app  Display application selection dialog.

	      Display calendar dialog.

	      Display color selection dialog.

       --dnd  Display drag-and-drop box.

	      Display text entry dialog.

	      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

	      Display multi progress bars dialog.

	      Display notebook dialog.

	      Display notification icon.

	      Display print dialog.

	      Display progress indication dialog.

	      Display text information dialog.

	      Display scale dialog.

   General options
	      Set the dialog title.

	      Set the window icon.

	      Set the dialog window width.

	      Set the dialog window height.

	      Set the X	position of dialog window. NUMBER can be negative.

	      Set the Y	position of dialog window. NUMBER can be negative.

	      Use  standard  X	Window	geometry  notation for placing dialog.
	      When this	option is used,	width, height, posx, posy,  mouse  and
	      center options are ignored.

	      Set the dialog timeout in	seconds.

	      Show  timeout  indicator	in  given position. Positions are top,
	      bottom, left or right.  Style of indicator may  be  set  through
	      the users	CSS styles.

	      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.

	      Output X Window ID of a yad's window to the  specified  file  or

	      Run dialog in plug mode for swallow as a notebook	tab. See NOTE-
	      BOOK section for more.

	      Set the tab number for plugged dialog. See NOTEBOOK section  for

	      Set the dialog text.

	      Set  type	of dialog text justification. TYPE may be left,	right,
	      center or	fill.

	      Set the dialog image which appears on the	left side  of  dialog.
	      IMAGE might be file name or icon name from current icon theme.

	      Use specified GTK	icon theme instead of default.

	      Don't scale icons. This option affects icons outside icon	theme.

	      Hide  main  widget  with	expander. TEXT is an optional argument
	      with expander's label.

	      Add the dialog button. May be used multiple times. ID is an exit
	      code or a	command.  BUTTON may be	a yad stock item name for pre-
	      defined buttons (like yad-close or yad-ok) or text in a form LA-
	      BEL[!ICON[!TOOLTIP]]  where `!' is an item separator.  Full list
	      of stock items may be found in section STOCK ITEMS.  If no  but-
	      tons  specified OK and Cancel buttons used. See EXIT STATUS sec-
	      tion for more.  If ID have a non-numeric value it	 treats	 as  a
	      command and click	on such	button doesn't close the dialog.

	      Don't show buttons.

	      Set  buttons  layout  type.  Possible  types  are: spread, edge,
	      start, end or center.  Default is	end.

	      Don't use	pango markup in	dialog's text.

	      Don't close dialog if Escape was pressed.

	      Escape acts like pressing	OK button.

	      Print result for any of the return codes.	 This  option  doesn't
	      work if timeout was reached or Escape was	pressed.

	      All  commands  runs unter	specified interpreter. Default is bash
	      -c '%s'. This option can reduse quoting in commands.  If	%s  is
	      specified,  it  will be replaced by the command.	Otherwise com-
	      mand will	be appended to the end of command line.

	      Set dialog window	borders.

	      Make window visible on all desktops.

	      Make window fixed	width and height.

	      Place window on center of	screen.

	      Place window under mouse position.

	      Place window over	other windows.

	      Make window undecorated (remove title and	window borders).

	      Don't show window	in taskbar and pager.

	      Run dialog window	maximized.

	      Run dialog in fullscreen mode. This option may not work  on  all
	      window managers.

	      Open  window  with  "splashscreen" window	hints. For details see
	      description of _NET_WM_WINDOW_TYPE_SPLASH	in EWMH	specification.
	      The  behavior  of	 dialog	 with this option is HIGHLY DEPENDS on
	      settings of your window manager.

	      Dialog window never take focus.

	      Close the	dialog window when it loose the	focus.

	      If set, user can select dialog's text and	copy it	to  clipboard.
	      This option also affects on label	fields in form dialog.

	      Add specified path to the	standard list of directories for look-
	      ing for icons. This option can be	used multiple times.

	      Read extra arguments from	given file instead  of	command	 line.
	      Each line	of a file treats as a single argument.

	      Set default exit code to NUMBER instead of 0.

	      Read and parse additional	GTK+ CSS styles	from given file.

	      Set  the	policy type for	horizontal scrollbars. TYPE can	be one
	      of the auto, always or never. Default is auto.

	      Set the policy type for vertical scrollbars. TYPE	can be one  of
	      the auto,	always or never. Default is auto.

	      Enable spell checking in textview	widgets

	      Set  spell  checking  language  to LANGUAGE. By default language
	      guesses from current locale. Use	option	--show-langs  for  get
	      list of all possible languages.

	      Set  the	output	type of	boolean	values to TYPE.	Possible types
	      are T, t,	Y, y, O, o and 1.
	      T	and t -	for true/false pair in appropriate case.
	      Y	and y -	for yes/no pair	in appropriate case.
	      O	and o -	for on/off pair	in appropriate case.
	      1	- for 1/0 pair.

   Application selection options
	      Show fallback applications.  --enable-other Show other  applica-
	      tions.  --enable-all Show	all available applications.  --extened
	      Shown extended information about choosen application. By default
	      only executable is shown.	In extended form the output fields are
	      name, display name, description, icon and	executable.

	      Additional argument for application dialog is  a	mime-type.  If
	      mime-type	is not specified text/plain will be used.

   Calendar options
	      Set the calendar day.

	      Set the calendar month.

	      Set the calendar year.

	      Set  the	format	for the	returned date. By default is `%x'. See
	      strftime(3) for more details.

	      Show the week numbers at the left	side of	calendar.

	      Read days	description from FILENAME.

       File with days details must be in following format:

	      <date> <description>

       date field is date in format, specified with --date-format option.  de-
       scription  is  a	 string	 with  date  details,  which may include Pango

   Color selection options
	      Set initial color	value.

	      Show system palette inside color dialog. For GTK+3  builds  this
	      option shows palette instead of color editor.

	      Add opacity to output color string.

	      Show  palette and	set predefined colors from given filename.  By
	      default yad use file /etc/X11/rgb.txt.

	      Expander for list	 of  user-defined  colors  will	 be  initially

	      Set  output  color mode. Possible	values are hex or rgb. Default
	      is hex. HEX mode looks like #rrggbbaa, RGB mode -	rgba(r,	g,  b,
	      a).  In RGBA mode	opacity	have values from 0.0 to	1.0.

   Drag-and-Drop box options
	      Use dialog text as a tooltip for Drag-and-Drop box.

	      Run  command when	data received. Data strings pass to command as
	      an argument or replace %s	modifier in  a	command.   By  default
	      data just	prints to stdout.

	      Exit  after NUMBER of drops was reached. 0 means infinite	number
	      of drops,	this is	the default.

   Text	entry options
	      Set the entry label text.

	      Set the initial entry text or default item in combo-box.

	      Hide the entry text.

	      Use completion instead of	combo-box.

	      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.

	      Allow make changes to text in combo-box.

	      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.

	      Set precision of floating	point numbers. By default precision is
	      three digits after point.

	      Set an icon on a left side of entry.

	      Specify a	command	which will be run when the left	icon  clicked.
	      Output of	command	will be	set as entry text.

	      Set an icon on a right side of entry.

	      Specify a	command	which will be run when the right icon clicked.
	      Output of	command	will be	set as entry text.

	      Output index of active element instead of	text for combo-box en-

       Any  extra data specified in command line adds as an items of combo-box
       entry, except of	numeric	mode.

       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 .desktop files from specified directory.

	      Watch  for changes in directory and automatically	update content
	      of iconbox.

	      Use field	GenericName instead of Name for	shortcut label.

	      Use field	Name instead of	filename for sorting items.

	      Sort items in descending order. If data reads  from  stdin  this
	      option is	useless	without	--sort-by-name.

	      Read  data  from	stdin.	Data must be in	order -	Name, Tooltip,
	      Icon, Command, InTerm separated by newline. InTerm is a case in-
	      sensitive	 boolean  constant  (TRUE or FALSE).  Sending FormFeed
	      character	clears iconbox.

	      Set items	width.

	      Force using specified icon size. This  option  doesn't  work  in
	      compact mode.

	      Use compact mode.	Icon and name of each item is placed in	a sin-
	      gle row.

	      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 re-
	      placed by	the command.

       If both directory and stdin specified, content of iconbox will be  read
       from directory.

   File	selection options
	      Set the filename.

	      Allow selection of multiple filenames in file selection dialog.

	      Activate directory-only selection.

       --save Activate save mode.

	      Specify separator	character when returning multiple filenames.

	      Confirm file selection if	filename already exists.  Optional ar-
	      gument is	a text for confirmation	dialog.

	      Output values will be shell-style	quoted.

   Font	selection options
	      Set the initial font. FONTNAME is	a string with font representa-
	      tion in the form "[FAMILY-LIST] [STYLE-OPTIONS] [SIZE]".

	      Set the preview text.

	      Separate output of selected font description.

	      Set output separator character. Default is `|'.

	      Output data will be in shell-style quotes.

   Form	options
	      Add field	to form. Type may be H,	RO, NUM, CHK, CB, CBE, CE, FL,
	      or TXT.
	      H	 -  hidden field type. All characters are displayed as the in-
	      visible 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 bool-
	      ean 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-
	      CE - entry with completion. Initial value	same as	for combo-box.
	      FL - file	selection button.
	      SFL - field for create file.
	      DIR - directory selection	button.
	      CDIR - field for create folder.
	      FN  -  font selection button. Initial value same as in font dia-
	      MFL - select multiple files. Value of this field is  a  list  of
	      files separated by item-separator.
	      MDIR - select multiple folders. Value of this field is a list of
	      folders separated	by item-separator.
	      DT - date	field.
	      SCL - scale field. Value of this field in	a range	0..100.
	      APP - application	selection button. Input	value for  this	 field
	      is  mime-type.  Output  value - executable for selected applica-
	      CLR - color selection button. Output values for this field  gen-
	      erates in	the same manner	as for color dialog.
	      BTN  -  button  field.  Label  may be in form text in a form LA-
	      BEL[!ICON[!TOOLTIP]] where `!' is	an item	separator. LABEL is  a
	      text  of	button	label  or yad stock id.	ICON is	a buttons icon
	      (stock id	or file	name). TOOLTIP is an optional text  for	 popup
	      help  string.  Initial  value is a command which is running when
	      button is	clicked. A special sympols %N in command are  replaced
	      by  value	 of  field  N. If command starts with @, the output of
	      command will be parsed and lines started with number  and	 colon
	      will be treats as	a new field values.  A quoting style for value
	      when sh -c is used - a single quotes around command  and	double
	      quotes around -c argument
	      FBTN - same as button field, but with full relief	of a button.
	      LINK - link button field.
	      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.

	      Set  alignment  of field labels. Possible	types are left,	center
	      or right.	Default	is left.

	      Set number of columns in form. Fields will be placed from	top to

	      Set output separator character. Default is `|'.

	      Set focused field.

	      Cycled  reading of stdin data. Sending FormFeed character	clears
	      the form.	This symbol may	be sent	as echo	-e '\f'.

	      Set separator character for combo-box or scale  values.  Default
	      is `!'.

	      Set the format for the date fields (same as in calendar dialog).

	      Set precision of floating	point numbers. By default precision is
	      three digits after point.

	      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.

	      Make form	scrollable.

	      Output values will be in shell-style quotes.

	      Output field values row by row if	several	columns	is specified.

	      Output index of active element instead  of  text	for  combo-box

       Additional data in command line interprets as a default values for form
       fields. A special value @disabled@ makes	corresponding field  inactive.
       If  no extra arguments specified	in a command line, data	will be	readed
       from stdin, one value per line. Cycled reading means that for N	fields
       N+1  value  will	replace	the first field. Empty values are skipped when
       reading from stdin.

   HTML	options
	      Open specified location. URI can be a filename or	 internet  ad-
	      dress. If	URI is not an existing file and	protocol is not	speci-
	      fied a prefix http:// will be added to URI.

	      Turn on browser mode. In this mode all  clicked  links  will  be
	      opened  in html widget and command Open will be added to context

	      Print clicked links to standard output. By default clicked links
	      opens with xdg-open.

	      Set  mime	type of	data passed to standard	input to MIME. Default
	      is text/html.

	      Set encoding of data passed to standard input to	ENCODING.  De-
	      fault is UTF-8.

	      Set external handler for clicked uri. %s will be replaced	by ac-
	      tivated uri. Return code of the CMD must be 0 for	keep  working,
	      1	 for ignoring uri and 2	for downloading	uri. This option works
	      only in browser mode. There are two environment variables	avail-
	      able  in	handler	 - YAD_HTML_BUTTON with	value of pressed mouse
	      button and YAD_HTML_STATE	with value of  bitmask	with  the  the
	      state of the modifier keys.

	      Set user agent string. Default is	YAD-Webkit (@VERSION@)

	      Set path or uri to custom	user styles. Path to local file	can be
	      an absolute file name or uri with	file://	prefix.

       When dialog wors	in browser mode	additional data	in command line	inter-
       prets as	URI.

   List	options
	      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 col-
	      umn.  SZ size column type. Works exactly	like  NUM  column  but
	      shows human readable sizes instead of numbers.  CHK (checkboxes)
	      and RD (radio toggle) are	a boolean columns.  BAR	is a  progress
	      bar column. Value	must be	between	0 and 100. If value is outside
	      is range it will be croped to neares legal value.	 HD type means
	      a	 hidden	 column.  Such	columns	are not	displayes in the list,
	      only in output.  IMG may be path to image	or icon	name from cur-
	      rnet  GTK+  icon	theme.	Size of	icons may be set in gtk	config
	      file at GTK_ICON_SIZE_MENU  position  of	gtk-icon-sizes.	 Image
	      field prints as empty value.

	      Special  column names @fore@, @back@ and @font@ sets correspond-
	      ing rows attributes.  Values of those columns don't show in  re-

       --tree Enbale  tree  mode. In this mode extra data in form ROW_ID[:PAR-
	      ENT_ID] must be passed to	yad before each	row. See EXAMPLES  for

	      Use  check  boxes	 for the first column. Output checked rows in-
	      stead of selected	rows. Disable multiple selection.

	      Same as --checklist but with a radio toggle for the  first  col-

	      Set output separator characters.

	      Allow multiple rows to be	selected.

	      Allow changes to text.

	      Set  the list of editable	columns. LIST must be a	string of num-
	      bers separated by	comma.

	      Do not show column headers.

	      Disable sorting of column	content	by clicking on its header.

	      Don't draw even and odd rows by a	different colors. This	option
	      depends on your current gtk theme	and may	not work.

	      Draw  grid lines of type TYPE in list dialog. TYPE can be	one of
	      the hor[izontal],	vert[ical] of both.

	      Disable selection	in list.

	      Print all	data from the list.

	      Specify what column will be printed to standard output. 0	may be
	      used to print all	columns	(this is default).

	      Hide a specific column.

	      Set the column expandable	by default. 0 sets all columns expand-

	      Set the quick search column. 0 mean to disable searching.	By de-
	      fault search mades on first column.

	      Set the column with popup	tooltips.

	      Set the row separator column. If the cell	value from this	column
	      equal to specified row separator value such row will be draw  as
	      separator.  Separator value must be set.

	      Set  the	TEXT as	a row separator	value. This feature highly de-
	      pends on your current GTK+ theme and may not work	properly.

	      Set the number of	rows in	list dialog. Will be  shown  only  the
	      last  NUMBER  rows.  This	option will take effect	only when data
	      reading from stdin.

	      Set the width of column before wrapping to NUMBER.

	      Set the list of wrapped columns. LIST must be a string  of  num-
	      bers separated by	comma.

	      Set  ellipsize  mode  for	text columns. TYPE may be NONE,	START,
	      MIDDLE or	END.

	      Set the list of ellipsized columns. LIST must  be	 a  string  of
	      numbers separated	by comma.

	      Set  the CMD as a	double-click command. When user	double-clicked
	      on row, CMD will be launched with	values of all  columns	as  an
	      arguments.  By  default  double-click  selects row and act as OK
	      button for simple	lists, set the checkbox	if --checklist	speci-
	      fied  and	do nothing when	list run with --multiple option.  When
	      double-click specified Enter acts	as a double-click and Ctrl+En-
	      ter  acts	 as an OK button.  CMD may contain a special character
	      `%s' for setting a position for arguments. By default  arguments
	      will  be	concatenated to	the end	of CMD.	 If CMD	starts with @,
	      its output will replace values  of  current  row.	  This	option
	      doesn't work with	--editable.

	      Set  the	CMD as a action	when selection is changed. CMD will be
	      launched with values of all columns as an	 arguments.   CMD  may
	      contain  a special character `%s'	for setting a position for ar-
	      guments. By default arguments will be concatenated to the	end of
	      CMD.  This option	doesn't	work with --multiple.

	      Set  the	CMD as a action	when the row is	added, modified	or re-
	      moved. First argument for	the command  is	 the  name  of	action
	      (add,  edit  or del).  The rest of command line is data from se-
	      lected row. Output of this command sets the new row values.

	      Expand all tree nodes at startup.

	      Use regular expressions in search	for text fields.

	      Listen data from stdin even if command-line  values  was	speci-

	      Output values will be shell-style	quoted.

	      Set precision of floating	point numbers. By default precision is
	      three digits after point.

	      Add new records at the top of the	list.

       --tail Autoscroll to the	end of the list	when a new row will be added.

	      Use IEC (base 1024) units	with for size values. With this	option
	      values will have suffixes	KiB, MiB, GiB.

       Sending	FormFeed  character to list clears it. This symbol may be sent
       as echo -e '\f'.

	      Don't use	markup in tooltips even	if text	has a valid markup.

   Notebook options
	      Set the key of the children.

	      Add tab with specified label to notebook.	TEXT may be in a  form
	      LABEL[!ICON[!TOOLTIP]] where `!' is an item separator.

	      Set the tabs position. Value may be top, bottom, left, or	right.
	      Default is  top.

	      Set the borders width around widget in tabs.

	      Set active tab.

	      Expand all tabs to full width of a dialog	window.

       See NOTEBOOK and	PANED section for more about notebook dialog.

   Notification	options
	      Set the command running when clicked on the icon.	Default	action
	      is quit if --listen not specified.

	      Listen for commands on stdin. See	NOTIFICATION section.

	      Set separator character for menu values. Default is |.

	      Set separator character for menu items. Default is !.

	      Set initial menu for right-click.

	      Disable exit on middle click.

	      Doesn't show icon	at startup.

	      Set  notification	 icon  size to SIZE. This option doesn't works
	      for themed icons.

       See NOTIFICATION	section	for more about separators.

   Paned options
	      Set the key of the children.

	      Set orientation of panes inside dialog. TYPE may be in hor[izon-
	      tal] or vert[ical].

	      Set the initial splitter position.

       See NOTEBOOK and	PANED section for more about paned dialog.

   Picture options
	      Set  initial  size of picture. Available values are fit for fit-
	      ting image in window or orig for show picture in original	size.

	      Set increment value for scaling image.

	      Set picture filename.

       Some actions on a picture like scaling or rotating available from popup
       menu. Those actions can be made only on static images.

   Print options
	      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.

	      Set name or path to the source file.

	      Add headers to the top of	page with filename  and	 page  number.
	      This option doesn't work for RAW type.

	      Add Preview button to the	print dialog. This option doesn't work
	      for RAW type.

	      Set the font for printing	text. FONTNAME is a string  with  font
	      representation   in   the	 form  "[FAMILY-LIST]  [STYLE-OPTIONS]
	      [SIZE]". This option works only for TEXT type.

   Progress options
       When the	--progress option is used, yad reads lines  of	progress  data
       from  stdin.  When the lines begin with # the text after	# is displayed
       in the progress bar label. Numeric values treats	like  a	 persents  for
       progress	bar.

	      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.  If	no bars	specified, the progress	 dialog	 works
	      in single-bar mode.

	      Set vertical orientation of progress bars.

	      Set  alignment of	bar labels. Possible types are left, center or
	      right. Default is	left.

	      Set the label of progress	bar to TEXT. This option works only in
	      single-bar mode.

	      Hide text	in progress bars.

       --rtl  Set Right-To-Left	progress bar direction.	This option works only
	      in single-bar mode.

	      Close dialog when	100% has been reached.

	      Kill parent process if cancel button is pressed.

	      Pulsate progress bar. This option	works only in single-bar mode.

	      Show log window. This window gathers all of  lines  from	stdin,
	      started  from  #	instead	 of setting appropriate	progress text.
	      Optional argument	TEXT is	a text label for window	expander.

	      Place log	window above progress bars.

	      Start with expanded log window.

	      Set the height of	log window.

       Initial values for bars sets as an extra	 arguments.  Each  lines  with
       progress	data passed to stdin must be started from N: where N is	a num-
       ber of progress bar. In a single-bar mode N: is not needed.

   Text	info options
	      Open specified file.

	      Allow changes to text.

       --wrap Enable text wrapping.

	      Enable Pango markup. This	option doesn't	work  with  --editable

	      Set justification. TYPE may be left, right, center or fill.  De-
	      fault is left.

	      Set text margins to NUMBER.

       --tail Autoscroll to end	when new text appears. Works only when text is
	      read from	stdin.

	      Show cursor in read-only mode.

	      Make links in text clickable. Links opens	with xdg-open command.

	      Set default color	for text.

	      Set default color	for background.

	      Set color	for links. Default is blue.

	      Highlight	 syntax	for specified LANGUAGE.	This option works only
	      if yad builds with gtksourceview.

	      Set used theme to	THEME. This option works only  if  yad	builds
	      with gtksourceview. Use option --show-themes for get list	of all
	      available	themes.

	      Listen data from stdin even if filename was specified.

	      If fontname option is specified for text dialog, the description
	      of  font	must  be in CSS	style (not in a	Pango style).  Sending
	      FormFeed character to text dialog	clears it. This	symbol may  be
	      sent  as	echo -e	'\f'.  Pressing	Ctrl+S popups the search entry
	      in text dialog.

   Scale options
	      Set initial value.

	      Set minimum value.

	      Set maximum value.

	      Set step size.

	      Set paging size. By default page value is	STEP*10.

	      Print partial values.

	      Hide value.

	      Show vertical scale.

	      Invert scale direction.

	      Show buttons on edges of a scale for  increasing	or  decreasing
	      scale value.

	      Add  a mark to scale. May	be used	multiple times.	NAME is	an op-
	      tional arguments for set label to	mark.

   File	filters	options
       --file-filter=NAME | PATTERN1 PATTERN2 ...
	      Add a filename filter. NAME is a displayed filter	name,  PATTERN
	      is  a shell-style	filename pattern (for example *.txt). This op-
	      tion may be used multiple	times.

       --mime-filter=NAME | MIME1 MIME2	...
	      Add a mime-type filter. NAME is a	displayed filter name, PATTERN
	      is a name	of mime	type (for example text/plain). This option may
	      be used multiple times.

	      Add filter for images supported by gdk-pixbuf library.  NAME  in
	      as optional name for this	filter.

	      Add  preview  widget.  Preview images loads from large or	normal
	      thumbnails according  to	XDG  Thumbnails	 specification	v0.8.0
	      (	    or
	      creates by yad for image files and saves as large	thumbnails.

	      This options applies to all of yad's file	chooser	dialogs.

   Miscellaneous options
       -?, --help
	      Show summary of options.

	      Display an about dialog.

	      Show version of program.

	      Show list	of possible languages for  spell  checking.  Available
	      only if yad builds with GtkSpell support.

	      Show  list  of  possible GtkSourceView themes. Available only if
	      yad builds with GtkSourceView support.

       Also the	standard GTK+ options are accepted.

       Notebook	is a complex dialog which swallow other	dialogs	in  his	 tabs.
       Dialogs	identifies  by unique key (integer) and	must be	runs in	a spe-
       cial plug mode (--plug option).	Following example runs notebook	dialog
       with two	tabs, first has	a simple text and second is an entry dialog.

       #! /bin/sh

       yad --plug=12345	--tabnum=1 --text="first tab with text"	&> res1	&
       yad --plug=12345	--tabnum=2 --text="second tab" --entry &> res2 &
       yad --notebook --key=12345 --tab="Tab 1"	--tab="Tab 2"

       NOTE: The order of output results for tabs is undefined!

       Paned  works in a same manner as	a notebook with	one restriction	- only
       first and secong	plug dialogs will be swallowed to panes.

       Allows commands to be sent to yad in the	form  command:args.   Possible
       commands	are icon, tooltip, visible, action, menu and quit.

	      Set notification icon to ICONNAME.

	      Set notification tooltip.

	      Set notification icon to visible,	invisible or blinking states.

	      Specify  the  command running when click on the icon.  There are
	      two special commands - menu for popup user defined menu and quit
	      for exit the program.

	      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.

       This is a list of predefined items available in yad.

	      ID	     Label text	  Icon name
	      yad-about	     About	  help-about
	      yad-add	     Add	  list-add
	      yad-apply	     Apply	  gtk-apply
	      yad-cancel     Cancel	  gtk-cancel
	      yad-clear	     Clear	  document-clear
	      yad-close	     Close	  window-close
	      yad-edit	     Edit	  gtk-edit
	      yad-execute    Execute	  system-run
	      yad-no	     No		  gtk-no
	      yad-ok	     OK		  gtk-ok
	      yad-open	     Open	  document-open
	      yad-print	     Print	  document-print
	      yad-quit	     Quit	  application-exit
	      yad-refresh    Refresh	  view-refresh
	      yad-remove     Remove	  list-remove
	      yad-save	     Save	  document-save
	      yad-search     Search	  system-search
	      yad-settings   Settings	  gtk-preferences
	      yad-yes	     Yes	  gtk-yes

	      This  variable  can  holds some default options for yad. All op-
	      tions in this variable may be redefined from command line.

	      This variable sets to the	value of current dialog's pid and  ac-
	      cessible in all dialog children.

	      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 or paned children.

	      Close dialog with	0 exit code.

	      Close dialog with	1 exit code.

       0      The user has pressed OK button

       1      The user has pressed Cancel button

       70     The dialog has been closed because the timeout has been reached.

       252    The dialog has been closed by pressing Esc or  used  the	window
	      functions	to close the dialog

       Exit  codes  for	 user-specified	 buttons  must be specified in command
       line. Even exit code mean to print result, odd just return exit code.

       The look	and feel of yad's dialogs  can	be  customized	through	 gtkrc
       file. Here is the names of yad's	widgets:

	      Widget name	      Widget type	      Description
	      yad-dialog-window	      GtkDialog		      Dialog window
	      yad-dialog-image	      GtkImage		      Dialog image
	      yad-dialog-label	      GtkLabel		      Dialog text
	      yad-app-widget	      GtkAppChooserWidget     Application selection widget
	      yad-calendar-widget     GtkCalendar	      Calendar widget
	      yad-color-widget	      GtkColorChooser	      Color selection widget
	      yad-color-palette	      GtkTreeView	      Predefined colors	list
	      yad-entry-label	      GtkLabel		      Entry label
	      yad-entry-widget	      GtkEntry		      Entry widget
	      yad-entry-spin	      GtkSpinButton	      Entry widget for numeric values
	      yad-entry-combo	      GtkComboBox	      Entry widget with	combo

	      yad-entry-edit-combo    GtkComboBoxEntry	      Entry widget with	editable combo
	      yad-file-widget	      GtkFileChooser	      File selection widget
	      yad-font-widget	      GtkFontChooser	      Font selection widget
	      yad-form-flabel	      GtkLabel		      Field label in form
	      yad-form-button	      GtkButton		      Button field in form
	      yad-form-entry	      GtkEntrfy		      Entry field in form
	      yad-form-spin	      GtkSpinButton	      Numeric entry field in form
	      yad-form-check	      GtkCheckButton	      Checkbox field in	form
	      yad-form-combo	      GtkComboBox	      Combo field in form
	      yad-form-edit-combo     GtkComboBoxEntry	      Editable combo field in form
	      yad-form-link	      GtkLinkButton	      Link field in form
	      yad-form-file	      GtkFileChooserButton    File or directory	field in form
	      yad-form-font	      GtkFontChooserButton    Font field in form
	      yad-form-app	      GtkAppChooserButton     Application field	in form
	      yad-form-color	      GtkColorChooserButton   Color field in form
	      yad-form-label	      GtkLabel		      Label field in form
	      yad-form-scale	      GtkScale		      Scale widget in form
	      yad-form-separator      GtkSeparator	      Separator	in form
	      yad-form-text	      GtkTextView	      Multiline	text field in form
	      yad-icons-full	      GtkIconView	      Icons widget for normal mode
	      yad-icons-compact	      GtkTreeView	      Icons widget for compact mode
	      yad-list-widget	      GtkTreeView	      List widget
	      yad-notebook-widget     GtkNotebook	      Notebook widget
	      yad-paned-widget	      GtkPaned		      Horizontal or vertical pane widget
	      yad-progress-widget     GtkProgressBar	      Progressbar widget
	      yad-scale-widget	      GtkScale		      Scale widget
	      yad-text-widget	      GtkTextView	      Text info	widget
	      yad-timeout-indicator   GtkProgreeBar	      Timeout indicator

	      YAD  default  settings.  yad.conf	 placed	in $XDG_CONFIG_HOME or
	      $HOME/.config directory. This file contain comments on every de-
	      faults  and will be automatically	recreated on yad'd start if it
	      doesn't exists.

       Display a file selector with the	title Select a	file  to  remove.  The
       file selected is	returned on standard output.

	      yad  --title="Select a file to remove" --file-selection

       Display a text entry dialog with	the title Select Host and the text Se-
       lect the	host you would like to flood-ping. The	entered	 text  is  re-
       turned on standard output.

	      yad   --title  "Select Host" --entry --text "Select the host you
	      would like to flood-ping"

       Display a dialog, asking	Microsoft Windows has been  found!  Would  you
       like to remove it?. The return code will	be 0 (true in shell) if	YES is
       selected, and 1 (false) if NO is	selected.

	      yad  --image  "dialog-question"  --title	"Alert"	 --button=gtk-
	      yes:0  --button=gtk-no:1	--text	"Microsoft  Windows  has  been
	      found! Would you like to remove it?"

       Show the	search results in a list dialog	with the title Search  Results
       and the text Finding all	header files....

	      find  . -name '*.h' | yad	--list --title "Search Results"	--text
	      "Finding all header files.." --column "Files"

       Show an icon in the notification	area

	      yad --notification --image=update.png --text "System update nec-
	      essary!" --command "xterm	-e apt-get upgrade"

       Display	a  weekly shopping list	in a check list	dialog with Apples and
       Oranges pre selected

	      yad --list --checklist --column "Buy" --column "Item"  TRUE  Ap-
	      ples TRUE	Oranges	FALSE Pears FALSE Toothpaste

       Display	a progress dialog while	searching for all the postscript files
       in your home directory

	      find $HOME -name '*.ps' |	yad --progress --pulsate

       Display a box with all of the installed desktop applications

	      yad --icons --read-dir=/usr/share/applications

       Display list in tree mode

	      yad --list --tree	--column "Items" f Fruits 1:f Apple 2:f	 Lemon
	      v	Vegetables 3:v Popato 4:v Onion

       There are some developers features providing with YAD.

       YAD  icon  browser is a graphical tool for discover icons in current or
       user-specified GTK+ icon	theme. Launch it as

	      yad-icon-browser [theme]

       When using autoconf you may use special m4 macro	AM_PATH_YAD for	 look-
       ing for yad and check it	version. Usage of this macro is


       Yad was written by Victor  Ananjevsky  <>.  Yad  icon
       created by Bogdan Lisovich.

       gdialog(1), dialog(1), zenity(1)

yad				 June 3, 2017				YAD(1)


Want to link to this manual page? Use this URL:

home | help