Mailbox-plugin

Aus VDR Wiki
(Unterschied zwischen Versionen)
Wechseln zu: Navigation, Suche
(Konfiguration)
 
(58 dazwischenliegende Versionen von 36 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==
Installation von Imap
 
cd $SOURCEDIR
 
tar xvzf openssl-<VERSION>.tar.gz
 
cd openssl-<VERSION>
 
./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-2004e imap
 
cd imap
 
make lsu
 
 
 
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 45: Zeile 40:
 
  IMAPINCDIR ?= $(IMAPDIR)
 
  IMAPINCDIR ?= $(IMAPDIR)
 
  IMAPLFLAGS ?= $(IMAPDIR)/c-client.a -lssl -lpam
 
  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
  
 
==Konfiguration==
 
==Konfiguration==
 +
 +
{{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.
 +
 +
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]].
 
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 57: 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 62: 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 1 and 1 <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.
+
 
+
Aufruf dann wie folgt.
+
  
vdr -P'mailbox -m /usr/local/bin/[[mailcmd.sh]]'
+
===Parameter===
 
+
{| class="wikitable"
==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