ubuntuusers.de

ubuntuusers.deWikiZenity

Zenity

Dieser Artikel wurde für die folgenden Ubuntu-Versionen getestet:

Zum Verständnis dieses Artikels sind folgende Seiten hilfreich:

Wiki/Icons/terminal.png Wer kleine Shell-Skripte schreibt und nutzt, möchte Rückmeldungen oder Fragen in manchen Fällen auch optisch aufpeppen. Benutzerabfragen in einem eigenen Dialog anzuzeigen wäre da ein erster Schritt. Für GNOME bzw. GTK-Dialoge gibt es dafür das Programm Zenity {en}.

Für KDE bzw. Qt-Dialoge gibt es das Programm KDialog mit ähnlicher Funktionalität. Die Abspaltung (Fork) yad bietet dagegen erweiterte Möglichkeiten.

Installation

Zuerst muss folgendes Paket installiert [1] werden:

  • zenity

Wiki/Vorlagen/Installbutton/button.png mit apturl

Paketliste zum Kopieren:

sudo apt-get install zenity 

sudo aptitude install zenity 

Beispielskript

Anhand eines kleines Skriptes sollen die Möglichkeiten des Programms aufgezeigt werden. Das Beispielskript ist recht simpel aufgebaut: Es soll zuerst eine Warnung zum Programm angezeigt werden, dann wird vom Benutzer eine Texteingabe und eine Passworteingabe gefordert und alles am Ende wieder angezeigt. Die Quellcodezeilen sind nummeriert, um sie später besser erklären zu können.

Allgemeine Informationen

Zuvor ein paar allgemeine Informationen zur Shell-Programmierung: In der Regel reicht es in der ersten Zeile die Standardshell unter /bin/sh zu benutzen. Die if-then-Konstrukte werden benutzt, um festzustellen, ob der Benutzer auf "Abbrechen" bzw. "Nein" geklickt hat. Der Befehl "exit" beendet in so einem Fall das Skript. Ein "\n" in einer Textzeile sorgt für einen Zeilenumbruch. Die Variablenzuweisung mit "=" kann später per "$" wieder ausgelesen werden.

Damit die Skripte starten, muss man diese nach dem Speichern ausführbar machen [3].

Quellcode

Folgendes Skript gibt man (ohne Zeilennummern) in einem Editor [2] ein und speichert es an einen beliebigen Ort:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
#!/bin/bash

if ! zenity --warning --text "Dieses Programm ist eigentlich harmlos\!\nTrotzdem fortfahren?"; then
  exit;
fi

if ! NAME=$(zenity --entry --text "Bitte geben Sie Ihren Namen ein:" --title "Wer sind Sie?"); then
  exit;
fi

if ! PASS=$(zenity --entry --hide-text --text "Bitte geben Sie das Passwort ein:" --title "Und das Passwort?"); then
  exit;
fi

(
echo "25"; sleep 1
echo "# Statusmeldung 1"
echo "50"; sleep 1
echo "# Statusmeldung 2"
echo "100"
) | zenity --progress --text "Vorgang wird bearbeitet" --percentage=0

zenity --info --text "Ihr Name: $NAME\nIhr Passwort: $PASS" --title "Das Ergebnis!"

Erläuterungen

  • Zeile 3: Die Option --warning zeigt eine Warnung mit den Optionen "Ok" und "Abbrechen" an. Den angezeigten Text kann man immer mit der Option --text beeinflussen. Bei neueren Versionen bekommt man jedoch nur noch eine Warnung angezeigt. Dort muss die Option --question für einen Fragedialog genutzt werden.

  • Zeile 7: Die Option --entry zeigt ein Texteingabefeld mit den Optionen "Ok" und "Abbrechen" an.

  • Zeile 11: Dies zeigt wieder ein Texteingabefeld, die Option --hide-text verschlüsselt dabei aber die Eingabe durch Sternchen.

  • Zeilen 15-21: Es wird ein Fortschrittsbalken mit Startwert 0% angezeigt, dessen Prozentzahl wird in 25er Schritten hochgezählt und der Anzeigetext "Statusmeldung X" bei jedem Schritt verändert.

  • Zeile 23: Am Ende wird per --info ein Informationsfenster mit den eingegebenen Daten angezeigt.

Weitere Optionen

./zenity.png ./zenity1.png

Option Aktion
--info Information
--warning Warnung
--error Fehler
--question Frage
--notification Benachrichtungsfeld
--entry Texteingabe
--file-selection Dateiauswahl
--list Listenauswahl
--progress Fortschrittsanzeige
--scale Schieberegler
--password Passwort
--entry --hide-text Texteingabe mit verstecktem Text
--calendar Kalender

Dies ist natürlich nur ein Teil von dem, was Zenity kann. Genaueres erfährt man im Terminal per

zenity --help 

oder in der Manpage zu Zenity.

Programmumschalter

Öfters möchte man mit einem simplen Skript zwei gegenteilige Aktionen ausführen, z.B. ein Programm starten und beenden oder sich ins Internet ein- und wieder auswählen. Eine Lösungsmöglichkeit wären zwei getrennte Skripte, die das erledigen. Aus Platzgründen wäre es aber komfortabler, dies mit einem einzigen Icon (welches sich je nach Status verändert) im Panel zu erreichen.

Hinweis:

zenity --notify erzeugt mit aktuellen Versionen von zenity keine Panel-Icons mehr, sondern Benachrichtigungen, deren Verhalten von der Arbeitsumgebung abhängig ist. Der Programmumschalter funktioniert daher nicht unter allen Arbeitsumgebungen.

Grundgerüst erstellen

Das Skript wird in einem Editor [2] erstellt. Hier fügt man das Grundgerüst ein:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
#!/bin/bash
while(true)
do
   zenity --notification --window-icon=$HOME/.icons/status1.png
   # Befehl 1

   zenity --notification --window-icon=$HOME/.icons/status2.png
   # Befehl 2

done

Danach muss das Skript ausführbar gemacht werden [3].

Erklärung

Das Skript ist eine Endlosschleife, die zwischen zwei Stadien hin- und herschaltet. Zuerst wird zenity aufgerufen und präsentiert im Benachrichtigungsfeld des Panels das Icon status1.png. Klickt man auf dieses, wird Befehl 1 ausgeführt und sofort wieder zenity gestartet, dieses mal aber mit status2.png als Bild. Klickt man wieder darauf, wird Befehl 2 abgearbeitet und die Schleife fängt von vorne an. Dies stellt einen simplen Umschalter dar.

Befehle einfügen

Anstelle der beiden Kommentare muss man die Befehle (es sind natürlich auch mehrere Zeilen möglich) einfügen, die abgearbeitet werden sollen.

Icons wählen

Die Icons werden im versteckten Ordner .icons gespeichert. Die Wahl ist dabei willkürlich und kann nach Belieben geändert werden. In der Regel existiert der Ordner aber sowieso (falls man spezielle Icon-Themes installiert hat) und stört nicht einmal die Übersicht, da er versteckt ist.

Sinnvolle Icons sind z.B. simple rote und grüne Buttons: ./status_off.png ./status_on.png

Autostart

Die fertige Datei kann man dann bei der Anmeldung automatisch ausführen lassen [4].

Beispiele

Internet-Einwahl

Eine sehr gute Anwendung findet man, wenn man sich ins Internet einwählen möchte. Nicht jeder Benutzer möchte DSL sofort beim PC-Start laufen lassen, für ISDN-Benutzer kommt dies sowieso nicht in Frage. Voraussetzung ist, dass die Internetverbindung mit pppoeconf eingerichtet wurde und die automatische Einwahl natürlich nicht aktiviert ist. Der Provider heißt hier dsl-provider und muss ggf. angepasst werden.

Als Icons kann man die zwei Netzwerk-Bilder aus Ubuntu nehmen: ./dsl_stat_off.png ./dsl_stat_on.png

Nach dem Speichern beider Bilder im .icons-Ordner lautet das Skript dann:

1
2
3
4
5
6
7
8
#!/bin/bash
while(true)
do
   zenity --notification --window-icon=$HOME/.icons/dsl_stat_off.png
   pon dsl-provider
   zenity --notification --window-icon=$HOME/.icons/dsl_stat_on.png
   poff -a
done

Dieses dann z.B. als dsl-dial.sh speichern, ausführbar machen und im Autostart eintragen.

Zenity als Abfrage für dd-Backup nutzen

Mit diesem kleinen Script lassen sich die notwendigen Eingaben für das Erstellen eines Partitonsimage abfragen. Es ist besonders für unerfahrene Benutzer brauchbar, da es nahezu selbsterklärend ist.

1
2
3
4
5
6
7
8
#!/bin/bash
zenity --info --text "Im folgenden Auswahlfenster runterscrollen und das zu sichernde Laufwerk auswählen. Der Syntax lautet sdx.x" --title "Quelle"
cd / && cd /dev &&  Quelle=$(zenity --file-selection)
zenity --info --text "Jetzt wird der Ort ausgewählt, wohin das Image gespeichert werden soll" --title "Zielordner"
cd / && Ziel=$(zenity --file-selection --directory .)
zenity --info --text "Dateiname des Images festlegen. Das Image muss mit der Dateiendung .img (backup.img) gespeichert werden." --title "Imagename festlegen"
Dateiname=$(zenity --entry --title "Dateiname" --text "Beispiel: backup-sda1.img")
sudo dd if=$Quelle bs=1M of=$Ziel/$Dateiname & ddpid=$! ; while [ "$(ps -a | grep $ddpid)" ]; do sudo kill -SIGUSR1 $ddpid; sleep 5; done  

Nachdem man das Skript auf dem Rechner gespeichert hat,z.B. als backup, muss man es noch ausführbar machen.

Grafische Passwort Abfrage mit Zenity

Das Dialog-Programm Zenity (Gnome, Xfce) bietet eine Möglichkeit, das sudo-Passwort grafisch zu erfragen. Hier wird das Passwort in eine Variabele PASSW zwischen gespeichert und per Pipe an sudo übergeben. Im unteren Beispiel wird eine Samba-Freigabe per Skript gemountet. Hierbei ist zu beachten, dass das Passwort für sudo und für dem Samba Login gleich sein muss. Dieses Skript kann zum Beispiel per benutzerdefiniertem Anwendungsstarter im Gnome Panel ausgeführt werden.

1
2
3
4
5
#! /bin/bash
PASSW=$(zenity --entry --hide-text --text "Bitte Passwort eingeben:" --title "SMB/CIFS Passwort?")
echo -e "$PASSW\n" | sudo -S -s -- mount -t cifs //meinServer/smbQuelle /mnt/smbZiel -o iocharset=utf8 -o user=derUsername -o pass=$PASSW
PASSW=""
sudo -k

Fortschrittsanzeige

Mit Statusicon

Das Benachrichtigungsfeld kann auch über einen Dateideskriptor angesteuert werden. Damit Zenity auf Eingaben wartet, muss die Option --listen gesetzt werden. Dadurch kann man den Status einer länger dauernden Aktion, z.B. Herunter-/Hochladen von größeren Datenmengen oder das Konvertieren vieler Dateien, fortlaufend aktualisieren.

Quellcode

Das Skript wird in einem Editor [2] erstellt. Hier fügt man das Grundgerüst ein:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
#!/bin/bash
exec 3> >(zenity --notification --listen)

for datei in "$1"/*
do
  echo "tooltip:Aktionen für ${datei} werden durchgeführt" >&3
  #Befehle für aktuelle Datei abarbeiten
done

echo "message:Vorgang abgeschlossen" >&3

exec 3>&-

Erläuterungen

  • Zeile 2: Hier wird der Dateideskriptor 3 geöffnet und Zenity gestartet. Es kann auch ein anderer Dateideskriptor >=3 verwendet werden.

  • Zeilen 4-8: Für alle Dateien im Verzeichnis $1 werden die entsprechenden Befehle abgearbeitet. Zeile 7 muss natürlich durch die jeweiligen echten Befehle ersetzt werden.

  • Zeile 6: Der Tooltip für das Icon wird bei jedem Durchgang aktualisiert.

  • Zeile 10: Es wird eine Sprechblase unter dem Benachrichtigungsicon angezeigt.

  • Zeile 12: Der Dateideskriptor wird geschlossen und Zenity beendet.

Kommandos

Das Benachrichtigungsicon lässt sich über folgende Kommandos steuern. Das Format ist immer

<Kommando>:<Wert>

Option Aktion
icon Das anzuzeigende Icon. Als Wert gibt man den Pfad zum jeweiligen Icon an.
visible Soll das Icon angezeigt werden? Mögliche Werte sind true und false
tooltip Text des Tooltips
message Eine Sprechblase wird unterhalb des Icons angezeigt. Der anzuzeigende Text wird als Wert erwartet.

Mit Fenster

Quellcode

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
#!/bin/bash

exec 3> >(zenity --progress --title="Sicherung" --percentage=0 --auto-close --width=400)

echo "# Ermittle Dateien..." >&3
count=$(find ${1-.} | wc -l) # Anzahl der Dateien

IFS='
' # wegen Dateien mit Leerzeichen
i=0
for file in $(find ${1-.})
do
        i=$(($i+1));
        echo $(($i*100/$count)) >&3;
        if [ -d $file ]; then continue; fi #Verzeichnisse überspringen
        echo "# Datei '$file' wird gesichert..." >&3;
        echo "Datei '$file' wird gesichert...";
        # hier das einsetzen was mit der Datei gemacht werden soll.
done

echo Fertig.
exec 3>&-

Erläuterungen

  • Zenity wird geöffnet (Bedeutung der Optionen siehe Manpage)

  • find ${1-.} | wc -l: Die Anzahl der Dateien wird ermittelt, wegen der Fortschrittsanzeige und das Ergebnis $count zugewiesen

  • In einer Schleife werden alle Dateien durchgearbeitet ($IFS bestimmt, an welchen Zeichen eine neue Datei beginnt)

  • $(($i*100/$count)): Errechnung der Prozentzahl

  • echo "# Datei '$file' wird gesichert..." >&3;: Zahlen werden von Zenity als Prozentsatz interpretiert, # Text bestimmt den Anzeigetext

Diese Revision wurde am 13. November 2013 21:47 von diesch erstellt.
Die folgenden Schlagworte wurden dem Artikel zugewiesen: GNOME, System, Programmierung