man zenity (Commandes) - display GTK+ dialogs


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
Display info dialog
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 columns.

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 --list --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 $HOME -name '*.ps' | zenity --progress --pulsate


Zenity was written by Glynn Foster <>.

This manual page was written by Ross Burton <>.