Neues Tuxmail-Plugin, um Mails auch auf dem TV lesen und schreiben zu knnen
============================================================================

Da die Erweiterung, mit der Box auch Emails lesen und schreiben zu knnen,
von robspr1 jetzt zwar ins CVS eingeflossen ist, aber noch keine Images
erstellt wurden, in denen die neueste Version des Tuxmail-Plugin eingebaut ist,
habe ich jetzt mal eine Anleitung verfasst, wie man das neue Tuxmail-Plugin
in den verschiedenen Imagetypen installiert.

Besonderheit:
-------------
Mit dem neuen Tuxmail-Plugin knnen jetzt Textmails und HTML-Mails direkt auf
der Box gelesen werden, ohne da sie vom Mailserver gelscht werden. Das Lschen
der Mails von der Box aus, mu explizit ausgelst werden. Dadurch bin ich vor
kurzem 3x von einem Virus verschont worden, ohne diesen auf den Rechner zu laden.
Man kann verdchtige Mails vorher lesen und identifizieren, ohne da sie Schaden
auf dem Rechner anrichten. Auch beim Lschen und Identifizieren von Spammails
leistet das Plugin eine wertvolle Hilfe. Inzwischen ist auch das Schreiben von
Emails mglich.

Version: 01.11.2005
-------------------

Tuxmail-Plugin: P1.38
Tuxmail-Dmon:  D1.31

Authoren:   Thomas 'LazyT' Loewe
---------   Robert 'robspr1' Spreitzer


Dateien im Archiv:
------------------

Box         Dateiname               Rechte  Erklrung
_____________________________________________________________________________________________________________________

Dbox:       tuxmaild                (755)   Tuxmail-Dmon fr Dbox
-----       tuxmail.so              (755)   Tuxmail-Plugin fr Dbox
            tuxmail.cfg             (644)   Tuxmail-CFG fr Dbox
            init.local              (755)   Fr JtG-Image-User (hierzu wichtig(JtG-Image).txt beachten!!!
            rcS.local               (755)   Fr Yadi-Image-User (hierzu wichtig(Yadi-Image).txt beachten!!!
            tuxmail.01              (644)   Beispieltextdatei ( von tuxmail.01 bis tuxmail.99 mglich.
            tuxmail.addr            (644)   Beispieladressenliste
            standby.on              (755)   Stoppt die Mailabfrage beim Einschalten des Standy-Modus (Neutrino)
            standby.off             (755)   Schaltet Tuxmail-Plugin wieder ein bei Aufwachen der Box aus Standby (Neutrino)
            enigma_enter_standby.sh (755)   Stoppt die Mailabfrage beim Einschalten des Standy-Modus (Enigma)
            enigma_leave_standby.sh (755)   Schaltet Tuxmail-Plugin wieder ein bei Aufwachen der Box aus Standby (Enigma)
            readme.txt                      Diese Anleitung

Dreambox:   tuxmaild                (755)   Tuxmail-Dmon fr Dreambox
---------   tuxmail.so              (755)   Tuxmail-Plugin fr Dreambox
            tuxmail.cfg             (644)   Tuxmail-CFG fr Dreambox
            enigma_enter_standby.sh (755)   Stoppt die Mailabfrage beim Einschalten des Standy-Modus (Enigma)
            enigma_leave_standby.sh (755)   Schaltet Tuxmail-Plugin wieder ein bei Aufwachen der Box aus Standby (Enigma)
            tuxmail.wav             (644)   Sounddatei fr die akustische Benachrichtigung, da neue
                                            Nachrichten da sind. Nur fr Firmware bis 1.09 erforderlich.
            tuxmail.01              (644)   Beispieltextdatei (von tuxmail.01 bis tuxmail.99 mglich).
            tuxmail.addr            (644)   Beispieladressenliste

Sourcecodes:    Die Sourcecodes sind jetzt im CVS eingecheckt worden
------------


Format der tuxmail.conf
-----------------------

Die tuxmail.conf mu wird beim ersten Start von tuxmaild automatisch erstellt. 
Nachdem sie erstellt wurde, ist sie dann anzupassen.
Alle nderungen mssen mit einem Linux fhigen Editor, z.B.
Ultraedit, Crimson-Editor, vi, etc. gemacht werden.

Eintrag     Bedeutung                                                       mgliche Werte      Standardwert
____________________________________________________________________________________________________________________

STARTDELAY  Wartezeit bis der Daemon mit der ersten Kontenabfrage beginnt
            (die GUI bentigt einige Zeit zum starten)                      15...60             30 Sekunden
INTERVALL   Abstand zwischen den Kontenabfragen                             5...60              15 Minuten
LOGGING     Protokoll der Serververbindung speichern (/tmp/tuxmaild.log)    Y / N               Y
LOGMODE     Protokollmodus (letzte Sitzung / alle Sitzungen)                S / A               S
SAVEDB      Mail-DB beim Beenden sichern / Starten wiederherstellen         Y / N               Y
AUDIO       akustische Signalisierung                                       Y / N               Y
            (Eine benutzerdefinierte 12/24/48KHz PCM Wave-Datei kann
            unter /var/tuxbox/config/tuxmail/tuxmail.wav abgelegt werden.)
VIDEO       optische Signalisierung                                         1 = Plugin starten  1
            (Message: muss per Fernbedienung besttigt werden)              2 = Enigma Popup
            (Popup: wird nach einiger Zeit automatisch geschlossen)         3 = Neutrino Message
                                                                            4 = Neutrino Popup
                                                                            5 = keine Signalisierung
LCD         Anzeige des Mailstatus durch den Daemon auf dem LCD             Y / N               Y
OSD         TV-Ausgaben in Deutsch oder Englisch                            G / E               G
SKIN        Farbpalette whlen (1=blau, 2=grau)                             1 / 2               1
ADMIN       Lschen von Mails erlauben / verbieten                          Y / N               Y
CONFIGCODE  Sicherheits-PIN (Zugriff auf Konfigurationsmen erst nach
            Eingabe mglich)                                                0000...9999         leer
MAILCACHE   Mails werden schon bei der Kontoabfrage gelesen und gesichert   0..99               0
            (0=kein Lesen)
MAILDIR     In welches Verzeichnis sollen die Mails gesichert werden        /directory/         /tmp/
SECURITY    Zeichenfolge die das Ausfhren einer Mail bewirkt
            Text ohne Leerzeichen von bis zu 64 Zeichen                                         leer
WEBPORT     Port des Webinterface der dbox                                  1 - 65535           80
WEBUSER     Benutzername fr das Webinterface der dbox Text ohne
            Leerzeichen von bis zu 32 Zeichen                                                   leer
WEBPASS     Passwort fr das Webinterface der dbox Text ohne Leerzeichen
            von bis zu 32 Zeichen                                                               leer
NAME?       angezeigter Name des Kontos im Plugin Text ohne Leerzeichen
            von bis zu 32 Zeichen                                                               leer
POP3?       Maileingangsserver Text ohne Leerzeichen von bis zu 64 Zeichen                      leer
USER?       Nutzername Text ohne Leerzeichen von bis zu 64 Zeichen                              leer
PASS?       Passwort (falls nicht erforderlich z.B. "-" eintragen)
            Text ohne Leerzeichen von bis zu 64 Zeichen                                         leer
SMTP?       Mailausgangsserver Text ohne Leerzeichen von bis zu 64 Zeichen                      leer
FROM?       Absender-Adresse Text ohne Leerzeichen von bis zu 64 Zeichen                        leer
CODE?       Sicherheits-PIN (Zugriff auf Konto erst nach Eingabe mglich,
            z.B. bei mehreren Familien-Mitgliedern)                         0000...9999         leer
AUTH?       Authentifizierungsmethode fr SMTP                              0: keine            0
                                                                            1: POP3 Parameter
                                                                            2: SUSER? und SPASS?
SUSER?      Nutzername fr SMTP
            Text ohne Leerzeichen von bis zu 64 Zeichen                                         leer
SPASS?      Passwort fr SMTP
            Text ohne Leerzeichen von bis zu 64 Zeichen                                         leer

____________________________________________________________________________________________________________________


Die Eintrge "STARTDELAY", "INTERVALL", "LOGGING", "LOGMODE", "SAVEDB", "AUDIO",
"VIDEO", "LCD", "OSD", "SKIN", "ADMIN", "CONFIGCODE" und "WEBxxxx" sind global,
d.h. diese Einstellungen gelten fr alle Konten und mssen somit nur einmal eingetragen werden.
WEBUSER und WEBPASS knnen leer gelassen werden, wenn das Webinterface keine Authorisation erfordert.

Fr das "?" bei "NAME", "POP3", "USER", "PASS", "SMTP", "FROM", "CODE", "SUSER" und "SPASS"  sind Werte von 0...9 mglich.
Bei weniger als 10 Konten knnen die entsprechenden Eintrge entfallen oder einfach leer gelassen werden.

Konfigurationsbeispiel "tuxmail.conf":
--------------------------------------

STARTDELAY=30
INTERVALL=15
LOGGING=Y
LOGMODE=S
SAVEDB=Y
AUDIO=Y
VIDEO=1
LCD=Y
OSD=G
SKIN=1
CONFIGCODE=1234
ADMIN=Y
MAILCACHE=10
MAILDIR=/tmp/
SECURITY=
WEBPORT=80
WEBUSER=
WEBPASS=
NAME0=Kontoname
POP30=Maileingangsserver
USER0=Kennung
PASS0=Passwort
SMTP0=Mailausgangsserver
FROM0=Absender
CODE0=1234
AUTH0=0
SUSER0=
SPASS0=



Anleitung um das neue Tuxmail-Plugin auf der Dbox zu installieren.
==================================================================

Diese Anleitung bezieht sich nur auf Neutrino.
Enigma- bzw. Dreambox User, knnen das neue Plugin jedoch ebenso nutzen,
mssen sich jedoch mangels Informationen meinerseits, selbst schlau machen,
wie das eingebaut wird.

Die Dateien entsprechend Ihrer Platzierung im Archiv in die ensprechenden
Verzeichnisse kopieren. Bitte hierzu die Dateien wichtig(JtGImage).txt fr
Jack the Grabbber-Images und wichtig(Yadi-Image).txt fr Yadi-Images beachten.

Benutzer von JFFS-Only Images z.B. DietmarW-Image
ersetzen einfach nur die Dateien tuxmaild in /bin/ und tuxmail.so in /lib/plugins/.


Benutzer von JTG- und Yadi-Images mssen alle Dateien kopieren, auer init.local fr
Yadi-Image-User und rcS.local fr JtG-Image-User.
Diese entsprechend der Anleitungen wichtig(JtGImage).txt und wichtig(Yadi-Image).txt
einbauen.


****************************************************************************************************************
Bei Yadi- und JtG-Images ab ca. Juni.2005 sind die nderungen in den init.local und rcS.local Dateien hinfllig.
****************************************************************************************************************

Ich bitte nochmals, die entsprechenden wichtig.txt Dateien zu beachten.

Nach der Installation ist die Box neu zu starten. Dann das Tuxmail-Plugin mit der
blauen Taste aufrufen, dort mit der Ausschalttaste den Autostart des Dmons
aktivieren. Dann die Box nochmals neu starten.

Optionale Dateien um Tuxmaild im Standby-Modus zu stoppen
---------------------------------------------------------

standby.on und standby.off nach /var/tuxbox/config kopieren.
Sollten diese schon vorhanden sein, nur die Inhalte rauskopieren
und in diese einfgen. Die Dateien mssen Ausfhrrechte (755)
besitzen. Dabei wird im Standby-Modus der Box die Uhr nicht
durch das Email-Plugin berschrieben, beim reaktivieren der
Box aus dem Standby wird das Email-Plugin automatisch wieder
gestartet.
Engima Nutzer mssen dafr die Dateien enigma_enter_standby.sh und
enigma_leave_standby.sh verwenden.

Bedienung des Tuxmail-Plugins:
******************************

Die blaue Taste fgt den Absender der Mail zur Spamliste hinzu, erneutes drcken
entfernt ihn wieder aus der Datei /var/tuxbox/config/tuxmail/spamlist.
Der Mailreader wird mit der gelben Taste aufgerufen.
Der Mailwriter wird mit der grnen Taste aufgerufen.
Die rote Taste lscht eine einzelne Mail.
Die Dbox-Taste ruft fr ein Konfigurationsmen auf.
Die Versionsanzeige wird mit der ?-Taste aufgerufen.
Die Zifferntasten rufen die einzelnen Mailkonten auf
Die Standby-Taste aktiviert/deaktiviert den Autostart.
Die Mute-Taste startet/stoppt die Kontenabfrage.
Rechts/Links-Taste blttert seitenweise.
Hoch/Runter-Taste scrollt zeilenweise auf die einzelnen Mails.
Die Home-Taste verlsst das Email-Plugin.


Im integrierten Mailreader wird folgendermassen navigiert:
----------------------------------------------------------

Mit der Pfeil nach rechts-Taste oder Pfeil nach unten-Taste wird nach unten geblttert.
Pfeil nach links-Taste oder Pfeil nach oben-Taste blttert nach oben.
Home-Taste verlsst den Reader und springt wieder ins Tuxmail-Auswhlfenster zurck.

Die ausgelesene Mail wird immer in /tmp/tuxmail.pop3 gespeichert.
Wenn die Cache-Option einschaltet wird, werden die Dateien als tuxmail.idx.0 bis maximal
tuxmail.idx.99 fr jedes eingerichtetete Mailkonto gespeichert.

Achtung:
--------
Wenn dies fr alle 10 Mailkonten mit der maximalen Auslastung gemacht wird, kommen maximal
1ooo Mails mit je bis zu 64 K Byte ins Cacheverzeichnis, macht 64 MB, da platzt dann unter
Umstnden Euer /tmp/ -Verzeichnis und die Box strzt ab. Niemals die Mails in irgendein
/var/ -Verzeichnis speichern, sonst geht das JFFS2- Verzeichnis hops, und Ihr msst ein neues
Komplettimage flashen. Auerdem schadet das stndige rumschreiben im /var/ dem Flashspeicher
Euer Box. Ihr knnt Eure Mails bei stndiger Verbindung mit einem gemounteten Laufwerk
natrlich auch dort speichern. Achtet aber auch hier darauf, da das Laufwerk nur ber
/mnt/ oder /tmp/ gemountet wird, und nicht ber /var/ sonst passiert bei einer fehlenden
Mountverbindung das gleiche und das JFFS2-Dateisystem wird korrupt. Ich empfehle, das ganze
im /tmp/ zu lassen und nicht zuviele Cache-Dateien einzuschalten. Die Cacheoption wird sowieso
nur von Usern bentigt, die ihr Konto nur innerhalb einer bestimmten Zeitspanne abfragen knnen,
z.B. bei GMX.

Im Mailwriter gelten folgende Tastenbelegungen:
-----------------------------------------------

Rote Taste ruft vorgefertigte Texte auf, diese mssen in /var/tuxbox/config/tuxmail/
eingebaut werden und die Bezeichnung mailtext.01 bis mailtext.99 haben. Mit Plus- und
Minus-Taste kann zwischen diesen, und dem zuletzt gelesenen Text geblttert werden.
Maximale Lnge 78 Zeichen und 9 Zeilen.

Grne Taste dient zu Eingaben ber ein T9-Wrterbuch, ( wie beim Handy )
diese Funktion ist momentan optional vorgesehen und funktioniert noch nicht.

Gelbe Taste dient zur normalen Texteingabe, die Belegungen stehen unten links.
Nochmaliges bettigen schaltet zwischen Gro-, nur erster Buchstaben nach entsprechenden
Satzzeichen (.!?) gro , oder Kleinschreibung oder Dbox-Tastatur um.

Mit der Pfeil nach oben-Taste kann man auf die Betreffszeile wechseln und diese ndern. Nochmal
Pfeil nach oben-Taste wechselt auf die Empfngeradresse. Diese kann dort manuell gendert
werden oder mit den Plus- und Minus-Tasten aus einer vorgefertigten Datei abgerufen werden.

Diese Datei namens tuxmail.addr mu im Linux-Format vorliegen und kommt nach
/var/tuxbox/config/tuxmail/ Die Adressen mssen dort zeilenweise eingeben werden.

Blaue Taste dient zum Einfgen, Mute-Taste zum Lschen von Zeichen.
Mit der OK-Taste wird die fertige Mail abgeschickt. Vor dem Absenden wird eine Abfrage gestartet,
ob die Mail abgeschickt werden soll. Entweder OK fr senden, oder Home zum verlassen drcken.
Home-Taste verlsst den Mailwriter und springt wieder ins Tuxmail-Auswhlfenster zurck.

DBox-Tastatur
-------------
Die Bedienung mit der Dbox-Tastatur wird in einem Fenster eingeblendet. 

Dazu bitte beachten!
--------------------

Manche SMTP-Mailserver akzeptieren nur die reine Email-Adresse ohne Namenszusatz.
Maximale Lnge der verschickten Emails 78 Zeichen und 9 Zeilen.

Debug-Hilfe:
------------

In /tmp/ wird eine Datei namens tuxmail.log abgespeichert. Dort werden alle Ereignisse
protokolliert. Bei Supportanfragen bitte diese kopieren und mit beifgen. Im Tuxmail-
Plugin die ?-Taste drcken und die Versionen von Tuxmail-Plugin und Dmon posten.

Fragen und Anregungen zu dem neuen Plugin werden hier beantwortet.
http://www.jackthegrabber.de/viewtopic.php?t=6798

Eine ausfhrliche Anleitung fr das Tuxmail-Plugin ist auf
http://wiki.tuxbox.org/Plugins:E-Mail
zu finden. Bitte die oben beschriebenen nderungen beachten.

********************************************************************************************
Vielen Dank an Thomas 'LazyT' Loewe fr das Tuxmail-Plugin und an Robert 'robspr1' Spreitzer
fr die Erweiterung des Tuxmail-Plugins, um Emails mit der Dbox2 und der Dreambox zu lesen
und zu schreiben.
********************************************************************************************

20.05.2005 Greetz von DrStoned :-) :-) :-)
Plugin-Moderator im Jack the Grabber-Forum und Beta-Tester des Email-Plugins