Mailbox-plugin

Aus VDR Wiki
(Unterschied zwischen Versionen)
Wechseln zu: Navigation, Suche
(→‎Beschreibung)
 
(64 dazwischenliegende Versionen von 38 Benutzern werden nicht angezeigt)
Zeile 2: Zeile 2:
 
'''Autor:''' Alexander Rieger
 
'''Autor:''' Alexander Rieger
  
−
Mailbox ist ein Plugin zum email lesen mehrerer IMAP-Accounts am OSD des VDR.
+
Mailbox ist ein Plugin zum Lesen von eMails. Unterstützt werden {{wikipedia|POP3}} und {{wikipedia|IMAP}} Postfächer.
 +
 
 
Zum Zugriff auf die Konten nutzt das Plugin die IMAP server c-client-library von Mark Crispin.
 
Zum Zugriff auf die Konten nutzt das Plugin die IMAP server c-client-library von Mark Crispin.
 
Da diese Bibliothek auch POP3 unterstützt können auch POP3 Accounts gelesen werden, POP3 Accounts werden jedoch nicht so gut unterstützt.
 
Da diese Bibliothek auch POP3 unterstützt können auch POP3 Accounts gelesen werden, POP3 Accounts werden jedoch nicht so gut unterstützt.
 +
 +
===Status===
 +
Letztes Update 03/2013
 +
  
 
==Bilder==
 
==Bilder==
−
[[Bild:mailbox-plugin.jpg|thumb|none|''Setup'']]
+
{|
 +
| [[Bild:mailbox-plugin-00.jpg|thumb|none|''Beschreibung'']]
 +
| [[Bild:mailbox-plugin-01.jpg|thumb|none|''Beschreibung'']]
 +
| [[Bild:mailbox-plugin-02.jpg|thumb|none|''Beschreibung'']]
 +
| [[Bild:mailbox-plugin-03.jpg|thumb|none|''Beschreibung'']]
 +
| [[Bild:mailbox-plugin-04.jpg|thumb|none|''Beschreibung'']]
 +
|-
 +
| [[Bild:mailbox-plugin-05.jpg|thumb|none|''Beschreibung'']]
 +
| [[Bild:mailbox-plugin-06.jpg|thumb|none|''Beschreibung'']]
 +
| [[Bild:mailbox-plugin-07.jpg|thumb|none|''Beschreibung'']]
 +
| [[Bild:mailbox-plugin-08.jpg|thumb|none|''Beschreibung'']]
 +
| [[Bild:mailbox-plugin-09.jpg|thumb|none|''Beschreibung'']]
 +
|-
 +
| [[Bild:mailbox-plugin-10.jpg|thumb|none|''Beschreibung'']]
 +
| [[Bild:mailbox-plugin-11.jpg|thumb|none|''Beschreibung'']]
 +
|}
  
−
==Hardwareanforderungen==
 
 
==Softwareanforderungen==
 
==Softwareanforderungen==
 
* openssl
 
* openssl
Zeile 16: Zeile 35:
  
 
==Installation==
 
==Installation==
−
Zur Software einfach mal in INSTALL des Plugins schauen, ist sehr Detaliert, und für jede Distribution ein anderer Weg. (würde hier jeden Rahmen sprengen). Deshalb nur via Source.
+
Vor dem Übersetzen des Plugins ist das Makefile zu ändern. ('''$SOURCEDIR''' anzupassen...)
  
−
  cd $SOURCEDIR
+
  IMAPDIR    ?= '''$SOURCEDIR'''/imap/c-client
−
tar xvzf openssl-<VERSION>.tar.gz
+
  IMAPINCDIR ?= $(IMAPDIR)
−
cd openssl-<VERSION>
+
  IMAPLFLAGS ?= $(IMAPDIR)/c-client.a -lssl -lpam
−
./config shared
+
−
make
+
−
make install
+
−
ldconfig
+
−
cd -
+
−
   
+
−
  tar xvzf Linux-PAM-<VERSION>.tar.gz
+
−
cd Linux-PAM-<VERSION>
+
−
./configure --prefix=/usr/local
+
−
make
+
−
make install
+
−
ldconfig
+
−
cd -
+
−
+
−
tar xvzf imap.tar.Z
+
−
mv imap-2004b imap
+
−
cd imap
+
  
−
Hier ist das Makefile anzupassen. Folgendes '''<port>''' steht fuer Portierung, im Kopf des Makefiles sind alle Distributionen aufgelistet.
+
Installieren der Bibliothek und Developer Dateien mit SSL Support
 +
apt-get install libc-client-ssl2001 libc-client-ssl2001-dev
  
−
<port>:   an
+
;libc-client-ssl2001:Wird für das Plugin benötigt.
−
        $(BUILD) BUILDTYPE=<port> \
+
;libc-client-ssl2001-dev:Wird zum kompilieren des Plugins benötigt!
−
-       SPECIALS="SSLDIR=/usr/share/ssl SSLINCLUDE=/usr/include/openssl SSLLIB=/usr/lib"
+
−
+      SPECIALS="SSLDIR=/usr/local/share/ssl SSLINCLUDE=/usr/local/include/openssl SSLLIB=/usr/local/lib"
+
  
−
Uebersetzen
+
Zum manuellem kompilieren des Plugin setze die folgenden Variablen im Makefile
 +
  IMAPINCDIR ?= /usr/include/c-client
 +
  IMAPLFLAGS ?= -lc-client -lssl
  
−
make <port>
+
==Konfiguration==
−
make
+
  
−
Vorm übersetzen des Plugins das selbe, wie gehabt Makefile ändern.
+
{{Box Warnung|
 +
Die Account werden im Klartext in der Datei 'plugins/mailbox' innerhalb des VDR Konfigurationsverzeichnis gespeichert. Diese Datei wird mit den Dateirechten 0x600 abgespeichert. Der Nutzer unter dessen Account VDR läuft, kann diese Datei also lesen.
  
−
- # IMAPDIR    ?= $SOURCEDIR/imap/c-client
+
Die email Account Passwörter werden in modifizierter Form in dieser Datei gespeichert, es gibt keine echte Verschlüsselung, lediglich das Lesen für zufällige Betrachter wird erschwert.}}
−
- # IMAPINCDIR ?= $(IMAPDIR)
+
−
- # IMAPLFLAGS ?= $(IMAPDIR)/c-client.a -lssl -lpam
+
−
+ IMAPDIR    ?= /usr/local/src/imap/c-client
+
−
+ IMAPINCDIR ?= $(IMAPDIR)
+
−
+ IMAPLFLAGS ?= $(IMAPDIR)/c-client.a -lssl -lpam
+
  
−
Alles andere ist auszukomentieren.
 
−
 
−
- IMAPINCDIR ?= /usr/include/imap
 
−
- IMAPLFLAGS ?= -lc-client -lssl -lpam
 
−
+ # IMAPINCDIR ?= /usr/include/imap
 
−
+ # IMAPLFLAGS ?= -lc-client -lssl -lpam
 
−
 
−
==Konfiguration==
 
−
 
−
vdr -P'mailbox -m /usr/local/bin/[[mailcmd.sh]]'
 
  
 
Zum Format der [[accounts.conf]].
 
Zum Format der [[accounts.conf]].
Zeile 75: Zeile 63:
 
Die Account-Einstellungen werden abgelegt in.
 
Die Account-Einstellungen werden abgelegt in.
  
−
  /etc/vdr/plugins/mailbox/[[accounts.conf]]
+
  [[Struktur|$VDRCONFIG]]/plugins/mailbox/[[accounts.conf]]
  
 
Diese wird automatisch generiert, wenn Du ein Konto angibst.
 
Diese wird automatisch generiert, wenn Du ein Konto angibst.
Zeile 81: Zeile 69:
 
Die Einstellungen kannst du aber auch händisch machen, indem Du eine Datei mit diesem Namen anlegst und folgendes für jedes Konto untereinander weg angibst.
 
Die Einstellungen kannst du aber auch händisch machen, indem Du eine Datei mit diesem Namen anlegst und folgendes für jedes Konto untereinander weg angibst.
  
 +
{{Box Datei| [[Struktur|$VDRCONFIG]]/plugins/mailbox/accounts.conf |
 
<pre>
 
<pre>
 
[Account]
 
[Account]
Zeile 86: Zeile 75:
 
   LoginName    = deinname                    # Mailbox- Zugangsname
 
   LoginName    = deinname                    # Mailbox- Zugangsname
 
   LoginPass    = deinpasswort                # Mailboxpasswort
 
   LoginPass    = deinpasswort                # Mailboxpasswort
−
   MailBox      = {pop.t-online.de/pop3/notls} # Beispiel (Klammern müssen sein! BEI IMAP : {imap.deinserver.de/imap/notls/norsh})
+
   MailBox      = {pop.t-online.de/pop3/notls} # Beispiel (Klammern müssen sein! BEI IMAP : {imap.deinserver.de/imap/notls/norsh}INBOX)
 
   AutoMarkSeen = 0                            # autom. als gelesen markieren 0-1
 
   AutoMarkSeen = 0                            # autom. als gelesen markieren 0-1
 
   Expunge      = 0                            # autom. ausf Server löschen 0-1
 
   Expunge      = 0                            # autom. ausf Server löschen 0-1
 +
 +
[Account]
 +
  AccountName    = IMAP-SSL
 +
  LoginName      = ********
 +
  LoginPass      = ********
 +
  MailBox        = {ImapSSL.server.de:993/imap/ssl/novalidate-cert}INBOX
 +
  AutoMarkSeen    = 0
 +
  Expunge        = 0
 +
 
</pre>
 
</pre>
 +
}}
  
−
==Parameter==
+
===Parameter===
−
{| border=1 cellpadding=2 cellspacing=0
+
{| class="wikitable"
−
|- bgcolor=#efefef
+
|-
 
!Parameter (kurz)
 
!Parameter (kurz)
 
!Parameter (lang)
 
!Parameter (lang)
 
!Beschreibung
 
!Beschreibung
 
|-
 
|-
−
| -m CMD || --mailcmd=CMD || CMD is called when the number of new mails changed
+
| -m [[mailcmd.sh]] || --mailcmd=[[mailcmd.sh]] || Skript, welches bei neuen M@ils aufgerufen werden soll.
−
|}
+
−
 
+
−
==Probleme==
+
−
==Links==
+
−
{|
+
−
| [1]
+
−
| http://www.openssl.org
+
−
| OpenSSL Project Homepage
+
 
|-
 
|-
−
| [2]
+
| -c CMD            || --convcmd=CMD            || CMD is called to convert mail-parts from html to text
−
| http://www.kernel.org/pub/linux/libs/pam
+
−
| Linux-PAM
+
 
|-
 
|-
−
| [3]
+
| -i MAX            || --interval=MAX          || MAX the maximum interval for the background check (minutes)
−
| http://www.washington.edu/imap
+
−
| IMAP
+
 
|-
 
|-
−
| [4]
+
| -d LVL            ||--debug=LVL              || LVL is a debug value (numeric value)
−
| http://sites.inka.de/seca/vdr
+
|}
−
| Homepage des Plugins
+
 
−
|}[[Kategorie:Plugins]]
+
==Aktuelle Version==
 +
[http://alex.vdr-developer.org/download/vdr-mailbox-0.7.0.tgz 0.7.0]
 +
 
 +
==Links==
 +
# [http://alex.vdr-developer.org/mailbox/index_en.html Homepage des Plugins]
 +
 
 +
[[Kategorie:Plugins]]
 +
{{i18n|mailbox-plugin}}

Aktuelle Version vom 13. August 2013, 19:41 Uhr

Inhaltsverzeichnis

[Bearbeiten] Beschreibung

Autor: Alexander Rieger

Mailbox ist ein Plugin zum Lesen von eMails. Unterstützt werden POP3 und IMAP Postfächer.

Zum Zugriff auf die Konten nutzt das Plugin die IMAP server c-client-library von Mark Crispin. Da diese Bibliothek auch POP3 unterstützt können auch POP3 Accounts gelesen werden, POP3 Accounts werden jedoch nicht so gut unterstützt.

[Bearbeiten] Status

Letztes Update 03/2013


[Bearbeiten] Bilder

Beschreibung
Beschreibung
Beschreibung
Beschreibung
Beschreibung
Beschreibung
Beschreibung
Beschreibung
Beschreibung
Beschreibung
Beschreibung
Beschreibung

[Bearbeiten] Softwareanforderungen

  • openssl
  • imap
  • pam

[Bearbeiten] Installation

Vor dem Übersetzen des Plugins ist das Makefile zu ändern. ($SOURCEDIR anzupassen...) 

IMAPDIR    ?= $SOURCEDIR/imap/c-client
IMAPINCDIR ?= $(IMAPDIR)
IMAPLFLAGS ?= $(IMAPDIR)/c-client.a -lssl -lpam

Installieren der Bibliothek und Developer Dateien mit SSL Support 

apt-get install libc-client-ssl2001 libc-client-ssl2001-dev
libc-client-ssl2001
Wird für das Plugin benötigt.
libc-client-ssl2001-dev
Wird zum kompilieren des Plugins benötigt!

Zum manuellem kompilieren des Plugin setze die folgenden Variablen im Makefile 

 IMAPINCDIR ?= /usr/include/c-client
 IMAPLFLAGS ?= -lc-client -lssl

[Bearbeiten] Konfiguration

Warnung
Warnung

Die Account werden im Klartext in der Datei 'plugins/mailbox' innerhalb des VDR Konfigurationsverzeichnis gespeichert. Diese Datei wird mit den Dateirechten 0x600 abgespeichert. Der Nutzer unter dessen Account VDR läuft, kann diese Datei also lesen.

Die email Account Passwörter werden in modifizierter Form in dieser Datei gespeichert, es gibt keine echte Verschlüsselung, lediglich das Lesen für zufällige Betrachter wird erschwert.



Zum Format der accounts.conf.

Die Account-Einstellungen werden abgelegt in. 

$VDRCONFIG/plugins/mailbox/accounts.conf

Diese wird automatisch generiert, wenn Du ein Konto angibst.

Die Einstellungen kannst du aber auch händisch machen, indem Du eine Datei mit diesem Namen anlegst und folgendes für jedes Konto untereinander weg angibst.

Datei
$VDRCONFIG/plugins/mailbox/accounts.conf 
[Account]
  AccountName  = deinkonto                    # lokaler Kontenname
  LoginName    = deinname                     # Mailbox- Zugangsname
  LoginPass    = deinpasswort                 # Mailboxpasswort
  MailBox      = {pop.t-online.de/pop3/notls} # Beispiel (Klammern müssen sein! BEI IMAP : {imap.deinserver.de/imap/notls/norsh}INBOX)
  AutoMarkSeen = 0                            # autom. als gelesen markieren 0-1
  Expunge      = 0                            # autom. ausf Server löschen 0-1

[Account]
  AccountName     = IMAP-SSL
  LoginName       = ********
  LoginPass       = ********
  MailBox         = {ImapSSL.server.de:993/imap/ssl/novalidate-cert}INBOX
  AutoMarkSeen    = 0
  Expunge         = 0


[Bearbeiten] Parameter

Parameter (kurz) Parameter (lang) Beschreibung
-m mailcmd.sh --mailcmd=mailcmd.sh Skript, welches bei neuen M@ils aufgerufen werden soll.
-c CMD --convcmd=CMD CMD is called to convert mail-parts from html to text
-i MAX --interval=MAX MAX the maximum interval for the background check (minutes)
-d LVL --debug=LVL LVL is a debug value (numeric value)

[Bearbeiten] Aktuelle Version

0.7.0

[Bearbeiten] Links

  1. Homepage des Plugins
Von „http://static.vdr-wiki.de/wiki/index.php?title=Mailbox-plugin&oldid=74905“
In anderen Sprachen