kbiff"> ]> Kurt Granroth

<granroth@kde.org>

KBiff ist ein Email-Melder, er unterstützt MBOX (Unix Stil), Maildir (wie bei Qmail), MH, POP3, IMAP4 und NNTP Protokolle. Handbuch zu KBiff KBiff Email E-Mail Mailbox 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> 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. 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. KBiff läßt sich sehr einfach kompilieren: % ./configure % make % make install Sollten Probleme auftreten, bitte informieren sie den Autor: Autor. 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. 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. 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. Alle Einstellungen können über das Einstellungsmenü vorgenommen werden. Kommandozeilenparameter werden deshalb in der Regel nicht benötigt. 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. 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. Dieser Ordner enthält die allgemeinen Einstellungen für das ausgewählte Profil. Fünf Felder sind vorhanden: 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. 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. 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. 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. 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. In diesem Ordner läßt sich festlegen was geschieht wenn neue Nachrichten eintreffen. 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. 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. 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. 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. 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. 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. 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. 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). 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. Dieses Feld steht nur für IMAP4- und POP3-Protokolle zur Verfügung. Dieses Feld steht nur für IMAP4- und POP3-Protokolle zur Verfügung. Dieses Feld steht nur für IMAP4- und POP3-Protokolle zur Verfügung. 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. Dieser Knopf erzeugt ein Menü mit erweiterten Einstellungen. 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. 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. Normalerweise wird diese Option nicht benötigt. Ist Sie Ihnen nicht verständlich benötigen Sie sie wahrscheinlich nicht. 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. Informationen ü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ü wird angezeigt wenn das KBiff-Icon mit der rechten Maustaste angeklickt wird. 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. Ruft das Einstellungsmenü auf. Siehe Abschnitt "Einstellungen". Zeigt den Hilfetext an (dieses Dokument). 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. 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. Hält KBiff an, oder startet es wieder. Ist KBiff angehalten so überprüft es nicht mehr ob neue Nachrichten verfügbar sind. 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. 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". Sie können über das Einstellungsmenü ausgewählt werden. KBiff sucht nach den Icons im normalen KDE Icon-Pfad. Derzeit ist dies: tdedir()/share/apps/kbiff/toolbar tdedir()/share/toolbar tdedir()/share/icons tdedir()/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 "tdedir()" 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. 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. 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. 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. 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. 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: KBiff nicht verwenden. Anstatt des 'mbox'-Protokolls das 'file'-Protokoll verwenden (leider läßt sich dann nicht mehr ersehen wieviele neue Nachrichten eingegangen sind). Alle Postfächer von 'mbox' auf 'maildir' umstellen. '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 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. 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. KBiff wurde geschrieben von: Kurt Granroth Deutsche Übersetzung von Stefan Doll: <stefan@i-2000.com>