052-055 Zenity

KnOw-HOw
Zenity and KDialog
Adding graphic elements to your scripts with Zenity and KDialog
SHELL CLICK
www.sxc.hu
Zenity and KDialog let you integrate your scripts with the native KDE or
scripts will also need Zenity or KDialog.

It is a good idea to incorporate a test into
your script that checks for the presence
Gnome environment. BY KRISTIAN KISSLING
of Zenity or KDialog before invoking
their commands.
formation in the form of visual feedback,
full-blown GUI-based applicaThe simple Shell script in Listing 1 is a
and youll never need to type pathnames
tion is beautiful to behold, but a
good place to start. If you save the script
painstakingly; instead, you can use a
graphical interface is way more
as zenity, type chmod
graphical file browser.
trouble to create than a simple shell
u+x zenity to make
Zenity [1] is included
script. If you like the simplicity of scriptit executable, and
by default with the
ing, but you prefer a little more visual
then type ./zenity to
Gnome desktop in openfeedback, Zenity (for Gnome environlaunch, you should
SUSE, Ubuntu, and sevments) and KDialog (for KDE) are a pair
see a slider control as
eral other distros. KDiaof tools you should know about. These
in Figure 1. Because
log is often installed with
handy helpers let you integrate graphic
Figure 1: A slider lets users generthe dialog box does
the default KDE environdialog boxes into your scripts.
ate numbers graphically.
not have a name and
ment. If your distribution
Dialog boxes prompt users for input,
the text for the slider is missing, Zenity
does not include these tools, install the
display output, or just report progress on
uses standard labels.
kde4dialog or zenity package to get
a process. Zenity and KDialog also outTable 1 shows the different Zenity diastarted. If you write scripts for other
put error messages and general status inlog box types. The parameters that Zepeople, the computers that run those
Listing 1: Simple Zenity

Script
01 #!/bin/sh
02 zenity scale
52
ISSUE 99
Listing 2: Generating Numbers with a Slider

01 zenity scale title "Slider" text "Slide a little..." minvalue=1
maxvalue=10 value=5
FEBRuaRy 2009
Know-How
Zenity and KDialog
scale. A warning field

only supports text definitions and new lines, for example. Some types need to
be combined with other
commands to be effective.
The command
ls | zenity
kdialog yesno
"Show Directory"
Figure 2: Click Show Directory

to list the files.
The question appears

in a dialog box with
Yes and No buttons.
If you want to label
the field, add a title
(Figure 3):
kdialog title "Yes
nity uses to call them are on the left with

a picture of the dialog box next to it.
As you can see, the selection includes
input fields. Bash reads these fields
when you click OK; the entry field is an
example of this. To pass a numeric value
to Bash, use the slider (scale). The list
control lists information and supports
sorting if you click a field name.
A progress indicator is useful wherever you need to monitor progress; for
example, you could use one to show the
progress of a search. But Ill look at the
basics first.
To label a window, you generally want
to use the title keyword. Listing 2
shows how to let the user select a value
between 1 (minvalue=1) and 10
(maxvalue=10) and assign a default of
5 (value=5). This gives you a dialog
like that shown in Figure 1.
Of course, you can feed only a limited
number of parameters to a slider: man
zenity has a separate Scale Options section outlining the options that work with
to remove this file?"
list column
"Do you really want
lists the files in a directory

or No"
and sorts them alphabetiyesno "Do you U
cally when you click Show
really want to U
Directory (Figure 2).
remove this file?"
Although Zenity will
build interesting graphical
Figure 3: KDialog will quickly
In contrast to Zenity,
menus for you, it does not
KDialog complains
set up a Yes/No dialog.
take the task of designing
ifyou just type
program logic off your hands. Therefore,
kdialog yesno without adding text the
you need an If condition to tell the script
program does not generate default lawhat to do when you click Yes or No. In
bels.
general, Zenity and KDialog define two
If you enter text in a field, it is typiinternal return values for dialog boxes: A
cally displayed on the console, which is
positive result (Yes) returns 0 and a negthe standard output device, but you also
ative result (No) returns 1. A third result
can pipe the output into a file for ex such as Cancel from KDialog would
ample, file1.txt (Listing 3, line 1). Alterreturn 2. You can create conditional
natively, you can pass the results to a
statements by querying these return valvariable (Listing 3, lines 2 and 3).
ues.
In addition to the messages mentioned
here, the dontagain switch makes sure
On Top of KDE
that KDialog does not continually repeat
KDialog users can
follow a similar approach to create
graphical dialog
boxes. Table 2 shows
which commands
create which elements. KDialog has
a couple of additional dialogs that
Zenity does not
have. For example,
to have the user conFigure 4: The --passivepopup option lets you display a short mesfirm a file deletion,
sage so that the user sees the pop-up without losing the current
enter:
focus.
Listing 3: Passing the Results to a Variable

01
kdialog inputbox "Please enter any text here:" > file1.txt
02
variable=$(kdialog inputbox "Please enter more text here:")
03
echo $variable
Listing 4: Opening a Specific File Type

01
kdialog passivepopup "That really wasn't necessary..." 5
02
kdialog getopenfilename . " *.mp3 | MP3Dateien"
FEBRuary2009
ISSUE 99
53
KnOw-HOw
Zenity and KDialog
view in the KDialog manual [2] will help

you with the details.
The passivepopup option lets you display a short message to users. It pops up
a bubble in a dialog and tells the user
something (Figure 4). A number following the pop-up text specifies how long
you want the text to display (this is set
to five seconds in line 1 of Listing 4). A
/n sequence adds a line break to the dialog box text to keep it from spreading all
over the screen.
If you want to select a specific file on
disk, it makes sense to use the getopen
filename option to do so. This returns an
absolute pathname, such as /home/user/
song.mp3. Another very similar parameter, getopenurl, returns a URL, as in
file:/home/user/song.mp3. For example,
you can use this approach to open FTP
addresses. Their counterparts that save
files are getsavefilename and get
saveurl.
a question. This displays

a Do not show this
message again checkbox
on top of the Yes/No dialog.
kdialog dontagain
rememberfile:decision
yesno "Do you really
want to delete this
U
U
file?"
Figure 5: If you want the script to work on audio files only,
The rememberfile:
you should restrict the users selection options.
decision entry makes
sure that the dialog really does remem[Notification Messages]
ber your decision. KDialog creates a file
decision=yes
called rememberfile below ~/.kde/
share/config/ and stores your decision in
In this case, the script would autorethe decision variable as the following
spond Yes whenever this question is
test shows:
posed.
KDialog dialog boxes typically have a
couple more switches that Ill look at. If
$ cat ~/.kde/share/ U
you get stuck, man kdialog and the overconfig/rememberfile
Table 1: Zenity Dialog Box Types
--question
--progress
--notification
--calendar
--info
--warning
--scale
--error
--entry
--list
54
ISSUE 99
--text-info
FEBRuaRy 2009
--file-selection
Zenity and KDialog
To open only specific file types such

as MP3-formatted tracks just add a descriptor to the command (Listing 4, line
2). KDialog shows the MP3 files entry as
a Filter (see Figure 5); if you delete the
pipe and the entry, you see the file suffix
instead.
After getopenfilename, you normally
pass in the path the dialog box opens
in this example, it was the current working directory. If you replace this entry
with :label1, the file manager will start

where you left it last time; that is, it remembers the last directory you used.
KnOw-HOw
convenience that you dont want to do

without the reassurance of visual feedback.
Conclusions
INFO
If you author scripts for other users, dialog boxes give them useful visual feedback especially if they are newcomers.
Finally, a word of warning: Dont be
surprised if you find yourself re-writing
working scripts and get so used to the
[1] Zenity manual: http://library.gnome.

org/users/zenity/stable/
[2] KDialog manual: http://techbase.kde.
org/index.php?title=Development/
Tutorials/Shell_Scripting_with_KDE_
Dialogs#Introduction_and_Scope
Table 2: KDialog Dialog Box Types
--msgbox
--warningyesno
--textbox
--progressbar
--inputbox
--getexistingdirectory
--combobox
--warningcontinuecancel
--menu
--passivepopup
--warningyesnocancel
--checklist
--getopenfilename
--sorry
--error
--yesno
--radiolist
--getsavefilename
--yesnocancel
FEBRuaRy 2009
ISSUE 99
55

052-055 Zenity

Uploaded by

Copyright:

Available Formats

052-055 Zenity

Uploaded by

Document Information

Original Description:

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

052-055 Zenity

Uploaded by

Copyright:

Available Formats

What are Zenity and KDialog and what can they be used for?

What are Zenity and KDialog and what can they be used for?

What are some common dialog box types that Zenity and KDialog support?

What are some common dialog box types that Zenity and KDialog support?

KnOw-HOw

Zenity and KDialog

Adding graphic elements to your scripts with Zenity and KDialog

scripts will also need Zenity or KDialog.

Listing 1: Simple Zenity

Listing 2: Generating Numbers with a Slider

Zenity and KDialog

scale. A warning field

Figure 2: Click Show Directory

The question appears

nity uses to call them are on the left with

to remove this file?"

"Do you really want

lists the files in a directory

Listing 3: Passing the Results to a Variable

Listing 4: Opening a Specific File Type

Zenity and KDialog

view in the KDialog manual [2] will help

a question. This displays

Figure 5: If you want the script to work on audio files only,

Table 1: Zenity Dialog Box Types

Zenity and KDialog

To open only specific file types such

with :label1, the file manager will start

convenience that you dont want to do

[1] Zenity manual: http://library.gnome.

Table 2: KDialog Dialog Box Types

You might also like

Pfad - The Proxy pFad of © 2024 Garber Painting. All rights reserved.