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

FreeBSD Manual Pages

  
 
  

home | help
ZENITY(1)		    General Commands Manual		     ZENITY(1)

NAME
       zenity -	display	GTK+ dialogs

SYNOPSIS
       zenity [options]

DESCRIPTION
       zenity  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.

       For example, zenity --question will return either 0, 1 or 5,  depending
       on  whether  the	 user  pressed OK, Cancel or timeout has been reached.
       zenity --entry will output on standard output what the user typed  into
       the text	entry field.

       Comprehensive documentation is available	in the GNOME Help Browser.

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

       Dialog options

       --calendar
	      Display calendar dialog

       --entry
	      Display text entry dialog

       --error
	      Display error dialog

       --file-selection
	      Display file selection dialog

       --info Display info dialog

       --list Display list dialog

       --notification
	      Display notification

       --progress
	      Display progress indication dialog

       --question
	      Display question dialog

       --text-info
	      Display text information dialog

       --warning
	      Display warning dialog

       --scale
	      Display scale dialog

       --color-selection
	      Display color selection dialog

       --password
	      Display password dialog

       --forms
	      Display forms dialog

       General options

       --title=TITLE
	      Set the dialog title

       --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',	'ques-
	      tion' or 'warning'

       --width=WIDTH
	      Set the dialog width

       --height=HEIGHT
	      Set the dialog height

       --timeout=TIMEOUT
	      Set the dialog timeout in	seconds

       Calendar	options

       --text=STRING
	      Set the dialog text

       --day=INT
	      Set the calendar day

       --month=INT
	      Set the calendar month

       --year=INT
	      Set the calendar year

       --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

       Text entry options

       --text=STRING
	      Set the dialog text

       --entry-text=STRING
	      Set the entry text

       --hide-text
	      Hide the entry text

       Error options

       --text=STRING
	      Set the dialog text

       --no-wrap
	      Do not enable text wrapping

       --no-markup
	      Do not enable pango markup

       File selection options

       --filename=FILENAME
	      Set the file or directory	to be selected by default

       --multiple
	      Allow selection of multiple filenames in file selection dialog

       --directory
	      Activate directory-only selection

       --save Activate save mode

       --separator=SEPARATOR
	      Specify separator	character when returning multiple filenames

       --confirm-overwrite
	      Confirm file selection if	filename already exists

       --file-filter=NAME | PATTERN1 PATTERN2
	      Sets a filename filter

       Info options

       --text=STRING
	      Set the dialog text

       --no-wrap
	      Do not enable text wrapping

       --no-markup
	      Do not enable pango markup

       List options

       --text=STRING
	      Set the dialog text

       --column=STRING
	      Set the column header

       --checklist
	      Use check	boxes for first	column

       --radiolist
	      Use radio	buttons	for first column

       --separator=STRING
	      Set output separator character

       --multiple
	      Allow multiple rows to be	selected

       --editable
	      Allow changes to text

       --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 col-
	      umns.

       --hide-column=NUMBER
	      Hide a specific column

       --hide-header
	      Hides the	column headers

       Notification options

       --text=STRING
	      Set the notification text

       --listen
	      Listen  for  commands  on	 stdin.	 Commands  include  'message',
	      'tooltip', 'icon', and 'visible' separated by a colon. For exam-
	      ple,  'message:  Hello  world',  'visible:  false',  or	'icon:
	      /path/to/icon'.  The  icon  command  also	accepts	the four stock
	      icon: 'error', 'info', 'question', and 'warning'

       Progress	options

       --text=STRING
	      Set the dialog text

       --percentage=INT
	      Set initial percentage

       --auto-close
	      Close dialog when	100% has been reached

       --auto-kill
	      Kill parent process if cancel button is pressed

       --pulsate
	      Pulsate progress bar

       --no-cancel
	      Hides the	cancel button

       Question	options

       --text=STRING
	      Set the dialog text

       --no-wrap
	      Do not enable text wrapping

       --no-markup
	      Do not enable pango markup

       --ok-label
	      Set the text of the OK button

       --cancel-label
	      Set the text of the cancel button

       Text options

       --filename=FILENAME
	      Open file

       --editable
	      Allow changes to text

       --checkbox=TEXT
	      Enable a checkbox	for use	like a 'I read and accept the terms.'

       --ok-label
	      Set the text of the OK button

       --cancel-label
	      Set the text of the cancel button

       Warning options

       --text=STRING
	      Set the dialog text

       --no-wrap
	      Do not enable text wrapping

       --no-markup
	      Do not enable pango markup

       Scale options

       --text=STRING
	      Set the dialog text

       --value=VALUE
	      Set initial value

       --min-value=VALUE
	      Set minimum value

       --max-value=VALUE
	      Set maximum value

       --step=VALUE
	      Set step size

       --print-partial
	      Print partial values

       --hide-value
	      Hide value

       Color selection options

       --color=VALUE
	      Set the initial color

       --show-palette
	      Show the palette

       Password	dialog options

       --username
	      Display the username field

       Forms dialog options

       --add-entry=FIELDNAME
	      Add a new	Entry in forms dialog

       --add-password=FIELDNAME
	      Add a new	Password Entry in forms	dialog

       --add-calendar=FIELDNAME
	      Add a new	Calendar in forms dialog

       --text=STRING
	      Set the dialog text

       --separator=STRING
	      Set output separator character

       --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

       Miscellaneous options

       -?, --help
	      Show summary of options.

       --about
	      Display an about dialog.

       --version
	      Show version of program.

       Also the	standard GTK+ options are accepted. For	more information about
       the GTK+	options, execute following command.

	      zenity --help-gtk

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.

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

	      zenity  --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.

	      zenity  --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	OK  is
       selected, and 1 (false) if Cancel is selected.

	      zenity   --question  --title  "Alert"  --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'  |	zenity --list --title "Search Results"
	      --text "Finding all header files.." --column "Files"

       Show a notification in the message tray

	      zenity --notification  --window-icon=update.png  --text  "System
	      update necessary!"

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

	      zenity --list --checklist	--column "Buy"	--column  "Item"  TRUE
	      Apples 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' | zenity	--progress --pulsate

AUTHOR
       Zenity was written by Glynn Foster <glynn.foster@sun.com>.

       This manual page	was written by Ross Burton <ross@burtonini.com>.

SEE ALSO
       gdialog(1), dialog(1)

				 December 2011			     ZENITY(1)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | ENVIRONMENT | EXAMPLES | AUTHOR | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=zenity&sektion=1&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help