Mailbox-plugin

Aus VDR Wiki
(Unterschied zwischen Versionen)
Wechseln zu: Navigation, Suche
(Parameter)
 
(79 dazwischenliegende Versionen von 47 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
 
==Beschreibung==
 
==Beschreibung==
Mailbox ist ein Plugin zum email lesen mehrerer IMAP-Accounts am OSD des VDR.
+
'''Autor:''' Alexander Rieger
 +
 
 +
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.
  
[[Bild:mailbox-plugin.jpg|thumb|none|''Setup'']]
+
===Status===
 +
Letztes Update 03/2013
 +
 
 +
 
 +
==Bilder==
 +
{|
 +
| [[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
 
* imap
 
* imap
 +
* pam
  
 
==Installation==
 
==Installation==
Siehe [[Plugin Installation]].
+
Vor dem Übersetzen des Plugins ist das Makefile zu ändern. ('''$SOURCEDIR''' anzupassen...)
  
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)
+
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
  
 
==Konfiguration==
 
==Konfiguration==
  
==Parameter==
+
{{Box Warnung|
{| border=1 cellpadding=2 cellspacing=0
+
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.
|- bgcolor=#efefef
+
 
 +
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.
 +
 
 +
[[Struktur|$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.
 +
 
 +
{{Box Datei| [[Struktur|$VDRCONFIG]]/plugins/mailbox/accounts.conf |
 +
<pre>
 +
[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
 +
 
 +
</pre>
 +
}}
 +
 
 +
===Parameter===
 +
{| class="wikitable"
 +
|-
 
!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.
 +
|-
 +
| -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)
 
|}
 
|}
  
==Probleme==
+
==Aktuelle Version==
 +
[http://alex.vdr-developer.org/download/vdr-mailbox-0.7.0.tgz 0.7.0]
 +
 
 
==Links==
 
==Links==
{|
+
# [http://alex.vdr-developer.org/mailbox/index_en.html Homepage des Plugins]
| [1]
+
 
| http://www.openssl.org
+
[[Kategorie:Plugins]]
| OpenSSL Project Homepag
+
{{i18n|mailbox-plugin}}
|-
+
| [2]
+
| http://www.washington.edu/imap
+
| IMAP Information Center
+
|-
+
| [3]
+
| http://sites.inka.de/seca/vdr
+
| Homepage des Plugins
+
|}[[Kategorie:Plugins]]
+

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