Mailbox-plugin

Aus VDR Wiki
(Unterschied zwischen Versionen)
Wechseln zu: Navigation, Suche
(Patch für vdr >= 1.3.18)
 
(50 dazwischenliegende Versionen von 32 Benutzern werden nicht angezeigt)
Zeile 2: Zeile 2:
 
'''Autor:''' Alexander Rieger
 
'''Autor:''' Alexander Rieger
  
Mailbox ist ein Plugin zum Lesen von eMails. Unterstützt werden POP3 und IMAP Postfächer.
+
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 17: Zeile 35:
  
 
==Installation==
 
==Installation==
===Source===
 
cd $SOURCEDIR
 
tar xvzf openssl-<VERSION>.tar.gz
 
cd openssl-<VERSION>
 
./config --prefix=/usr/local shared
 
make
 
make install
 
ldconfig
 
cd -
 
 
'''<MAJOR.MINOR>''' entspricht der '''<VERSION>''', zbs: '''0.80'''.
 
 
tar xvzf Linux-PAM-<VERSION>.tar.gz
 
./configure --prefix=/usr/local --enable-static-libpam
 
make
 
make install
 
cd /usr/local/lib
 
ln -s libpam.so.'''<MAJOR.MINOR>''' libpam.so
 
ln -s libpam_misc.so.'''<MAJOR.MINOR>''' libpam_misc.so
 
ln -s libpamc.so.'''<MAJOR.MINOR>''' libpamc.so
 
ldconfig
 
cd -
 
 
tar xvzf imap.tar.Z
 
mv imap-2004e imap
 
cd imap
 
make lsu EXTRACFLAGS="-I/usr/local/include/openssl"
 
 
 
Vor dem Übersetzen des Plugins ist das Makefile zu ändern. ('''$SOURCEDIR''' anzupassen...)
 
Vor dem Übersetzen des Plugins ist das Makefile zu ändern. ('''$SOURCEDIR''' anzupassen...)
  
Zeile 51: Zeile 41:
 
  IMAPLFLAGS ?= $(IMAPDIR)/c-client.a -lssl -lpam
 
  IMAPLFLAGS ?= $(IMAPDIR)/c-client.a -lssl -lpam
  
===[[Crux]]===
+
Installieren der Bibliothek und Developer Dateien mit SSL Support
  prt-get depinst linux-pam libc-client
+
  apt-get install libc-client-ssl2001 libc-client-ssl2001-dev
  
===[[Debian]]===
+
;libc-client-ssl2001:Wird für das Plugin benötigt.
apt-get install libc-client2001 libc-client2001-dev
+
;libc-client-ssl2001-dev:Wird zum kompilieren des Plugins benötigt!
  
===[[Gentoo]]===
+
Zum manuellem kompilieren des Plugin setze die folgenden Variablen im Makefile
emerge c-client
+
  IMAPINCDIR ?= /usr/include/c-client
 +
  IMAPLFLAGS ?= -lc-client -lssl
  
===[[SuSE]]===
+
==Konfiguration==
yast -i pam-devel imap-lib imap-devel
+
  
 +
{{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.
  
==Patches==
+
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.}}
* vdr >= '''1.3.18''' http://www.vdrportal.de/board/thread.php?threadid=28359
+
  
  
==Konfiguration==
 
 
Zum Format der [[accounts.conf]].
 
Zum Format der [[accounts.conf]].
  
 
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 79: 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| $VDRCONFIG/plugins/mailbox/accounts.conf |
+
{{Box Datei| [[Struktur|$VDRCONFIG]]/plugins/mailbox/accounts.conf |
 
<pre>
 
<pre>
 
[Account]
 
[Account]
Zeile 85: 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
</pre>
 
}}
 
  
Um eingehende Mails via [[Svdrp]] anzeigen zu lassen.
+
[Account]
 +
  AccountName    = IMAP-SSL
 +
  LoginName      = ********
 +
  LoginPass      = ********
 +
  MailBox        = {ImapSSL.server.de:993/imap/ssl/novalidate-cert}INBOX
 +
  AutoMarkSeen    = 0
 +
  Expunge        = 0
  
'''<div style="display:inline; color:white; background:green"><tt>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</tt>New Mail in Account Name <tt>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</tt></div>'''
+
</pre>
 +
}}
  
ist die [[mailcmd.sh]] in den '''PATH''' zu kopieren.
+
===Parameter===
 
+
{| class="wikitable"
find $SOURCEDIR/VDR -name mailcmd.sh -exec ln -vfs {} /usr/local/bin \;
+
|-
 
+
Aufruf dann wie folgt.
+
 
+
vdr -P'mailbox -m /usr/local/bin/[[mailcmd.sh]]'
+
 
+
==Parameter==
+
{| border=1 cellpadding=2 cellspacing=0
+
|- 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
In anderen Sprachen