ZENITY(1)                                                            ZENITY(1)


       zenity - display GTK+ dialogs


       zenity [options]


       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 or 1, depending  on
       whether  the  user  pressed OK or Cancel. 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,
       under GNOME/Utilities.


       This  program  follows  the  usual  GNU  command line syntax, with long
       options starting with two dashes (‘-’).

       Dialog options

              Display calendar dialog

              Display text entry dialog

              Display error dialog

              Display file selection dialog

       --info Display info dialog

       --list Display list dialog

              Display notification icon

              Display progress indication dialog

              Display question dialog

              Display text information dialog

              Display warning dialog

       General options

              Set the dialog title

              Set the window icon

              Set the dialog width

              Set the dialog height

       Calendar options

              Set the dialog text

              Set the calendar day

              Set the calendar month

              Set the calendar year

              Set the format for the returned date

       Text entry options

              Set the dialog text

              Set the entry text

              Hide the entry text

       Error options

              Set the dialog text

       File selection options

              Set the filename

              Allow selection of multiple filenames in file selection dialog

              Specify separator character when returning multiple filenames

       Info options

              Set the dialog text

       List options

              Set the dialog text

              Set the column header

              Use check boxes for first column

              Use radio buttons for first column

              Set output separator character

              Allow changes to text

              Specify what column to print to standard output. The default  is
              to  return  the  first  column.  ’ALL’  may be used to print all

       Notification options

              Set the notification text

       Progress options

              Set the dialog text

              Set initial percentage

              Close dialog when 100% has been reached

              Pulsate progress bar

              Question options

              Set the dialog text

       Text options

              Open file

              Allow changes to text

       Warning options

              Set the dialog text

       Miscellaneous options

       -?, --help
              Show summary of options.

              Display an about dialog.

              Show version of program.

       Also the standard GTK+ options are accepted.


       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
       Select the host you would like  to  flood-ping.  The  entered  text  is
       returned 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  --title  "Search  Results"  --text
              "Finding all header files.." --column "Files"

       Show an icon in the notification area

              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 ‘echo $HOME‘ ’*.ps’ | zenity --progress --pulsate


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

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


       gdialog(1), dialog(1)

                              February 1st, 2003                     ZENITY(1)

Man(1) output converted with man2html