# Das Handbuch zu KBiff

## Einführung

### Funktionen

KBiff ist ein Email-Melder fürs KDE-Projekt, er zeigt mittels akustischer oder optischer Signale eingehende Email an. Er hat einige Vorteile gegenüber konkurrierenden Programmen:

- Konfiguration über die graphische Benutzeroberfläche. Kommandozeilenparameter und Konfigurations-Dateien werden nicht mehr benötigt. Alle Einstellungen können über das Menü "Einrichten" vorgenommen werden. (Es ist aber möglich einige Funktionen über Kommandozeilenparameter zu aktivieren.)

- Sitzungsorientiert. KBiff started automatisch mit der Konfiguration der letzten Sitzung.

- Andocken. KBiff kann einfach an die Kontrolleiste angedockt werden. Das ist besonders nützlich wenn mehrere Postfächer überwacht werden sollen und spart Platz auf der Arbeitsfläche.

- Bewegte GIFs. Es möglich bewegte (=animierte) GIFs als Icons zu verwenden.

- Musik. KBiff kann .wav Dateien abspielen wenn neue Post eintrifft.

- POP3, IMAP4, NNTP, Maildir, MBOX, MH. KBiff unterstützt alle verbreiteten Protokolle.

- Mehrere Postfächer. KBiff kann gleichzeitig mehrere Postfächer verwalten.

- Sonstiges. KBiff bietet noch viele zusätzliche Funktionen.

Bitte wenden Sie sich, mit Kommentaren und Vorschlägen für weitere Funktionen, direkt an mich.

Kurt Granroth

<granroth@kde.org>

## Installation

### Wie man KBiff erhält

Die neueste Version (als Quellcode und als Binärformat) findet sich immer auf der KBiff Webseite: http://www.granroth.org/kbiff KBiff ist auch Teil des KDE Network Pakets, die neueste Version kann daher auch im CVS-Archiv gefunden werden.

### Voraussetzungen

Um KBiff zu kompilieren wird KDE Version 1.0 oder höher benötigt. Alle notwendigen Bibliotheken finden sich hier: ftp://ftp.kde.org/pub/kde.

### Kompilieren und Installieren

KBiff läßt sich sehr einfach kompilieren:

    % ./configure
    % make
    % make install

Sollten Probleme auftreten, bitte informieren sie den Autor: Autor.

## Benutzung von KBiff

Nahezu alle Funktionen lassen sich über den Dialog "Einstellungen" konfigurieren. Einige Kommandozeilenparameter sind vorhanden - das dient der Bequemlichkeit, denn für manches macht die Kontrolle über Kommandozeile mehr Sinn.

### "Profil"

KBiff arbeitet mit sogenannten Profilen. Das sind Konfigurationen die einem oder mehreren Postfächern zugeordnet sind. Per Voreinstellung ist ein Profil "Inbox" vorhanden (der Name läßt sich ändern). Dieses Profil enthält ein Postfach, üblicherweise in der Form "/var/mail/benutzername", es könnte aber auch mehrere Postfächer enthalten. Es ist möglich KBiff mehrmals (mit unterschiedlichen Profilen aufzurufen). Jedem KBiff-Icon ist dann genau ein Profil zugeordnet.

### Kommandozeilenparameter

KBiff versteht drei Kommandozeilenparameter: profile (=Profil), debug (=Fehlersuche), und secure (=sicher).

    -profile <Profil_Name> Der Dialog "Einstellungen wird übersprungen und
    KBiff started direkt mit dem angegebenen Profil. (Bsp: 'kbiff -profile Inbox')

    -debug    Aktiviert ausführliche Status- und Fehlermeldungen. Nur sinnvoll
              wenn Probleme mit KBiff auftreten.

    -secure   Deaktiviert das Einstellungsmenü. Das kann nützlich sein wenn Sie
              KBiff anzeigen wollen, anderen Benutzern aber nicht die Möglichkeit
              geben wollen die Einstellungen zu ändern.

## Einstellungsmenü

Alle Einstellungen können über das Einstellungsmenü vorgenommen werden. Kommandozeilenparameter werden deshalb in der Regel nicht benötigt.

### Profilname

Der obere Teil des Einstellungsmenüs besteht aus einer Auswahlliste und drei Knöpfen. Ein Profil ist ein Satz von Einstellungen für ein Postfach die unter einem Namen zusammengefaßt sind. Die drei Knöpfe "Neu", "Umbenennen" und "Löschen" beziehen sich auf lediglich auf Profile, die eigentlichen Postfächer bleiben unbehelligt. Beim ersten Start von KBiff wird automatisch das Profil "Inbox" erzeugt. Dieses überwacht das System-Postfach.

### Einstellungsmenü

Das Einstellungsmenü hat vier Ordner. Die Einstellung beziehen sich auf das gerade ausgewählte Profil, es gibt keine Einstellungen die für alle Profile gültig sind.

#### Allgemein

Dieser Ordner enthält die allgemeinen Einstellungen für das ausgewählte Profil. Fünf Felder sind vorhanden:

##### Prüfintervall

Dieses Feld legt fest, wie häufig KBiff das Postfach überprüft. Die Zeit zwischen Abfragen wird in Sekunden angegeben, die Voreinstellung ist 60 Sekunden.

Das geeignetste Prüfintervall hängt davon ab, in häufig neue Mail eintrifft. Wird etwa `fetchmail` eingesetzt um alle 5 Minuten Email abzuholen, dann braucht das Prüfintervall nicht kürzer zu sein. Wird aber POP3 oder IMAP4 verwendet, dann ist sinnvoll ein längeres Intervall zu wählen. Ein Intervall unterhalb von 60 Sekunden kann problematisch sein falls Ihre Netzwerkanbindung nicht schnell genug ist.

##### EMail-Programm

Dieses Feld bestimmt welches Programm ausgeführt wird wenn KBiff angeklickt wird. Normalerweise ist das ein Email-Programm, im Prinzip kann es aber ein beliebiges X-Window Programm sein. Es ist nicht möglich einfach nur `elm` einzutragen (da kein X-Window Programm) aber `konsole -e elm` funktioniert. Die Voreinstellung ist `kmail -check`.

##### An Kontrolleiste andocken

Wird diese Option ausgewählt (Voreinstellung) so startet KBiff angedockt an der Kontrolleiste. Es ist aber möglich KBiff später wieder aus der Kontrolleiste auszuklinken.

##### Benutze Sitzungs-Management

Diese Option bestimmt ob Sitzungs-Management verwendet wird. Normalerweise sollte das eingeschaltet bleiben. Nützlich ist diese Option wenn KDE mit dem gleichen Benutzerkonto auf mehreren Rechnern verwendet wird. Dann ist es wahrscheinlich sinnvoll das Sitzungs-Management abzuschalten und statt dessen den `-profile` Kommandozeilenparameter zu verwenden.

##### Symbole

KBiff benutzt drei Symbole um die Zustände "Keine Mail", "Alte Mail" und "Neue Mail" anzuzeigen. Im Einrichtungsdialog werden die großformatigen Versionen dieser Symbole angezeigt. Diese Symbole lassen sich einfach ändern: durch Anklicken des Symbols wird ein Popup-Menü erzeugt, mit dem sich andere Symbole auswählen lassen. KBiff unterstützt bewegte GIFs, im Einrichtungsdialog werden diese aber nur unbewegt dargestellt.

#### Neue Mail

In diesem Ordner läßt sich festlegen was geschieht wenn neue Nachrichten eintreffen.

##### Startbefehl

Dieser Eintrag wird von einer Shell ausgeführt. Ein typisches Beispiel wäre der Eintrag "play newmail.au". Beim Eintreffen einer neuen Email würde dieses Kommando ausgeführt d.h. das Programm "play" würde die Audio-Datei "newmail.au" abspielen. In der Voreinstellung ist diese Option abgeschaltet.

##### Klang abspielen

Hier läßt sich eine Audio-Datei angeben, die abgespielt wird wenn neue Email eintrifft. In der aktuellen Version werden nur .wav-Dateien unterstützt. Die Audio-Datei muß mit dem vollen Pfadnamen angegeben werden. In der Voreinstellung ist diese Option abgeschaltet.

##### System-Ton

Wenn diese Option eingeschaltet ist erzeugt KBiff einen Piepston wenn neue Mail eintrifft. Diese Option ist wahrscheinlich die unaufdringlichste Methode auf neue Mail hinzuweisen. In der Voreinstellung ist diese Option eingeschaltet.

##### Benachrichtigen

Wenn diese Option eingeschaltet ist erzeugt KBiff ein Popup-Fenster wenn neue Mail eintrifft und zeigt an wieviele Nachrichten in welchen Postfächern eingegangen sind. Diese Option ist wahrscheinlich ungeeignet für Postfächer in denen sehr viele Emails eintreffen.

##### Floating Status

Ist diese Option eingeschaltet so zeigt KBiff eine Liste aller Postfächer zusammen mit der Anzahl der neuen Nachrichten in diesen Fächern an. Das sieht dann aus wie ein Tooltip.

#### Postfach

In diesem Ordner sind die Einstellungen der eigentlichen Postfächer untergebracht.

Jedes Postfach hat einen eigenen Satz von Einstellungen in diesem Ordner. Falls z.B. drei Postfächer zu diesem Profil gehören, dann müssen die Einstellungen in diesem Ordner dreimal (einmal für jedes Postfach) vorgenommen werden. Die Einstellungen in allen anderen Ordnern ist profilweit gültig, d.h. wenn die Option "Benachrichtigen" im Ordner "Neue Mail" eingeschaltet ist, so gilt sie für alle Postfächer dieses Profils.

##### Liste der Postfächer

Auf der linken Seite ist die Liste der Postfächer des aktuellen Profils untergebracht. Normalerweise ist nur ein Postfach (mit dem Namen "Default") aufgeführt, es ist aber möglich mehrere Postfächer im gleichen Profil zu verwalten.

Unterhalb der Liste sind zwei Knöpfe untergebracht. Der Knopf mit dem (amerikanischen) Briefkastensymbol erzeugt ein neues Postfach, der Knopf mit Kreuz löscht das gerade ausgewählte Postfach. Ein Postfach läßt sich nur umbennen indem ein neuer Eintrag (mit den gleichen Einstellungen) hinzugefügt, und der alte Eintrag gelöscht wird.

##### Protokoll

Hier läßt sich das Protokoll für das ausgewählte Postfach einstellen. Es stehen vier Protokolle zur Verfügung: mbox (Unix Stil), maildir (Qmail), POP3, und IMAP4. Außerdem gibt es das Quasi-Protokoll "file" (=Datei) mit dem sich eine beliebige lokale Datei überwachen läßt. (Dabei werden die Dateiinformationen über den letzten Lesezugriff bzw. die letzte Änderung der Datei ausgewertet).

##### Postfach

Für das POP3-Protokoll steht dieses Feld nicht zur Verfügung, für anderen Protokolle wird hier der Pfadname zum Postfach eingetragen. Für "mbox" zeigt der Pfad auf eine Datei, für "maildir" und "IMAP4" zeigt er auf ein Verzeichnis.

##### Server

Dieses Feld steht nur für IMAP4- und POP3-Protokolle zur Verfügung.

##### Benutzer

Dieses Feld steht nur für IMAP4- und POP3-Protokolle zur Verfügung.

##### Paßwort

Dieses Feld steht nur für IMAP4- und POP3-Protokolle zur Verfügung.

##### Speichere Paßwort

Paßwort für die nächste Sitzung speichern.

KBiff speichert das Paßwort unverschlüsselt! Zwar wird es nicht im Klartext gespeichert, es ist aber trivial mit Hilfe des KBiff-Quelltexts oder auch nur mit etwas Geduld das Paßwort zu dekodieren. In einem ungeschützten Netzwork sollte diese Option besser ausgeschaltet werden.

##### Erweiterte Optionen

Dieser Knopf erzeugt ein Menü mit erweiterten Einstellungen.

###### Postfach URL (=Uniform Resource Locator = Universelle Dokument-Adresse)

KBiff verwaltet Postfächer als URL. Wenn Sie sich gut mit KBiff auskennen, so können Sie dir URL hier ändern. Allgemein wird das aber nicht empfohlen.

###### Port

Hier läßt sich der Netzwerk-Port des Mailservers einstellen. Normalerweise ist das 110 für das POP3-Format und 143 für das IMAP-Format.

###### PREAUTH

Normalerweise wird diese Option nicht benötigt. Ist Sie Ihnen nicht verständlich benötigen Sie sie wahrscheinlich nicht.

###### Verbindung halten

Für POP3 und IMAP4 Formate. Wenn diese Option eingeschaltet ist, dann wird die Verbindung von KBiff zum Mailserver aufrechterhalten. KBiff loggt sich einmal ein und bleibt dann eingeloggt. Das Beschleunigt den Zugriff, ist aber nicht zu empfehlen wenn der Mailserver nur einem Programm zur gleichen Zeit den Zugriff ermöglicht. Das bedeutet dann nämlich, daß ihr Mailprogramm nicht mehr an das Postfach herankommt.

#### Über

Informationen über KBiff.

##### Über KBiff

Informationen über die verwendete Version von KBiff und Kontaktinformation des Programmautors.

Die Email-Adresse läßt sich anklicken wenn die Variable `MAILER` korrekt eingestellt ist, KBiff ruft dann ein Email-Programm auf mit dem man dann eine Email an den KBiff-Autor senden kann.

Wird die Variable `MAILER` so gesetzt (in csh): `% setenv MAILER "konsole -e mutt"` dann verwendet KBiff `konsole -e mutt` um das Email-Programm aufzurufen.

## Das Popup-Menü

Das Popup-Menü wird angezeigt wenn das KBiff-Icon mit der rechten Maustaste angeklickt wird.

### (An)docken

Hier läßt sich einstellen ob KBiff ans Panel angedockt werden soll. Dies funktioniert nur mit Fenster-Managern die KDE kompatibel sind, wie etwa KWM.

Die Voreinstellung läßt sich über das Einstellungsmenü wählen.

### Einstellungen

Ruft das Einstellungsmenü auf. Siehe Abschnitt "Einstellungen".

### Hilfe

Zeigt den Hilfetext an (dieses Dokument).

### Nach Mail sehen

Diese Option veranlaßt KBiff sofort festzustellen ob neue Nachrichten vorhanden sind anstatt auf das nächste Abfrageintervall zu warten. Dabei werden alle Postfächer des Profils überprüft.

### Jetzt Mail lesen

Wird diese Aktion ausgewählt, so markiert KBiff alle Nachrichten auf dem POP3- oder IMAP4-Server als "gelesen". Das kann nützlich sein, wenn Sie die auf dem Server vorhandene Mail nicht sofort laden möchten, aber dennoch bei weiterer Mail benachrichtigt werden wollen.

### Stop/Start

Hält KBiff an, oder startet es wieder. Ist KBiff angehalten so überprüft es nicht mehr ob neue Nachrichten verfügbar sind.

## Fragen, Antworten, und Tips

### Gibt es auch andere Mail-Wächter für KDE?

Ja, dem Autor sind zwei weitere Mail-Wächter bekannt. Der Erste war KOrn, er eignet sich besonders um mehrere Postfächer gleichzeitig zu überwachen. Es zeigt dabei auch die Anzahl der neuen Mails in jedem Postfach an. Eine weitere Alternative ist KNewMail. Er ist dem Windows-Programm NewMail nachgebildet. Er arbeitet mit dem POP3-Protokoll und zeigt die "Betreff"-Zeile der neuen Mails an.

### Was genau ist der Unterschied zwischen einem Profil und einem Postfach?

Ein Profil umfaßt die Einstellungen für eine Gruppe von Postfächern, es ist aber möglich das diese Gruppe aus nur einem einzigen Postfach besteht.

Ein typisches Beispiel für ein Postfach ist "/usr/var/username".

### Wie lassen sich die Icons für KBiff auswählen?

Sie können über das Einstellungsmenü ausgewählt werden.

KBiff sucht nach den Icons im normalen KDE Icon-Pfad. Derzeit ist dies:

    kdedir()/share/apps/kbiff/toolbar
    kdedir()/share/toolbar
    kdedir()/share/icons
    kdedir()/share/apps/kbiff/pics
    $HOME/.kde/share/apps/kbiff/toolbar
    $HOME/.kde/share/toolbar
    $HOME/.kde/share/icons
    $HOME/.kde/share/apps/kbiff/pics

Üblicherweise steht "kdedir()" für "/opt/kde" und $HOME ist ihr "home directory" (= Heimatverzeichnis). Wenn Sie eigene Icons verwenden möchten, können Sie diese einfach in eines der genannten Verzeichnisse einfügen. Am besten geeignet ist `$HOME/.kde/share/apps/kbiff/pics`

Wenn Sie KBiff andocken möchten, so sollten sie eine 22x22 (oder kleinere) Version Ihres Icons haben. Der Name dieses verkleinerten Icons sollte aus dem Icon-Namen und dem Prefix "mini-" bestehen.

Möglicherweise möchten Sie das Icon "oldmail.xpm" verwenden um das Vorhandensein alter Mail anzuzeigen (das ist die Voreinstellung). Andererseits möchten sie vielleicht für den gleichen Zweck das kleinere Icon "nettesbild.xpm" verwenden wenn KBiff angedockt ist. Das ließe sich nur realisieren wenn sie "nettesbild.xpm" in "mini-oldmail.xpm" umbennen.

KBiff verwendet das Icon, das für alte Mail verwendet wird, als Größenreferenz. Es stellt seine Größe entsprechend ein. Daher sollten die Icons ungefähr die gleiche Größe besitzen.

### Wie läßt sich elm (oder mutt oder PINE) mit KBiff verwenden?

Es ist leider nicht möglich einfach "elm" in das Eingabefeld für das Email-Programm einzugeben. Programme wie "elm", "mutt" und "PINE" müssen in einem Terminalfenster gestartet werden. Der Autor verwendet diesen Eintrag um "mutt" als Email-Programm zu starten: `konsole -vt_geometry 80x35 -caption Mail -no_scrollbar -e mutt &`

Für graphische Email-Programme wie KMail wird kein Terminalfenster benötigt und der Name des Programms kann direkt ins Eingabefeld eingetragen werden.

### Warum werden manche Audiodateien nicht abgespielt?

KBiff verwendet die Klasse "KAudio" um Musikdateien abzuspielen. Diese Klasse unterstützt derzeit aber ausschliesslich das ".wav"-Format. Man kann aber z.B. das SOX-Paket installieren und dann 'play newmail.au' (oder 'cat newmail.au > /dev/audio') in das Feld "Startbefehl" eintragen.

### Ist es möglich KBiff ohne Sitzungs-Management zu verwenden?

Die Voreinstellung aktiviert das Sitzungs-Management, es ist aber möglich das abzustellen. KBiff kann weiterhin automatisch gestartet werden wenn Sie es in Ihr Autostart-Verzeichnis aufnehmen und die Option '-profile' angeben.

### Die Email-Adresse des Autors (im Eintrag "Über") läßt sich nicht anklicken.

Leider ist diese Funktion noch nicht vollständig implementiert. Wenn die Umgebungsvariable "MAILER" korrekt gesetzt ist, sollte es funktionieren.

    z.B.:
    % setenv MAILER konsole -e mutt

Wird diese Variable so gesetzt, so verwendet kfm für 'mailto:'-Links gleichfalls das entsprechende Mail-Programm.

### Andere Email-Wächter funktionieren nicht mehr wenn KBiff verwendet wird.

KBiff öffnet das Postfach um festzustellen wieviele neue Nachrichten vorhanden sind. Die meisten Email-Wächter werden dies als Lesezugriff interpretieren, und die Mails im Postfach als "gelesen" klassifizieren.

Es gibt drei Lösungsmöglichkeiten:

1. KBiff nicht verwenden.

2. Anstatt des 'mbox'-Protokolls das 'file'-Protokoll verwenden (leider läßt sich dann nicht mehr ersehen wieviele neue Nachrichten eingegangen sind).

3. Alle Postfächer von 'mbox' auf 'maildir' umstellen.

### Kann KBiff mit Netscape-Mail zusammenarbeiten?

'netscape -mail' einzutragen reicht leider nicht aus. Hier ist die Lösung (vorgeschlagen bei Steven Boger (sboger@marcus-online.net) ).

Zunächst wird dieses Shellscript benötigt:

`#!/bin/sh`

    if [ -L "$HOME/.netscape/lock" ];
    then
    netscape -remote 'xfeDoCommand(openInbox)'
    else
    netscape -mail &
    fi

### KBiff schneidet den ersten "/" im IMAP Mode ab. Ist das ein Bug?

Nein, daß ist kein Problem. Normalerweise wird mit IMAP kein absoluter Pfad verwendet, praktisch alle Postfächer können (und werden) über relative Pfadnamen oder symbolische Links wie 'inbox angesprochen.

Wenn Sie beispielsweise auf `/var/spool/mail/username` zugreifen wollen geht das in der Regel in dem Sie `inbox` als Postfachnamen benutzen.

### Vorschläge für neue Funktionen

Wenn Sie einen Vorschlag für eine neue Funktion haben, bitte konsultieren Sie zunächst die TODO-Datei der Quelltext-Distribution oder die KBiff Webseite. Sollte Ihre Idee bereits eingetragen sein, bitte haben Sie Geduld, sie könnte schon bald implementiert werden. Ist sie noch nicht aufgeführt so senden Sie sie bitte per Email an den Autor. Der Autor kann aber nicht garantieren daß Ihre Idee in KBiff integriert wird.

## Autoren und Übersetzer

KBiff wurde geschrieben von: Kurt Granroth

Deutsche Übersetzung von Stefan Doll: <stefan@i-2000.com>