TuxBoxWIKI - Benutzerbeiträge [de]

Bootlog

2010-08-10T15:40:29Z

DrStoned:

[[Category:Register]]

Das [[Bootlog]] (= serielles Log) wird benötigt, um z.B. Ausgaben über den Startvorgang oder allgemeine Ausgaben während des Betriebes der [[DBox2]]-Software analysieren zu können.

__TOC__

=Vorraussetzungen=
Um das [[Bootlog]] zu bekommen, benötigt man Folgendes:

* in der GUI muss die Logausgabe auf seriell gestellt sein siehe z.B: [[Neutrino:Einstellungen:Treiber-_%26_Bootoptionen#EXPERT.21_Boot-Konsole|Neutrino-Einstellungen]]
[[Bild:seriell.jpg|thumb|none|300px|Beispiel: Neutrino Einstellung muss auf seriell stehen!]]
* Terminal-Programm (z.B. Hyperterminal) oder [[DBox2]]-[[Bootmanager]], [[Putty]] oder [[Minicom]] unter Linux
* angeschlossenes [[Nullmodem|Null-Modemkabel]]

alternativ, wenn kein Nullmodemkabel verwendet wird:
* mit ''[[setconsole]]'' (über [[BusyBox]] aktiviert)

'''Hinweis'''
''[[Setconsole]] ist nicht in jedem [[Image]] enthalten.''

Wenn Ihr nicht wisst, was ein [[Nullmodem|Null-Modemkabel]] oder Terminal-Programm ist, solltet Ihr besser nicht versuchen eine [[DBox2]] mit [[Linux]] zu [[flashen]]. Wer trotzdem unerschrocken und lernwillig ist, möge [http://www.google.de Google] für weitere Informationen bemühen. Für die Nutzung des [[DBox2]]-[[Bootmanager]]s lest bitte die entsprechende Anleitung, welche im Readme des Bootmanagers zu finden sein sollte!

=mit Bootmanager oder Terminalprogramm=
==Einstellungen==
* [[Nullmodem]]kabel mit [[DBox2]] und [[PC]] (Com1 od. Com2) verbinden

* Schnittstelle am [[PC]] entsprechend konfigurieren. Stellt die benutzte [[COM]]-Schnittstelle auf 9600 Baud, 8bit, no parity

* [[DBox2]] starten und gucken, ob eine Ausgabe im Terminalprogramm erfolgt. Wenn nein (oder nur unleserliche Zeichen), Schnittstelle auf 57600 Baud, 8 bit, no parity konfigurieren und [[DBox2]] wieder neu booten.

Im Terminal-Programm sollten eine lange Liste der von der [[DBox2]] durchgeführten Aktionen stehen. Dies ist das Bootlog...

==Beispiel==
(extrem gekürzt):

debug: DDF: Calibrating delay loop... debug: DDF: 67.79 BogoMIPS
debug: BMon V1.2 mID 01
debug: feID dd gtxID 0b
debug: fpID 5a dsID 01-8b[....]
debug: HWrev 09 FPrev 0.81
debug: B/Ex/Fl(MB) 32/00/08
WATCHDOG reset enabled
dbox2:root> debug:
BOOTP/TFTP bootstrap loader (v0.3)
debug:
debug: Transmitting BOOTP request via broadcast
debug: Given up BOOTP/TFTP boot
boot net failed

Flash-FS bootstrap loader (v1.5)

[...]

Initializing...
CPU: PPC823ZTnnB2 at 67 MHz: 2 kB I-Cache 1 kB D-Cache
Board: ### No HW ID - assuming TQM8xxL
DRAM: (faked) 32 MB
Ethernet: .....
FLASH: 8 MB
LCD driver (KS0713) initialized
LCD logo at: 0x84A7E (0x1E00 bytes)
FB logo at: 0x868A6 (0x31C1 bytes)
AVIA Frambuffer
Input: serial
Output: serial

[...]

events are old 60min after their end time
[sectionsd ] checking timerd
[sectionsd ] timerd available
dmxdev: set buffer size 40000 -> 60000
$Id: zapit.cpp,v 1.163 2002/04/24 18:51:18 field Exp $

/var/tuxbox/config/zapit/zapit.conf: No such file or directory
[getservices.cpp] /var/tuxbox/config/zapit/services.xml: No such file or directory
[zapit] /var/tuxbox/config/zapit/bouquets.xml: No such file or directory
[zapit] channels have been loaded succesfully
Controld $Id: controld.cpp,v 1.57 2002/03/29 15:47:18 obi Exp $

[controld] Boxtype detected: (01, 1, 1, Nokia)
set event: 00000009
SWITCH LETTER BOX
[nhttpd] [[Neutrino]] HTTP-Server starting..

httpd gestartet
dmxdev: set buffer size 40000 -> 60000
NeutrinoNG $Id: neutrino.cpp,v 1.243 2002/04/24 13:06:58 field Exp $

[neutrino] frameBuffer Instance created
[...]

=Hinweis=
Bricht das [[Bootlog]] nach

Image Type: PowerPC Linux Kernel Image (gzip compressed)
Data Size: 576993 Bytes = 563 kB = 0 MB
Load Address: 00000000
Entry Point: 00000000
Verifying Checksum ... OK
Uncompressing Kernel Image ... OK

ab, dann startet die [[DBox2]] nochmal und drückt die "2" (auf der [[Fernbedienung]]) an dieser Stelle:

Options:
1: Console on null
2: Console on ttyS0
3: Console on framebuffer
Select (1-3), other keys to stop autoboot: 0

=Bootlog über Netzwerk=
Es besteht die Möglichkeit, über den Befehl ''[[setconsole]]'', ein Log über [[Telnet]] über das [[Netzwerk]] aufzuzeichnen. Vorraussetzung dafür ist, dass Dbox-Taste -> Einstellungen -> Treiber- und Bootoptionen -> Expert! Bootconsole auf '''seriell''' steht. Die Ausgaben über das Netzwerk sind unter Umständen nicht so ausführlich, wie ein serielles Bootlog. Man sollte daher immer ein Bootlog über die serielle Schnittstelle vorziehen. Das erleichtert in der Regel immer die Suche nach Fehlern.

=Kernel-Log ausgeben=
Mit dem Befehl "dmesg" (alternativ mit "cat /proc/kmsg") kann man sich mittels [[Telnet]] den [[Kernel]]-Log ausgeben lassen. Auch hier sollte immer ein Bootlog über die serielle Schnittstelle vorgezogen werden. Die dmesg-Ausgaben sind bei weitem nicht so üppig, wie es über die serielle Schnittstelle möglich wäre.

=unter Linux=
Ein Bootlog unter Linux kann man relativ einfach mit diesem Befehl erstellen:
sudo cat -u /dev/ttyS0

{{body}}

Plugins:TuxMail

2008-12-13T10:49:08Z

DrStoned:

[[Category:Register]]
[[Category:Plugins]]
{{Plugins_sidebar}}
__TOC__

=Allgemeines=
Mit TuxMail ist es möglich bis zu 10 [[POP3]] oder [[IMAP]]-Konten direkt über die [[DBox2]] abzufragen und Informationen wie Datum, Zeit, Absender und Betreff einer Mail über den TV sowie eine Kurzübersicht über das [[LCD]] auszugeben. Mails können ebenfalls über die Box gelesen und geschrieben werden. Das Plugin kann sowohl mit der [[Fernbedienung]], als auch mit der [[IR-Tastatur]] bedient werden. Wenn die erste Zeile einer empfangenen Mail mit der SECURITY Angabe in der Datei tuxmail.conf übereinstimmt, werden alle nachfolgenden Zeilen dieser Mail als Befehle für die Box interpretiert und ausgeführt.

Das Programm besteht aus 2 Teilen:
*dem [[Daemon]] (tuxmaild), welcher im Hintergrund läuft und die Konten in festgelegten Intervallen auf Maileingang prüft und ausgewählte Mail löscht
*dem Plugin (tuxmail.so + tuxmail.cfg), welches die Infos nach Konten sortiert auf dem TV und [[LCD]] darstellt und den [[Daemon]] steuert

Sobald der [[Daemon]] eine neue Mail gefunden hat wird eine optische und/oder akustische Benachrichtigung ausgelöst um dem Nutzer den Maileingang zu signalisieren. Dies kann über ein Nachrichtenfenster erfolgen oder das Plugin kann gleich gestartet werden.

Um bei einer interessanten Sendung nicht gestört zu werden kann die Kontenabfrage über das Plugin angehalten und auch wieder gestartet werden. Damit ist es auch möglich eine manuelle Kontenprüfung außerhalb des festgelegten Intervalls auszulösen.

Sollte sich mal wieder eine unerwünschte Mail verirrt haben kann diese gleich über das Plugin zum Löschen markiert werden - der [[Daemon]] erledigt dann den Rest. Ein einfacher Spamfilter (Absenderadresse bzw. Teiladresse) ist ebenfalls enthalten.

=Konfiguration=
Damit der [[Daemon]] die Konten überprüfen kann benötigt er Angaben wie Mailserver, Nutzername und Passwort. Diese müssen in die Datei tuxmail.conf im Verzeichnis /var/tuxbox/config/tuxmail eingetragen werden.

Der [[Daemon]] erzeugt beim ersten Start das Verzeichnis sowie eine Datei mit Standardwerten falls diese nicht existiert und beendet sich wieder. Hier können nun die erforderlichen Angaben eingetragen oder alternativ eine fertige Datei vom PC per [[FTP]] übertragen werden.

Damit diese Datei erzeugt wird, muss das Plugin gestartet werden und der [[Plugins:TuxMail#Autostart_festlegen|Autostart]] aktiviert werden, danach die Box neu starten.

Mit dem [[Plugins]] kann durch drücken von '''[DBOX]''' die Konfiguration bearbeitet werden.

Die Datei hat folgenden Aufbau:
{| border="1"
|Eintrag||Bedeutung||mögliche Werte||Standard
|-
|STARTDELAY||Wartezeit bis der [[Daemon]] mit der ersten Kontenabfrage beginnt (die [[GUI]] benötigt einige Zeit zum starten)||15...120||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 (Eine benutzerdefinierte 12/24/48KHz PCM Wave-Datei kann unter /var/tuxbox/config/tuxmail/tuxmail.wav abgelegt werden.)||Y / N||Y
|-
|VIDEO||optische Signalisierung (Message: muss per [[Fernbedienung]] bestätigt werden) (Popup: wird nach einiger Zeit automatisch geschlossen)||1 = Plugin starten 2 = [[Enigma]] Popup 3 = [[Neutrino]] Message 4 = [[Neutrino]] Popup 5 = keine Signalisierung||1
|-
|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 wählen (1=blau, 2=grau)||1 / 2||1
|-
|ADMIN||Löschen von Mails erlauben / verbieten ||Y / N||Y
|-
|TYPEFLAG||Wann werden Mails im Plugin grün markiert ||1 .. 3||1
|-
|CONFIGCODE||Sicherheits-PIN (Zugriff auf Konfigurationsmenü erst nach Eingabe möglich)||0000...9999||leer
|-
|MAILCACHE||Mails werden schon bei der Kontoabfrage gelesen und gesichert (0=kein Lesen)||0..99||0
|-
|MAILDIR||In welches Verzeichnis sollen die Mails gesichert werden || /directory/ || /tmp/
|-
|SECURITY||Zeichenfolge die das Ausführen einer Mail bewirkt ||Text ohne Leerzeichen von bis zu 64 Zeichen||leer
|-
|WEBPORT||Port des Webinterface der dbox|| 1 - 65535||80
|-
|WEBUSER||Benutzername für das Webinterface der dbox||Text ohne Leerzeichen von bis zu 32 Zeichen||leer
|-
|WEBPASS||Passwort für 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?||POP3 Maileingangsserver||Text ohne Leerzeichen von bis zu 64 Zeichen||leer
|-
|IMAP?||IMAP 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 möglich, z.B. bei mehreren Familien-Mitgliedern)||0000...9999||leer
|-
|AUTH?||Authentifizierungsmethode für SMTP||0: keine, 1: POP3 Parameter, 2: SUSER? und SPASS?||0
|-
|SUSER?||Nutzername für SMTP||Text ohne Leerzeichen von bis zu 64 Zeichen||leer
|-
|SPASS?||Passwort für SMTP||Text ohne Leerzeichen von bis zu 64 Zeichen||leer
|-
|INBOX?||Ordner für IMAP||Text ohne Leerzeichen von bis zu 64 Zeichen||leer
|}

Die Einträge "STARTDELAY", "INTERVALL", "LOGGING", "LOGMODE", "SAVEDB", "AUDIO", "VIDEO", "LCD", "OSD", "SKIN", "ADMIN" und "WEBxxxx" sind global, d.h. diese Einstellungen gelten für alle Konten und müssen somit nur einmal eingetragen werden.

WEBUSER und WEBPASS können leer gelassen werden, wenn das Webinterface keine Authorisation erfordert.

Für das "?" bei "NAME", "POP3", "IMAP", "USER", "PASS", "SMTP", "FROM", "CODE", "AUTH", "SUSER", "SPASS" und "INBOX" sind Werte von 0...9 möglich. Bei weniger als 10 Konten können die entsprechenden Einträge entfallen oder einfach leer gelassen werden. Es darf nur entweder der Eintrag "POP3" oder der Eintrag "IMAP" verwendet werden. Wenn nicht das Standardport verwendet werden soll ist dies mit "Mailserver:Port" anzugeben. Wird der Eintrag INBOX leer gelassen, wird der Standardwert "INBOX" verwendet.

==Konfigurationsbeispiel "tuxmail.conf"==
STARTDELAY=30
INTERVALL=15
LOGGING=Y
LOGMODE=S
SAVEDB=Y
AUDIO=Y
VIDEO=1
LCD=Y
OSD=G
SKIN=1
ADMIN=Y
TYPEFLAG=1
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=

==Spamfilter aktivieren==
Um lästige Werbemail gleich zu löschen kann der Spamfilter aktiviert werden. Hierfür ist die Datei spamlist im Verzeichnis /var/tuxbox/config/tuxmail anzulegen und bis zu 100 unerwünschte Absenderadressen bzw. Teiladressen einzutragen. Über das Plugin kann das auch automatisch erfolgen.

Die Löschung vom [[Server]] erfolgt hierbei ohne Sicherheitsabfrage! Überlegt also genau was hier eingetragen werden soll: eine Zeile nur mit "@" oder "." löscht mit Sicherheit JEDE Mail...

==Konfigurationsbeispiel "spamlist"==
neu@web.de
mailings@gmx

==Konfigurationsbeispiel "tuxmail.addr"==
freundin@web.de
geliebte@gmx.de
frau@zuhause.de

Das ist ein vordefiniertes Adressbuch, aus dem beim Schreiben einer Mail ausgewählt werden kann.

==Konfigurationsbeispiel "mailtext.01"==
Hallo,
ich sitze derzeit vor dem Fernseher und habe keine Zeit.
cu.
Dein Satreceiver

Das ist ein vordefinierter Mailblock, der beim Schreiben einer Mail ausgewählt werden kann.

==Konfigurationsbeispiel "tuxmail.t9 ???"==
Aachen,Aal,Aas,ab,Abakus...
Baal,Baas,babbeln,Babel...
C...

T9: [[wikipedia:Text_on_9_keys|Text on 9 keys]], eine Erfindung zur vereinfachten Eingabe von SMS bei Handys

T9 ist derzeit noch nicht implementiert

==Bedienung==
Zum Starten des [[Plugins]] '''[BLAU]''' drücken und dann den Eintrag "E-Mail" wählen.

Das Plugin zeigt nun das Konto #0 (oder falls neue Mail vorliegt das erste Konto mit neuer Mail) an.

[[Bild:TuxMail01.png|400px]]

Jede Mail ist farbig gekennzeichnet und hat dabei folgende Bedeutung:

TYPEFLAG=1
{|
|[[Bild:TuxMail02.jpg.png|20px]]||diese Mail ist seit der letzten Kontenabfrage neu hinzugekommen
|-
|[[Bild:TuxMail03.jpg.png|20px]]||diese Mail war bei der letzten Kontenabfrage bereits vorhanden
|-
|[[Bild:TuxMail04.jpg.png|20px]]||diese Mail soll bei der nächsten Kontenabfrage gelöscht werden
|}

TYPEFLAG=2
{|
|[[Bild:TuxMail02.jpg.png|20px]]||es wurde noch keine neue Kontenabfrage durchgeführt seit diese Mail neu hinzugekommen ist
|-
|[[Bild:TuxMail03.jpg.png|20px]]||diese Mail war schon vorhanden seit das Plugin geöffnet wurde und eine neue Kontenabfrage durchgerührt wurde
|-
|[[Bild:TuxMail04.jpg.png|20px]]||diese Mail soll bei der nächsten Kontenabfrage gelöscht werden
|}

TYPEFLAG=3
{|
|[[Bild:TuxMail02.jpg.png|20px]]||diese Mail ist seit dem letzten Öffnen des Plugins neu hinzugekommen
|-
|[[Bild:TuxMail03.jpg.png|20px]]||diese Mail war beim letzten Öffnen des Plugins bereits vorhanden
|-
|[[Bild:TuxMail04.jpg.png|20px]]||diese Mail soll bei der nächsten Kontenabfrage gelöscht werden
|}

==Konto auswählen==
Mit '''[+]''' '''[-]''' bzw. '''[VOLUME +]''' '''[VOLUME -]''' kann das nächste bzw. vorhergehende Konto angezeigt werden. Ungenutzte Konten werden hierbei übersprungen. Eine Direktwahl (auch ungenutzter Konten) erfolgt über '''[0]...[9]'''.

Falls eine PIN für dieses Konto definiert wurde wird diese zunächst abgefragt und muss mit '''[0]'''...'''[9]''' eingegeben oder mit '''[HOME]''' bzw. '''[EXIT]''' abgebrochen werden.

[[Bild:TuxMail11.png|200px]]
[[Bild:TuxMail12.png|200px]]
[[Bild:TuxMail13.png|200px]]
[[Bild:TuxMail14.png|200px]]

Nach 3 Fehlversuchen wird das Konto gesperrt. Ein Zugriff ist erst nach neustarten des Plugins wieder möglich.

==Mail löschen==
Mittels '''[HOCH] [RUNTER]''' kann die vorhergehende bzw. nächste Mail ausgewählt und durch einen Druck auf '''[ROT]''' zum Löschen vorgemerkt werden. Ein weiterer Druck auf '''[ROT]''' hebt die Markierung wieder auf. Seitenweise kann mit '''[RECHTS] [LINKS]''' geblättert werden.

Beim verlassen des [[Plugins]] werden diese Informationen gespeichert und somit aktiv. Die Löschung vom Mailserver erfolgt jedoch erst bei der nächsten Abfrage des Kontos durch den [[Daemon]].

== Mail schreiben ==
Um eine Mail zu schreiben '''[GRÜN]''' drücken.

Der Absender der selektierten Mail wird dabei automatisch als Empfänger eingetragen und der Betreff um "Re: " erweitert.

Vorgefertigte Textblöcke können mit den Namen tuxmail.01, tuxmail.02 usw. in /var/tuxbox/config/tuxmail abgelegt werden.
Eine Adressenliste kann mit dem Namen tuxmail.addr in /var/tuxbox/config/tuxmail abgelegt werden.

Zeichen können mit '''[MUTE]''' gelöscht und mit '''[BLAU]''' bzw. '''[RECHTS]''' eingefügt werden. Die Zeile kann mit '''[HOCH]''' und '''[RUNTER]''' gewechselt werden. Textblöcke bzw. die letzte gelesene EMail können mit '''[+]''' '''[-]''' bzw. '''[VOLUME +]''' '''[VOLUME -]''' gewechselt werden ( im Mode '''Texte''' ), Adressen aus der Adressenliste können ebenfalls mit '''[+]''' '''[-]''' bzw. '''[VOLUME +]''' '''[VOLUME -]''' gewechselt werden wenn die entsprechende Zeile ausgewählt ist.

Die Mail wird mit '''[OK]''' gesendet oder mit '''[HOME]''' bzw. '''[EXIT]''' verworfen.

== Mail lesen ==
Um eine Mail zu lesen '''[GELB]''' drücken.

Die ausgewählte Mail wird nun (ohne sie zu löschen) vom Server geladen bzw. die schon vorher geladene Mail wird ausgewählt und angezeigt. Durch die Anzeige kann mittels '''[LINKS]''' / '''[HOCH]''' und '''[RECHTS]''' / '''[RUNTER]''' geblättert werden. Zurück kommt man mit '''[HOME]''' bzw. '''[EXIT]'''.

== Mail ausführen ==
Wenn die Optionen MAILCACHE und MAILDIR, sowie SECURITY gesetzt sind, wird jede vom [[Daemon]] gelesene Mail ausgewertet. Damit der Inhalt einer Mail ausgeführt wird, muss die erste Zeile dieser Mail exakt mit der in SECURITY definierten Zeichenfolge übereinstimmen. Alle weiteren Zeilen werden dann als Befehle auf der Box exekutiert.

Da Mails beim Lesen vom [[Daemon]] eine maximale Zeilenlänge von 80 Zeichen haben, müssen Befehle, um aus mehreren Zeilen zusammengesetzt werden zu können, am Zeilenende ein '''&''' Zeichen haben.

==Spamfilter erweitern==
Mit '''[BLAU]''' wird die momentan selektierte Mail (Absenderadresse) zur Spamliste hinzugefügt. Sollte bisher noch keine Liste existieren wird diese automatisch angelegt. Gleichzeitig wird die Mail zum Löschen markiert. Sollten sich bereits weitere Mails dieses Absenders in der Datenbank befinden müssen diese manuell gelöscht werden. Das Löschen und das Hinzufügen zur Spamliste kann mit '''[BLAU]''' wieder rückgängig gemacht werden.

[[Bild:TuxMail15.png|200px]]
[[Bild:TuxMail16.png|200px]]

==Kontenabfrage steuern==
Normalerweise wird der [[Daemon]] beim Start der Box automatisch gestartet und fragt die Konten im festgelegten Intervall periodisch ab. Die Abfrage kann auch mit '''[MUTE]''' gesteuert werden, z.B. wenn man eine Sendung ungestört ansehen oder eine manuelle Prüfung auslösen möchte. Ein Druck schaltet die Abfrage aus, ein weiterer wieder ein.

[[Bild:TuxMail05.png|200px]]
[[Bild:TuxMail06.png|200px]]

Die Konten werden beim Reaktivieren der Abfrage sofort geprüft. Einige Mailserver haben jedoch ein minimales Loginintervall (z.B. web.de FreeMail = 15min). Mehrfache Anfragen innerhalb dieser Zeit sind nutzlos und werden vom [[Server]] mit einem entsprechenden Hinweis abgelehnt.

Um im Standby eine Kontenabfrage zu unterbinden kann unter [[Enigma]] das Script "/var/etc/enigma_enter_standby.sh" sowie unter [[Neutrino]] das Script "/var/tuxbox/config/standby.on" mit dem Inhalt "if [ -e /tmp/tuxmaild.pid ]; then kill -usr2 $(cat /tmp/tuxmaild.pid); fi" angelegt werden. Zum Fortsetzen der Kontenabfrage muss unter [[Enigma]] das Script "/var/etc/enigma_leave_standby.sh" sowie unter [[Neutrino]] das Script "/var/tuxbox/config/standby.off" mit dem Inhalt "if [ -e /tmp/tuxmaild.pid ]; then kill -usr1 $(cat /tmp/tuxmaild.pid); fi" angelegt werden.

Die Abfrage wird so mit dem Beginn des Standby pausiert und startet erst beim Beenden des Standby wieder. Eingehende Nachrichten während dieser Zeit werden nun nicht mehr verpasst.

==Versionsnummern anzeigen==
Zur Fehlereingrenzung ist die genutzte Version von Daemon und Plugin wichtig. Diese kann durch drücken von '''[?]''' bzw. '''[INFO]''' ermittelt werden.

==Autostart festlegen==
Über das Plugin kann auch der Start des [[Daemon]] kontrolliert werden. Ein Druck auf '''[STANDBY]''' aktiviert den Autostart, ein weiterer deaktiviert diesen wieder.

[[Bild:TuxMail07.png|200px]]
[[Bild:TuxMail08.png|200px]]

Vom Plugin wird dabei unter /var/etc die Datei .tuxmaild angelegt oder gelöscht. Eine vorhandene .tuxmaild bedeutet das der Autostart aktiviert ist. Allerdings muss dies vom Initscript der [[DBox2]] oder dem Startscript der jeweiligen [[GUI]] (start_enigma, start_neutrino, start_lcars) ausgewertet werden.

==Scriptbeispiel zum Daemon starten==
if [ -e /var/etc/.tuxmaild ]; then /Pfad zum Daemon/tuxmaild; fi

Ohne einen aktiven [[Daemon]] findet keine Kontenabfrage statt und im Plugin wird somit "keine Info verfügbar" angezeigt. Der Autostart muss vom Nutzer also erst einmal aktiviert werden da er standardmäßig deaktiviert ist. Bei jedem Start der [[DBox2]] bzw. [[GUI]] wird er danach automatisch gestartet.

==Plugin verlassen==
Das Plugin kann mittels '''[HOME]''' beendet werden. Dabei werden die Datenbanken upgedatet und der [[Daemon]] kann bei der nächsten Abfrage die zum Löschen selektierte Mail vom [[Server]] entfernen.

=Kommandozeile=
Der [[Daemon]] kann auch von der Kommandozeile aus gestartet bzw. kontrolliert werden. Folgende Startparameter sind derzeit möglich:

*-nodelay : die Konten werden sofort nach dem Start abgefragt und das festgelegte STARTDELAY übergangen
*-syslog : die Informationen werden nicht auf die Konsole ausgegeben sondern an einen Syslog-Server gesendet
*-play <audio-Datei> : die angegebene Audio-Datei wird gespielt, der [[Daemon]] wird nicht gestartet
*-send <Kontonummer> <Empfängeradresse> <Text-Datei> : die angegebene Datei wird mit den Kontoeinstellungen der übergebenen Kontonummer an die Empfängeradresse gesendet, wobei die erste Zeile der Datei als Subject interpretiert wird. Der [[Daemon]] wird nicht gestartet

Um alle Ausgaben des Daemons auf seinen PC umzuleiten muss auf der Box mittels "[[syslogd]] -R <[[IP-Adresse]] des PC>" das Logging aktiviert werden. Auf dem PC muss natürlich ein Syslog-Server installiert sein, welcher die Ausgaben entgegen nimmt. Zur lokalen Speicherung auf der Box genügt ein "syslogd" ohne Parameter. Die Ausgaben werden so unter /var/log/messages gespeichert. Alternativ kann durch "syslogd -O <Pfad der Logdatei>" auch ein anderer Pfad eingestellt werden.

Sobald der [[Daemon]] läuft kann er über Signale an seine [[PID]] gesteuert werden. Die [[PID]] kann auf 2 Arten ermittelt werden:

*verwenden des Befehls "ps | grep tuxmaild" oder "pidof tuxmaild" und nutzen der kleinsten aufgelisteten [[PID]]
*auslesen aus der Datei /tmp/tuxmaild.pid z.B. mit "cat /tmp/tuxmaild.pid"

Damit kann nun die Konfiguration aktualisiert, die Kontenabfrage gesteuert oder der [[Daemon]] sauber beendet werden.

==Konfiguration aktualisieren==
Falls zur Laufzeit die Konfiguration geändert wurde kann der [[Daemon]] die neue Konfiguration einlesen ohne hierfür extra beendet und neugestartet zu werden:

kill -HUP <PID> bzw. kill -1 <PID>

==Kontenabfrage steuern==
Die Kontenprüfung kann ebenfalls unterbrochen und wieder gestartet werden ohne den [[Daemon]] zu beenden.

kill -USR1 <PID> bzw. kill -10 <PID> startet die Kontenprüfung,
kill -USR2 <PID> stoppt die Kontenprüfung,

==Daemon beenden==
Ein sauberes Beenden mit Sicherung der Datenbanken erfolgt mit diesem Befehl:

Kill -TERM <PID> bzw. kill -15 <PID> oder einfach mit kill <PID>

Zur Laufzeit des [[Daemon]] wird pro Konto eine Datenbank geführt, welche alle relevanten Daten enthält. Um den [[Flash]] zu schonen befinden sich diese Datenbanken unter /tmp/tuxmail.n (n = 0...9) im [[RAM]]. Beim Beenden werden diese Dateien nach /var/tuxbox/config/tuxmail gesichert damit diese beim nächsten Start nach /tmp zurückkopiert werden können und somit wieder zur Verfügung stehen.

Damit diese Dateien beim Herunterfahren der Box gesichert werden können, muss der [[Daemon]] sauber beendet werden bevor das [[JFFS2]]-Filesystem ungemountet wird!

==Scriptbeispiel zum Daemon beenden==
kill -term $(cat /tmp/tuxmaild.pid)
sleep 3

=LCD=
==Plugin==
Im [[LCD]] wird eine Übersicht des gewählten Kontos dargestellt. Angezeigt wird der Status des [[Daemon]], die Nummer des Kontos, Zeitpunkt der letzten Abfrage sowie Anzahl neuer und gesamter Mails.

[[Bild:TuxMail09.png]]

Oben links ist erkennbar ob der [[Daemon]] läuft bzw. die Kontenprüfung aktiv oder inaktiv ist. Das Symbol "OFL" bedeutet das der [[Daemon]] derzeit nicht geladen ist (z.B. wenn der Autostart deaktiviert ist) und demzufolge keine Prüfung der Konten erfolgt, "ONL" zeigt an das die Konten im festgelegten Intervall abgefragt werden und bei "PAU" ist die Kontenabfrage derzeit deaktiviert.

Dahinter wird die momentan gewählte Kontonummer angezeigt und im Anschluss daran der Zeitpunkt der letzten Abfrage.

In der unteren Zeile wird nun noch die Anzahl der neuen und gesamten Mails für das Konto ausgegeben.

==Daemon==
Ist die Option "LCD=Y" gesetzt gibt auch der Daemon den Mailstatus auf das [[LCD]] aus.

[[Bild:TuxMail10.png]]

Diese Anzeige bleibt solange aktiv (die Anzahl neuer Mails wird bei jeder Kontenabfrage aktualisiert) bis das Plugin gestartet und wieder beendet wird. Erst mit dieser Aktion wird die Sperrdatei /tmp/lcd.locked gelöscht und die Zählung beginnt wieder bei Null.

Damit ist z.B. sichergestellt, dass bei Abwesenheit keine Mails verpasst werden und bei Rückkehr der aktuelle Status sofort im [[LCD]] sichtbar ist.

Hinweis: Diese Funktion kann nur genutzt werden, wenn die [[GUI]] die Sperrdatei auswertet und bei Vorhandensein das [[LCD]] nicht mehr durch eigene Ausgaben überschreibt!

{{body}}

Plugins:Kalender

2008-12-13T10:09:02Z

DrStoned: Inhaltlicher Fehler korrigiert

[[Category:Register]]
[[Category:Plugins]]
{{Plugins_sidebar}}
__TOC__

=Allgemeines=
TuxCal ist ein Kalender, mit dem es möglich ist Feiertage, Geburtstage, Termine und Zeiträume auf der [[DBox2]] und auf der [[Dreambox]] zu verwalten. Die wichtigsten Feiertage sind fest im Programm integriert, es können jedoch auch regionale Feiertage eingefügt werden, die nicht fest eingebaut wurden. Der integrierte [[Daemon]] '''tuxcald''' erinnert auf Wunsch optisch und akustisch an die eingetragenen Events (Ereignisse). Somit vergisst man keine wichtigen Termine und Geburtstage mehr. Außerdem kann auch noch eine [[Plugins:Kalender#Bildschirmuhr|Bildschirmuhr]] frei positionierbar auf dem Bildschirm angezeigt werden.

Das Programm besteht aus 2 Teilen:
*dem [[Daemon]] '''tuxcald''', welcher im Hintergrund läuft und die Uhr steuert und die Termine überwacht, und optisch und akustisch signalisiert.
*dem Plugin '''tuxcal.so + tuxcal.cfg''', das den Kalender anzeigt und in dem neue Events verwaltet werden können und das den [[Daemon]] steuert.

Außerdem wird noch eine Datendatei '''tuxcal.list''' verwendet. In ihr werden die Termine, Geburtstage, Zeiträume und frei definierbare Feiertage verwaltet.

Sobald der [[Daemon]] einen neuen Termin gefunden hat, wird eine optische und/oder akustische Benachrichtigung ausgelöst, um den Nutzer darüber zu informieren. Dies kann über ein Nachrichtenfenster erfolgen oder das Plugin kann gleich gestartet werden.

Um bei einer interessanten Sendung nicht gestört zu werden, kann die Abfrage über das [[Plugins|Plugin]] angehalten und auch wieder gestartet werden. Sofern der [[Daemon]] aktiviert ist, werden beim Verlassen des [[Plugins]] alle Feiertage, Geburtstage, Termine und Zeiträume innerhalb des konfigurierten Zeitraums signalisiert.

=Installation=
Folgende Dateien nach '''/var/tuxbox/plugins/''' kopieren:

- '''tuxcal.cfg'''

- '''tuxcal.so'''

und folgende nach '''/var/bin/''':

- '''tuxcald'''

Die Dateien '''tuxcal.so''' und '''tuxcald''' benötigen Ausführrechte (755).

Das Datenfile '''tuxcal.list''' kommt nach '''/var/tuxbox/config/tuxcal/'''.

==Plugin updaten, was ist dabei zu beachten==
Wenn man das Plugin updaten will, ist zu beachten, dass man dazu vorher den Daemon '''tuxcald''' beenden muss, um eine neue Version dieser Datei auf die Box kopieren zu können. Dazu per Telnet unter Windows auf der [[DBox2]] einloggen mit '''[Start]''' '''[Ausführen]''', dann eingeben '''telnet <DBOXIP>''' wobei <DBOXIP> durch die [[IP-Adresse]] der [[DBox2]] zu ersetzen ist, z.B.:
telnet 192.168.0.23
Dann sollte ein Fenster auftauchen, in dem '''login''' drinsteht. Bei
'''login:''' root
'''Password:''' dbox2
eingeben. Die Passworteingabe wird nicht angezeigt, ist also blind einzugeben. Bei YADI-Images ist standardmäßig kein Passwort vergeben.
Dann folgenden Befehl eingeben:
killall -9 tuxcald
Jetzt kann man die neuere Version des Daemons '''tuxcald''' per FTP nach '''/var/bin/''' auf die Box kopieren und die ältere Version überschreiben. War dort schon eine ältere Version drin, sollten die Ausführrechte (755) schon passen. Sonst per Telnet diesen Befehl ausführen:
chmod 755 /var/bin/tuxcald
Dann entweder die Box runterfahren und neu starten, oder per Telnet diesen Befehl ausführen:
/var/bin/tuxcald -nodelay
Bitte auch zu beachten, dass man beim Plugin-Update auch immer die passende Version des Plugins '''tuxcal.so''' und '''tuxcal.cfg''' nach '''/var/tuxbox/plugins/''' kopieren muss.
Sollte das Plugin noch nicht in diesem Verzeichnis installiert gewesen sein, per Telnet diesen Befehl ausführen:
chmod 755 /var/tuxbox/plugins/tuxcal.so
Damit wird das Plugin ausführbar gemacht. Jetzt entweder die Box neu starten oder auf der Fernbedienung '''Dbox-Taste - Service - Plugins neu einlesen - Dbox-Taste''' drücken, um das Plugin '''Kalender''' auf der blauen Taste angezeigt zu bekommen.

=Konfiguration=
Damit der [[Daemon]] die Termine überprüfen kann, erzeugt er beim ersten Start die Konfigurationsdatei '''tuxcal.conf''' im Verzeichnis '''/var/tuxbox/config/tuxcal/''', falls diese nicht existiert. Die Datei wird mit Standardwerten vorbelegt, die im Rahmen der Parametergrenzen geändert werden können. Hier können nun die gewünschen Angaben eingetragen, oder alternativ eine fertige Datei vom [[PC]] per [[FTP]] übertragen werden.
Damit diese Datei erzeugt wird, muss das [[Plugins|Plugin]] gestartet werden und der [[Plugins:Kalender#Autostart festlegen|Autostart]] aktiviert werden, danach die [[DBox2]] neu
starten.

Die Datei '''tuxcal.conf''' hat folgenden Aufbau:

{| border="1"
|Eintrag||Bedeutung||mögliche Werte||Standard
|-
|STARTDELAY||Wartezeit bis der [[Daemon]] mit der ersten Abfrage beginnt (die [[GUI]] benötigt einige Zeit zum Starten)||15...60||30
|-
|INTERVALL||Abstand zwischen den Abfragen, bzw. Aktualisierung der Uhr in Sekunden||0...60||1
|-
|LOGGING||loggen bestimmter Ausgaben des [[Daemon]] ||Y / N||Y
|-
|AUDIO||akustische Signalisierung: Benutzerdefinierte 12/24/48KHz PCM Wave-Dateien können unter '''/var/tuxbox/config/tuxcal/''' abgelegt werden. '''tuxcal_birthday.wav''' für Geburtstage '''tuxcal_event.wav''' für Termine, Feiertage, Zeiträume '''tuxcal_timer.wav''' für uhrzeitgenaue Termine||Y / N||Y
|-
|VIDEO||optische Signalisierung (Message: muss per [[Fernbedienung]] bestätigt werden) (Popup: wird nach einiger Zeit automatisch geschlossen)||1 = Plugin starten 2 = [[Enigma]] Popup 3 = [[Neutrino]] Message 4 = [[Neutrino]] Popup 5 = keine Signalisierung||1
|-
|SIGNAL||Signalisierung von Ereignissen, wie sie mit dem Parameter SIGMODE eingestellt wurden||1 = nur von heute 2 = von heute und morgen 3 = bis 2 Tage im voraus 4 = bis 3 Tage im voraus 5 = bis 4 Tage im voraus||1
|-
|SIGMODE||Signalisierung bestimmter Ereignisse||0 = nur Termine und Geburtstage 1 = auch Zeitspannen 2 = 0 + Feiertage 3 = alles||0
|-
|SIGTIME||Signalisierung zu festen Uhrzeiten, zu diesen Zeiten wird die Signalisierung täglich ausgeführt. Es können mehrere Zeiten, getrennt durch ein ; eingetragen werden (max. 5 Zeiten)||00:00 - 23:59||leer
|-
|OSD||TV-Ausgaben in Deutsch oder Englisch||G / E||G
|-
|SKIN||Farbpalette wählen (1=blau, 2=grau)||1...3||1
|-
|WEBPORT||Port des [[Webinterface]] der [[DBox2]] || 1 - 65535||80
|-
|WEBUSER||Benutzername für das [[Webinterface]] der [[DBox2]] ||Text ohne Leerzeichen von bis zu 32 Zeichen||leer
|-
|WEBPASS||Passwort für das [[Webinterface]] der [[DBox2]] ||Text ohne Leerzeichen von bis zu 32 Zeichen||leer
|-
|POS_X||Position für die Bildschirmuhr horizontal (sinnvoll ca. 40 - 550)||0 - 720||500
|-
|POS_Y||Position für die Bildschirmuhr vertikal (sinnvoll ca. 10 - 500)||0 - 540||30
|-
|SHOW||Bildschirmuhr beim Start anzeigen, kann dann nachher im Plugin mit Dbox-Taste ein- oder ausgeschaltet werden||Y / N||Y
|-
|DATE||Bildschirmuhr Anzeige Datum||Y / N||N
|-
|CLOCK||Bildschirmuhr Anzeige Uhrzeit||Y / N||Y
|-
|SEC||Bildschirmuhr Anzeige der Sekunden||Y / N||Y
|-
|SIZE||Bildschirmuhr Größe der Anzeige (S)mall, (N)ormal oder (B)ig||S / N / B||S
|-
|COLOR||Bildschirmuhr Schriftfarbe: 0 Transparent, 1: schwarz, 2: weiß die direkte Angabe (außer 0,1,2 funktioniert aber nur wenn DETECT = N)||0-255||1
|-
|BACK||Bildschirmuhr Hintergrundfarbe: 0 Transparent, 1: schwarz, 2: weiß die direkte Angabe (außer 0,1,2 funktioniert aber nur wenn DETECT = N)||0-255||1
|-
|DETECT||Bildschirmuhr Versuch der Erkennung der gewählten Farbe aus der bestehenden Palette||0 / 1||1
|-
|MAIL||Bildschirmuhr Anzeige von mit [[Plugins:E-Mail|Tuxmail]] empfangener, ungelesener Mails||Y / N||Y
|}

"WEBUSER" und "WEBPASS" können leer gelassen werden, wenn das [[Webinterface]] keine Authorisation erfordert.

==Konfigurationsbeispiel "tuxcal.conf"==
<nowiki>
STARTDELAY=40
INTERVALL=1
LOGGING=Y
AUDIO=Y
VIDEO=3
SIGNAL=3
SIGMODE=0
SIGTIME=12:00;20:15;

OSD=G
SKIN=1

WEBPORT=80
WEBUSER=#
WEBPASS=#

POS_X=75
POS_Y=20
SHOW=Y
DATE=N
CLOCK=Y
SEC=Y
SIZE=S
COLOR=2
BACK=0
DETECT=1
MAIL=Y
</nowiki>

==Datendatei tuxcal.list==
Die Datendatei '''tuxcal.list''' ist eigentlich selbsterklärend:

das Format ist wie folgt:
<Art>;<Datum bzw. Zeitraum>;<Text>
z.B.:

Beispiel für frei definierte Feiertage:

f;26.10.;Nationalfeiertag Österreich;

Beispiele für Zeiträume:

z;10.02.-21.02.;Winterferien;
z;18.04.-25.04.;Osterferien;
z;16.03.2006 07:00-20.03.2006 17:30;Geschäftsreise Italien;

Beispiele für Geburtstage:

g;29.05.;Freundin;
g;25.04.1911;Oma;

Beispiele für Termine:

t;23.05.;Hochzeitstag!!!;
t;03.12.2006;Freundin Blumen schenken!;
t;23.02.2006 14:45;Zahnarzt;

Abkürzungen:
{|
|f||=||Feiertag
|-
|z||=||Zeitraum
|-
|g||=||Geburtstag
|-
|t||=||Termin
|}

Die Datendatei '''tuxcal.list''' kann entweder mit einem Unix-Editor auf dem [[PC]] erstellt werden und dann per [[FTP]] auf die [[DBox2]] nach '''/var/tuxbox/config/tuxcal/''' kopiert werden.
Oder sie kann direkt mit dem integrierten [[Plugins:Kalender#Termin-Editor|Termin-Editor]] auf der [[DBox2]] erstellt und bearbeitet werden.

=Signalisierung=
Die Signalisierung von Terminen ohne Uhrzeit wird ohne weitere Maßnahmen [[Plugins:Kalender#Scriptbeispiel um tuxcald über das Startscript der DBox2 automatisch zu starten|automatisch nur beim Start der DBox2 aus dem Deep-Standby]] oder bei einem Datumswechsel ausgeführt. Außerdem kann über den Parameter '''SIGTIME=12:00;20:15;''' in der '''tuxcal.conf''' zu diesen Uhrzeiten eine automatische Signalisierung ausgeführt werden. Maximal sind 5 Zeiten möglich.
Außerdem besteht die Möglichkeit, durch Einfügen von Befehlen in die Datei '''standby.off''' die Signalisierung auch beim [[Plugins:Kalender#Signalisierung nach Start aus dem Standby|Starten der DBox2 aus dem Standby]] auszuführen. Des Weiteren gibt es noch Möglichkeiten die Signalisierung auch beim [[Plugins:Kalender#Signalisierung während Movieplayer und Audioplayer deaktivieren|Beenden des Movie- bzw. Audioplayers]] auszuführen. Auch das [[Plugins:Kalender#Signalisierung während Aufnahme deaktivieren|Abschalten der Signalisierung während einer Aufnahme]] über die Dateien '''recording.start''' und '''recording.end''' ist möglich, was vor allem für die Benutzer eines Videorecorders oder DVD-Recorders am Scart-Eingang wichtig ist.
Außerdem werden alle aktuellen Termine beim Verlassen des Tuxcal-Plugins optisch und/oder akustisch angezeigt.

==Optische Signalisierung==
Bei der optischen Signalisierung über Popup- oder Message-Fenster werden alle aktuellen Termine abhängig von den Einstellungen in der Datei '''tuxcal.list''' angezeigt. Passen die Termine nicht auf ein Fenster, so taucht rechts im Fenster ein Scrollbalken auf. Mit '''[Runter]''' bzw. '''[Hoch]''' kann dann das nächste bzw. vorherige Fenster anzeigen. '''[Home]''' bzw. '''[Ok]''' schließt dieses Fenster. 
Bei der [[IR-Tastatur]] kann ebenfalls mit '''[Runter]''' bzw. '''[Hoch]''' auf die nächste bzw. vorherige Seite geblättert werden, '''[Pos1]''' schließt das Fenster. 
Es wird empfohlen, in den Einstellungen für [[Neutrino]] beim Parameter '''VIDEO=3''' einzustellen, da bei einem Popup die Anzeige zu schnell wieder verschwindet, bevor man sie lesen kann.

[[Bild:TuxCal16.png|400px]]
[[Bild:TuxCal17.png|400px]]

Wird bei einem Termin die Uhrzeit mit eingetragen, so wird nur dieser Termin zur eingestellten Uhrzeit angezeigt. Man beachte die Bildschirmuhr und die Uhrzeit des Termins. Die Signalisierung erfolgt wirklich genau auf die Sekunde.

[[Bild:Tuxcal15.png|400px]]

==Akustische Signalisierung durch Sounddateien==
Für die akustische Signalisierung können noch spezielle benutzerdefinierte 12/24/48KHz PCM WAV-Dateien nach '''/var/tuxbox/config/tuxcal/''' kopiert werden.

- '''tuxcal_birthday.wav''', für die akustische Benachrichtigung bei Geburtstagen.

- '''tuxcal_timer.wav''', für die akustische Benachrichtigung bei Terminen, die genau auf die Minute signalisiert werden sollen. Dazu ist es notwendig, eine Uhrzeit einzutragen.

- '''tuxcal_event.wav''', für die akustische Benachrichtigung bei den restlichen Ereignissen.

Fertige Sounddateien können im [http://www.jackthegrabber.de/viewtopic.php?t=8809| Jack the Grabber-Forum] heruntergeladen werden.

===Sounddateien verlinken um Platz zu sparen===
Da die Sounddateien relativ groß sind und der Speicherplatz auf der Box begrenzt ist, kann man auch nur eine Sounddatei auf der Box anlegen. Um trotzdem bei allen Ereignissen akustisch informiert zu werden, hat man die Möglichkeit, nur eine Datei z.B. '''tuxcal_event.wav''' nach '''/var/tuxbox/config/tuxcal/''' auf der Box zu speichern. Die anderen Dateien werden mit folgenden Befehlen verlinkt. Dazu per Telnet auf die Box einloggen.

Per Telnet kann man sich unter Windows auf der [[DBox2]] einloggen mit '''[Start]''' '''[Ausführen]''', dann eingeben '''telnet <DBOXIP>''' wobei <DBOXIP> durch die [[IP-Adresse]] der [[DBox2]] zu ersetzen ist, z.B.:
telnet 192.168.0.23
Dann sollte ein Fenster auftauchen, in dem '''login''' drinsteht. Bei
'''login:''' root
'''Password:''' dbox2
eingeben. Die Passworteingabe wird nicht angezeigt, ist also blind einzugeben. Bei YADI-Images ist standardmäßig kein Passwort vergeben.

Dann diese beiden Befehle ausführen:
ln -s /var/tuxbox/config/tuxcal/tuxcal_event.wav /var/tuxbox/config/tuxcal/tuxcal_timer.wav
ln -s /var/tuxbox/config/tuxcal/tuxcal_event.wav /var/tuxbox/config/tuxcal/tuxcal_birthday.wav
Dadurch wurden für die Dateien '''tuxcal_timer.wav''' und '''tuxcal_birthday.wav''' sogenannte Symlinks auf die Datei '''tuxcal_event.wav''' erstellt. Die 2 verlinkten Dateien '''tuxcal_timer.wav''' und '''tuxcal_birthday.wav''' existieren zwar nicht, aber bei ihrem Aufruf wird jetzt die Datei '''tuxcal_event.wav''' abgespielt.

Für zukünftige Versionen ist jedoch geplant, die Sounddateien zu packen, und beim Aufruf nach '''/tmp/''' zu entpacken und sie dann abzuspielen.

===Erstellung der Sounddateien===
Die [[DBox2]] spielt nur Sounddateien in einem speziellen Format ab. Die PCM WAV-Dateien solltet ihr mit dem Audiorecorder unter Windows in 8 oder 16 Bit Mono, 12, 24, oder 48 KHz umwandeln. Stereo geht auch, die Dateien werden dann aber entsprechend größer. Ich empfehle deswegen 8 Bit Mono, 12 KHz.

=Scripte um Tuxcal bei bestimmten Vorgängen auf der Box zu steuern=
Das TuxCal-Plugin lässt sich über verschiedene Scripte auf der [[DBox2]] steuern. Nachfolgend sind einige Beispiel aufgeführt. Alle Scripte müssen im UNIX-Format erstellt werden und benötigen Ausführrechte (755).

==Scriptbeispiel um tuxcald über das Startscript der Box automatisch zu starten==
Ohne einen aktiven [[Daemon]] '''tuxcald''' finden keine Abfragen statt und die Bildschirmuhr wird auch nicht angezeigt. Der [[Plugins:Kalender#Autostart festlegen|Autostart muss vom Nutzer also erst einmal aktiviert werden]], da er standardmäßig deaktiviert ist. Bei jedem Start der [[DBox2]] bzw. [[GUI]] wird er danach automatisch gestartet. Der folgende Code muss entweder in die '''start_neutrino''' oder in die '''rc.S''' bzw. '''rcS.local''' eingetragen werden. Bei [[Enigma]] kommt dieser Code in die '''start_enigma'''.

'''Normalerweise sollte jedoch die folgende Startsequenz mittlerweile in jedem aktuellen Image so eingetragen sein:'''
<nowiki>
if [ -e /var/etc/.tuxcald ]; then
if [ -e /var/bin/tuxcald ]; then
/var/bin/tuxcald &
else
/bin/tuxcald &
fi
fi</nowiki>

Bitte beachten, dass die Eintragung unbedingt mit einem UNIX-Editor (vi, Ultraedit, Crimson-Editor) gemacht werden muss, und dass die Datei auch im UNIX-Format abgespeichert wird. Sonst startet die [[DBox2]] nicht mehr.
Falls das doch einmal passiert, besteht jedoch kein Grund zur Panik. Man kann nämlich immer noch per [[FTP]] oder [[Telnet]] auf die [[DBox2]] zugreifen.
Per [[FTP]] einfach die betreffende Datei nochmal von der [[DBox2]] herunterladen und im UNIX-Format abspeichern. Dann wieder auf die [[DBox2]] laden und diese neu starten. Per Telnet kann man sich unter Windows auf der [[DBox2]] einloggen mit '''[Start]''' '''[Ausführen]''', dann eingeben '''telnet <DBOXIP>''' wobei <DBOXIP> durch die [[IP-Adresse]] der [[DBox2]] zu ersetzen ist, z.B.:
telnet 192.168.0.23
Dann sollte ein Fenster auftauchen, in dem '''login''' drinsteht. Bei
'''login:''' root
'''Password:''' dbox2
eingeben. Die Passworteingabe wird nicht angezeigt, ist also blind einzugeben. Bei YADI-Images ist standardmäßig kein Passwort vergeben.

Dann folgende Befehle eingeben (dies bezieht sich jetzt auf eine fehlerhafte '''start_neutrino''', die in '''/var/tuxbox/''' liegt wie beim [[Image#JtG-Image|Jack-the-Grabber-Image]]. Andere Speicherorte und Dateien im Pfad anpassen):
dos2unix /var/tuxbox/start_neutrino
chmod 755 /var/tuxbox/start_neutrino
reboot
Mit diesem Befehl wird die Datei vom DOS- ins UNIX-Format umgewandelt und Ihr werden Ausführechte vergeben, womit die [[DBox2]] auch wieder klarkommt. Dann wird die [[DBox2]] neu gestartet.

==Signalisierung nach Start aus dem Standby==
Um die Abfrage gleich nach dem Aufwachen aus dem Standby zu aktivieren, kann unter [[Enigma]] das Script '''/var/etc/enigma_leave_standby.sh''' sowie unter [[Neutrino]] das Script '''/var/tuxbox/config/standby.off''' mit dem Inhalt
if [ -e /tmp/tuxcald.pid ]; then kill -hup $(cat /tmp/tuxcald.pid); fi
angelegt werden.

==Signalisierung während Movieplayer und Audioplayer deaktivieren==
Um beim Abspielen von Filmen im [[Neutrino:Movieplayer|Movieplayer]] oder MP3s im [[Neutrino:Audioplayer|Audioplayer]] nicht gestört zu werden, besteht die Möglichkeit den [[Daemon]] während der Wiedergabe vorübergehend abzuschalten, und nach dem Beenden automatisch wieder zu aktivieren. Das Ausschalten von '''tuxcald''' erfolgt über die Scripte '''/var/tuxbox/config/movieplayer.start''' bzw. '''/var/tuxbox/config/audioplayer.start'''. Dort muss folgender Code eingefügt werden:
if [ -e /tmp/tuxcald.pid ]; then kill -usr2 $(cat /tmp/tuxcald.pid); fi
Um den [[Daemon]] '''tuxcald''' nach dem Beenden von Movie- bzw. Audioplayer wieder zu reaktivieren, ist in den Scripten '''/var/tuxbox/config/movieplayer.end''' bzw. '''/var/tuxbox/config/audioplayer.end''' folgender Code einzufügen:
if [ -e /tmp/tuxcald.pid ]; then kill -usr1 $(cat /tmp/tuxcald.pid); fi
Bitte beachten, dass dabei auch Termine, die uhrzeitgesteuert angezeigt werden sollen, erst nach dem Beenden von Movie- bzw. Audioplayer angezeigt werden. Somit besteht das Risiko, einen wichtigen Termin zu verpassen.

==Signalisierung während Aufnahme deaktivieren==
Um beim Aufnehmen von Filmen nicht gestört zu werden, besteht die Möglichkeit den [[Daemon]] während der Aufnahme vorübergehend abzuschalten, und nach dem Beenden automatisch wieder zu aktivieren. Das Ausschalten von '''tuxcald''' erfolgt über das Script '''/var/tuxbox/config/recording.start'''. Dort muss folgender Code eingefügt werden:
if [ -e /tmp/tuxcald.pid ]; then kill -usr2 $(cat /tmp/tuxcald.pid); fi
Um den [[Daemon]] '''tuxcald''' nach dem Beenden der Aufnahme wieder zu reaktivieren, ist im Script '''/var/tuxbox/config/recording.end''' folgender Code einzufügen:
if [ -e /tmp/tuxcald.pid ]; then kill -usr1 $(cat /tmp/tuxcald.pid); fi
Bitte beachten, dass dabei auch Termine, die uhrzeitgesteuert angezeigt werden sollen, erst nach dem Beenden der Aufnahme angezeigt werden. Somit besteht das Risiko, einen wichtigen Termin zu verpassen.

=Bedienung=
Zum Starten des [[Plugins]] '''[BLAU]''' drücken und dann den Eintrag "Kalender" wählen.

Das Plugin zeigt nun den Kalender an.

[[Bild:Tuxcal01.png|400px]]

Das Plugin kann sowohl mit der [[Fernbedienung]], als auch mit der [[IR-Tastatur]] bedient werden.

Die Zeile kann mit '''[HOCH]''' und '''[RUNTER]''' gewechselt werden, die Spalte '''[RECHTS]''' und '''[LINKS]'''. Mit '''[+]''' '''[-]''' bzw. '''[Bild Hoch]''' '''[Bild runter]''' kann der nächste bzw. vorhergehende Monat angezeigt werden. '''[0]''' springt auf das aktuelle Datum.

Durch Druck auf '''[OK]''' bzw. '''[Enter]''' werden die Einträge des aktuellen Tages angezeigt. Man kann hier ebenfalls mit den vorher beschriebenen Tasten navigieren.

[[Bild:TuxCal02.png|400px]]

Durch Betätigen von '''[Gelb]''' bzw. '''[F3]''' kann man einen neuen Termin einfügen, nach Bestätigung mit '''[OK]''' bzw. '''[Enter]''' wird dieser eingefügt, '''[Home]''' bzw. '''[Esc]''' oder '''[Pos1]''' verlässt das Fenster, ohne den Eintrag einzufügen. Wird ein Eintrag eingefügt, so springt der Cursor jetzt auf den eingefügten Termin unten im Fenster. Hier kann noch bei mehreren Einträgen mit '''[HOCH]''' und '''[RUNTER]''' der gewünschte Eintrag gewechselt werden.

[[Bild:TuxCal23.png|300px]]

Durch Betätigen von '''[Rot]''' bzw. '''[F1]''' kann man Einträge nach einer Bestätigung durch '''[OK]''' oder '''[Enter]''' löschen, '''[Home]''' bzw. '''[Esc]''' oder '''[Pos1]''' verlässt das Fenster ohne den Eintrag zu löschen.

[[Bild:TuxCal24.png|300px]]

Durch Betätigen von '''[Grün]''' bzw. '''[F2]''' gelangt man in den Markieren-Modus, wo bei mehreren Einträgen mit '''[HOCH]''' und '''[RUNTER]''' der gewünschte Eintrag gewechselt werden kann.

[[Bild:TuxCal03.png|400px]]

Durch Betätigen von '''[Blau]''' bzw. '''[F4]''' gelangt man in den Termin-Editor.

==Termin-Editor==
Der Termin-Editor kann sowohl mit der [[Fernbedienung]] als auch mit der [[IR-Tastatur]] bedient werden. Mit '''[Rot]''' bzw. '''[F1]''' kann zwischen den verschiedenen Terminarten '''Einträge''', '''Zeitraum''', '''Feiertag''' und '''Geburtstag''' umgeschaltet werden.

Mit '''[Grün]''' bzw. '''[F2]''' wird die Jahreszahl ein- und ausgeblendet.

'''[Gelb]''' bzw. '''[F3]''' blendet die Uhrzeit ein und aus.

Durch Betätigen von '''[Blau]''' bzw. '''[F4]''' wird das Enddatum ein- oder ausgeblendet, was gleichzeitig dem Editieren von Zeiträumen entspricht.

Jetzt können die Einträge gemacht werden. Die Belegung der Tasten für die [[Fernbedienung]] werden links unten im Fenster angezeigt. Mit '''[+]''' und '''[-]''' kann eine einzelne Ziffer oder ein Buchstabe solange durchgescrollt werden, bis er dem gewünschten Ergebnis entspricht.

Mit '''[HOCH]''', '''[RUNTER]''', '''[RECHTS]''' und '''[LINKS]''' kann man in den Eingabefenstern die Positionen wechseln.

Mit '''[OK]''' bzw. '''[Enter]''' wird die Eingabe abgeschlossen. Nochmaliges Betätigen der Tasten '''[OK]''' bzw. '''[Enter]''' speichert den Eintrag ab, wird hier '''[Home]''' bzw. '''[Esc]''' oder '''[Pos1]''' gedrückt, bleibt man im Termin-Editor.

[[Bild:TuxCal19.png|300px]]

Will man den Termin-Editor verlassen, ohne den Termin abzuspeichern, ist zuerst '''[Home]''' bzw. '''[Esc]''' oder '''[Pos1]''' zu betätigen. Dann im folgenden Fenster '''[OK]''' bzw. '''[Enter]''' drücken, um den Termin-Editor zu verlassen, mit '''[Home]''' bzw. '''[Esc]''' oder '''[Pos1]''' bleibt man im Termin-Editor.

[[Bild:TuxCal20.png|300px]]

Bitte beachten, dass die Uhrzeit nur bei den Terminarten '''Eintrag''' und '''Zeitraum''' wirksam ist. Nur in diesen Terminarten wird man also zeitgenau informiert. Bei Geburtstagen wird bei Eingabe einer Jahreszahl das Alter im Fenster angezeigt. Termine, die verjährt sind, werden nicht signalisiert, jedoch werden Termine ohne Angabe einer Jahreszahl jährlich zum eingetragenen Datum signalisiert.

[[Bild:TuxCal04.png|400px]]
[[Bild:TuxCal13.png|400px]]
[[Bild:TuxCal12.png|400px]]
[[Bild:TuxCal14.png|400px]]

==Versionsnummern anzeigen==
Zur Fehlereingrenzung ist die genutzte Version von [[Daemon]] und [[Plugins|Plugin]] wichtig. Diese kann durch Drücken von '''[?]''' bzw. '''[Pause]''' ermittelt werden.

[[Bild:TuxCal05.png|300px]]

==Autostart festlegen==
Über das [[Plugins|Plugin]] kann auch der Start des [[Daemon]] kontrolliert werden. Ein Druck auf '''[STANDBY]''' aktiviert den Autostart, ein weiterer deaktiviert diesen wieder, bei der [[IR-Tastatur]] liegt diese Funktion auf der '''[linken runden schwarzen Taste]''', links neben '''[Esc]'''.

[[Bild:TuxCal06.png|300px]]
[[Bild:TuxCal07.png|300px]]

Vom [[Plugins|Plugin]] wird dabei unter '''/var/etc/''' die Datei '''.tuxcald''' angelegt oder gelöscht. Eine vorhandene '''.tuxcald''' bedeutet, dass der Autostart aktiviert ist. Allerdings muss dies vom Initscript der [[DBox2]] oder dem [[Plugins:Kalender#Scriptbeispiel um tuxcald über das Startscript der Box automatisch zu starten|Startscript]] der jeweiligen [[GUI]] (start_enigma, start_neutrino, start_lcars) ausgewertet werden.

==Uhrzeitanzeige ein- oder ausblenden==
Mit '''[Dbox]''' bzw. '''[Num]''' wird die [[Plugins:Kalender#Bildschirmuhr|Bildschirmuhr]] ein- oder ausgeschaltet. Dies kann auch über das Script [[Plugins:Kalender#Scriptbeispiel um die Bildschirmuhr zu steuern|Bildschirmuhr steuern]] gemacht werden.

[[Bild:TuxCal18.png|300px]]

==Abfrage steuern==
Normalerweise wird der [[Daemon]] beim Start der [[DBox2]] automatisch gestartet und überwacht die Termine. Die Abfrage kann auch mit '''[MUTE]''' gesteuert werden, z.B. wenn man eine Sendung ungestört ansehen oder eine manuelle Prüfung auslösen möchte. Ein Druck schaltet die Abfrage aus, ein weiterer wieder ein. Dabei wird auch die Bildschirmuhr aus- bzw. eingeschaltet.
Die Einträge werden beim Verlassen des Plugins sofort geprüft und alle aktuellen Termine bei aktiviertem [[Daemon]] optisch und akustisch signalisiert.

[[Bild:TuxCal08.png|300px]]
[[Bild:TuxCal09.png|300px]]

==Plugin verlassen==
Das [[Plugins|Plugin]] kann mittels '''[Home]''' bzw. '''[Esc]''' oder '''[Pos1]''' beendet werden. Die Einträge in der '''tuxcal.list''' werden beim Verlassen des [[Plugins]] bei aktivem [[Daemon]] '''tuxcald''' sofort geprüft und alle aktuellen Termine optisch und akustisch signalisiert.

=Kommandozeile=
Der [[Daemon]] '''tuxcald''' kann auch von der Kommandozeile aus gestartet bzw. kontrolliert werden. Folgende Startparameter sind derzeit möglich:

*-nodelay : die Einträge in '''tuxcal.list''' werden sofort nach dem Start abgefragt und das festgelegte STARTDELAY übergangen.
*-syslog : die Informationen werden nicht auf die Konsole ausgegeben, sondern an einen Syslog-Server gesendet.
*-play <audio-Datei> : die angegebene Audio-Datei wird gespielt, der [[Daemon]] wird nicht gestartet.
*-v : die Versionsnummer von '''tuxcald''' wird angezeigt. Der [[Daemon]] wird nicht gestartet.

Um alle Ausgaben des Daemons auf seinen [[PC]] umzuleiten, muss auf der [[DBox2]] mittels
[[syslogd]] -R <[[IP-Adresse]]>
des [[PC]] das Logging aktiviert werden. Auf dem [[PC]] muss natürlich ein [[Syslogd|Syslog]]-Server installiert sein, welcher die Ausgaben entgegen nimmt. Zur lokalen Speicherung auf der [[DBox2]] genügt ein '''syslogd''' ohne Parameter. Die Ausgaben werden so unter '''/var/log/messages''' gespeichert. Alternativ kann durch '''syslogd -O <Pfad der Logdatei>''' auch ein anderer Pfad eingestellt werden.

Sobald der [[Daemon]] läuft kann er über Signale an seine [[PID]] gesteuert werden. Die [[PID]] kann auf 2 Arten ermittelt werden:

*verwenden des Befehls '''ps | grep tuxmcald''' oder '''pidof tuxcald''' und nutzen der kleinsten aufgelisteten [[PID]]
*auslesen aus der Datei '''/tmp/tuxcald.pid''' z.B. mit '''cat /tmp/tuxcald.pid'''

Damit kann nun die Konfiguration aktualisiert, die Kontenabfrage gesteuert oder der [[Daemon]] sauber beendet werden.

==Konfiguration aktualisieren==
Falls zur Laufzeit die Konfiguration geändert wurde, kann der [[Daemon]] die neue Konfiguration einlesen, ohne hierfür extra beendet und neu gestartet zu werden:

kill -HUP <PID> bzw. kill -1 <PID>

==Abfrage steuern==
Die Abfrage kann ebenfalls unterbrochen und wieder gestartet werden, ohne den [[Daemon]] zu beenden.

kill -USR1 <PID> bzw. kill -10 <PID> startet die Abfrage,
kill -USR2 <PID> stoppt die Abfrage,

==Daemon beenden==
Ein sauberes Beenden erfolgt mit diesem Befehl:

kill -TERM <PID> bzw. kill -15 <PID> oder einfach mit kill <PID>

==Scriptbeispiel zum Daemon beenden==
kill -term $(cat /tmp/tuxcald.pid)

==Scriptbeispiel um die Bildschirmuhr zu steuern==
Die [[Plugins:Kalender#Bildschirmuhr|Bildschirmuhr]] kann über dieses Script abwechselnd ein- oder ausgeschaltet werden:

if [ -e /tmp/tuxcald.pid ]; then kill -ALRM $(cat /tmp/tuxcald.pid); fi

Eine andere Möglichkeit die Bildschirmuhr gezielt ein- oder auszublenden, geht über die Schalterdatei '''/tmp/tuxcal.clk'''. Ist die Uhr eingeschaltet, so wird diese Datei angelegt. Will man die Uhr über ein Script ausschalten, so ist diese Datei mit dem Befehl
rm /tmp/tuxcal.clk
zu löschen.
Legt man die Datei mit dem Befehl
touch /tmp/tuxcal.clk
an, so wird die Bildschirmuhr wieder eingeblendet.

=Bildschirmuhr=
Ist der [[Daemon]] '''tuxcald''' aktiviert, und die Konfigurationsdatei '''tuxcal.conf''' wurde entsprechend konfiguriert, wird an der definierten Stelle eine Digitaluhr auf dem Bildschirm eingeblendet. Wenn der Parameter '''MAIL=Y''' eingestellt ist, werden bei neu eingegangenen Mails im [[Plugins:TuxMail|Email-Plugin]], links von der Uhrzeit abwechselnd die Zahl der eingegangenen Mails und ein Briefsymbol angezeigt. Diese Anzeige bleibt solange aktiviert, bis man das [[Plugins:TuxMail|Email-Plugin]] aufruft. Diese Information wird aus der Datei '''tuxmail.new''' in '''/tmp/''' ausgelesen. Die Uhr kann über '''[Dbox]''' bzw. '''[Num]''' im TuxCal-Plugin, wahlweise ein- oder ausgeblendet werden. Außerdem kann die Bildschirmuhr, wenn man sie beim Starten der Box nicht angezeigt haben will, über den Parameter '''SHOW=N''' ausgeblendet werden. Man kann sie dann trotzdem jederzeit im Plugin mit '''[Dbox]''' bzw. '''[Num]''' ein- und wieder ausschalten.

[[Bild:TuxCal10.png|150px]]
[[Bild:TuxCal11.png|150px]]

=Links=

Bitte beachten, dass dieses Wiki für die neueste Version von TuxCal gilt. Aktuell ist am (03.08.2008) Version Plugin 1.08 / Daemon 1.12.

[http://www.jackthegrabber.de/viewtopic.php?t=8637| Download TuxCal-Plugin:] Jedoch nur eine alte Version, da das Plugin im CVS ist, und eigentlich in jedem aktuellen Image eingebaut sein sollte 
[http://www.jackthegrabber.de/viewtopic.php?t=8809| Download Sounddateien:] 
[http://www.jackthegrabber.de/viewtopic.php?t=8637| Diskussion und Fragen:]

Bitte beachten, dass man sich im Jack-the-Grabber-Forum registrieren und einloggen muss, um die Downloadlinks zu sehen. 

[http://www.jackthegrabber.de/profile.php?mode=register&sid=3e1b875d9f1bd483692afa096939d5c9| Registrierung im JTG-Board:]

{{body}}

Datei:TuxMail08.png

2008-08-07T15:25:57Z

DrStoned: hat eine neue Version von „Bild:TuxMail08.png“ hochgeladen: Tuxmail - Autostart deaktiviert

Datei:TuxMail07.png

2008-08-07T15:25:15Z

DrStoned: hat eine neue Version von „Bild:TuxMail07.png“ hochgeladen: Tuxmail - Autostart aktiviert

Datei:TuxMail06.png

2008-08-07T15:24:08Z

DrStoned: hat eine neue Version von „Bild:TuxMail06.png“ hochgeladen: Tuxmail - Abfrage starten

Datei:TuxMail05.png

2008-08-07T15:23:17Z

DrStoned: hat eine neue Version von „Bild:TuxMail05.png“ hochgeladen: Tuxmail - Abfrage gestoppt

Datei:TuxMail13.png

2008-08-07T15:12:24Z

DrStoned: hat eine neue Version von „Bild:TuxMail13.png“ hochgeladen: Tuxmail - falsche Pin-Code Eingabe

Plugins:TuxMail

2008-08-07T14:57:26Z

DrStoned: Fehlende Bilder eingefügt und Hinweis auf fehlende Bilder entfernt

[[Category:Register]]
[[Category:Plugins]]
{{Plugins_sidebar}}
__TOC__

=Allgemeines=
Mit TuxMail ist es möglich bis zu 10 [[POP3]] oder [[IMAP]]-Konten direkt über die [[DBox2]] abzufragen und Informationen wie Datum, Zeit, Absender und Betreff einer Mail über den TV sowie eine Kurzübersicht über das [[LCD]] auszugeben. Mails können ebenfalls über die Box gelesen und geschrieben werden. Das Plugin kann sowohl mit der [[Fernbedienung]], als auch mit der [[IR-Tastatur]] bedient werden. Wenn die erste Zeile einer empfangenen Mail mit der SECURITY Angabe in der Datei tuxmail.conf übereinstimmt, werden alle nachfolgenden Zeilen dieser Mail als Befehle für die Box interpretiert und ausgeführt.

Das Programm besteht aus 2 Teilen:
*dem [[Daemon]] (tuxmaild), welcher im Hintergrund läuft und die Konten in festgelegten Intervallen auf Maileingang prüft und ausgewählte Mail löscht
*dem Plugin (tuxmail.so + tuxmail.cfg), welches die Infos nach Konten sortiert auf dem TV und [[LCD]] darstellt und den [[Daemon]] steuert

Sobald der [[Daemon]] eine neue Mail gefunden hat wird eine optische und/oder akustische Benachrichtigung ausgelöst um dem Nutzer den Maileingang zu signalisieren. Dies kann über ein Nachrichtenfenster erfolgen oder das Plugin kann gleich gestartet werden.

Um bei einer interessanten Sendung nicht gestört zu werden kann die Kontenabfrage über das Plugin angehalten und auch wieder gestartet werden. Damit ist es auch möglich eine manuelle Kontenprüfung außerhalb des festgelegten Intervalls auszulösen.

Sollte sich mal wieder eine unerwünschte Mail verirrt haben kann diese gleich über das Plugin zum Löschen markiert werden - der [[Daemon]] erledigt dann den Rest. Ein einfacher Spamfilter (Absenderadresse bzw. Teiladresse) ist ebenfalls enthalten.

=Konfiguration=
Damit der [[Daemon]] die Konten überprüfen kann benötigt er Angaben wie Mailserver, Nutzername und Passwort. Diese müssen in die Datei tuxmail.conf im Verzeichnis /var/tuxbox/config/tuxmail eingetragen werden.

Der [[Daemon]] erzeugt beim ersten Start das Verzeichnis sowie eine Datei mit Standardwerten falls diese nicht existiert und beendet sich wieder. Hier können nun die erforderlichen Angaben eingetragen oder alternativ eine fertige Datei vom PC per [[FTP]] übertragen werden.

Damit diese Datei erzeugt wird, muss das Plugin gestartet werden und der [[Plugins:TuxMail#Autostart_festlegen|Autostart]] aktiviert werden, danach die Box neu starten.

Mit dem [[Plugins]] kann durch drücken von '''[DBOX]''' die Konfiguration bearbeitet werden.

Die Datei hat folgenden Aufbau:
{| border="1"
|Eintrag||Bedeutung||mögliche Werte||Standard
|-
|STARTDELAY||Wartezeit bis der [[Daemon]] mit der ersten Kontenabfrage beginnt (die [[GUI]] benötigt 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 (Eine benutzerdefinierte 12/24/48KHz PCM Wave-Datei kann unter /var/tuxbox/config/tuxmail/tuxmail.wav abgelegt werden.)||Y / N||Y
|-
|VIDEO||optische Signalisierung (Message: muss per [[Fernbedienung]] bestätigt werden) (Popup: wird nach einiger Zeit automatisch geschlossen)||1 = Plugin starten 2 = [[Enigma]] Popup 3 = [[Neutrino]] Message 4 = [[Neutrino]] Popup 5 = keine Signalisierung||1
|-
|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 wählen (1=blau, 2=grau)||1 / 2||1
|-
|ADMIN||Löschen von Mails erlauben / verbieten ||Y / N||Y
|-
|TYPEFLAG||Wann werden Mails im Plugin grün markiert ||1 .. 3||1
|-
|CONFIGCODE||Sicherheits-PIN (Zugriff auf Konfigurationsmenü erst nach Eingabe möglich)||0000...9999||leer
|-
|MAILCACHE||Mails werden schon bei der Kontoabfrage gelesen und gesichert (0=kein Lesen)||0..99||0
|-
|MAILDIR||In welches Verzeichnis sollen die Mails gesichert werden || /directory/ || /tmp/
|-
|SECURITY||Zeichenfolge die das Ausführen einer Mail bewirkt ||Text ohne Leerzeichen von bis zu 64 Zeichen||leer
|-
|WEBPORT||Port des Webinterface der dbox|| 1 - 65535||80
|-
|WEBUSER||Benutzername für das Webinterface der dbox||Text ohne Leerzeichen von bis zu 32 Zeichen||leer
|-
|WEBPASS||Passwort für 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?||POP3 Maileingangsserver||Text ohne Leerzeichen von bis zu 64 Zeichen||leer
|-
|IMAP?||IMAP 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 möglich, z.B. bei mehreren Familien-Mitgliedern)||0000...9999||leer
|-
|AUTH?||Authentifizierungsmethode für SMTP||0: keine, 1: POP3 Parameter, 2: SUSER? und SPASS?||0
|-
|SUSER?||Nutzername für SMTP||Text ohne Leerzeichen von bis zu 64 Zeichen||leer
|-
|SPASS?||Passwort für SMTP||Text ohne Leerzeichen von bis zu 64 Zeichen||leer
|-
|INBOX?||Ordner für IMAP||Text ohne Leerzeichen von bis zu 64 Zeichen||leer
|}

Die Einträge "STARTDELAY", "INTERVALL", "LOGGING", "LOGMODE", "SAVEDB", "AUDIO", "VIDEO", "LCD", "OSD", "SKIN", "ADMIN" und "WEBxxxx" sind global, d.h. diese Einstellungen gelten für alle Konten und müssen somit nur einmal eingetragen werden.

WEBUSER und WEBPASS können leer gelassen werden, wenn das Webinterface keine Authorisation erfordert.

Für das "?" bei "NAME", "POP3", "IMAP", "USER", "PASS", "SMTP", "FROM", "CODE", "AUTH", "SUSER", "SPASS" und "INBOX" sind Werte von 0...9 möglich. Bei weniger als 10 Konten können die entsprechenden Einträge entfallen oder einfach leer gelassen werden. Es darf nur entweder der Eintrag "POP3" oder der Eintrag "IMAP" verwendet werden. Wenn nicht das Standardport verwendet werden soll ist dies mit "Mailserver:Port" anzugeben. Wird der Eintrag INBOX leer gelassen, wird der Standardwert "INBOX" verwendet.

==Konfigurationsbeispiel "tuxmail.conf"==
STARTDELAY=30
INTERVALL=15
LOGGING=Y
LOGMODE=S
SAVEDB=Y
AUDIO=Y
VIDEO=1
LCD=Y
OSD=G
SKIN=1
ADMIN=Y
TYPEFLAG=1
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=

==Spamfilter aktivieren==
Um lästige Werbemail gleich zu löschen kann der Spamfilter aktiviert werden. Hierfür ist die Datei spamlist im Verzeichnis /var/tuxbox/config/tuxmail anzulegen und bis zu 100 unerwünschte Absenderadressen bzw. Teiladressen einzutragen. Über das Plugin kann das auch automatisch erfolgen.

Die Löschung vom [[Server]] erfolgt hierbei ohne Sicherheitsabfrage! Überlegt also genau was hier eingetragen werden soll: eine Zeile nur mit "@" oder "." löscht mit Sicherheit JEDE Mail...

==Konfigurationsbeispiel "spamlist"==
neu@web.de
mailings@gmx

==Konfigurationsbeispiel "tuxmail.addr"==
freundin@web.de
geliebte@gmx.de
frau@zuhause.de

Das ist ein vordefiniertes Adressbuch, aus dem beim Schreiben einer Mail ausgewählt werden kann.

==Konfigurationsbeispiel "mailtext.01"==
Hallo,
ich sitze derzeit vor dem Fernseher und habe keine Zeit.
cu.
Dein Satreceiver

Das ist ein vordefinierter Mailblock, der beim Schreiben einer Mail ausgewählt werden kann.

==Konfigurationsbeispiel "tuxmail.t9 ???"==
Aachen,Aal,Aas,ab,Abakus...
Baal,Baas,babbeln,Babel...
C...

T9: [[wikipedia:Text_on_9_keys|Text on 9 keys]], eine Erfindung zur vereinfachten Eingabe von SMS bei Handys

T9 ist derzeit noch nicht implementiert

==Bedienung==
Zum Starten des [[Plugins]] '''[BLAU]''' drücken und dann den Eintrag "E-Mail" wählen.

Das Plugin zeigt nun das Konto #0 (oder falls neue Mail vorliegt das erste Konto mit neuer Mail) an.

[[Bild:TuxMail01.png|400px]]

Jede Mail ist farbig gekennzeichnet und hat dabei folgende Bedeutung:

TYPEFLAG=1
{|
|[[Bild:TuxMail02.jpg.png|20px]]||diese Mail ist seit der letzten Kontenabfrage neu hinzugekommen
|-
|[[Bild:TuxMail03.jpg.png|20px]]||diese Mail war bei der letzten Kontenabfrage bereits vorhanden
|-
|[[Bild:TuxMail04.jpg.png|20px]]||diese Mail soll bei der nächsten Kontenabfrage gelöscht werden
|}

TYPEFLAG=2
{|
|[[Bild:TuxMail02.jpg.png|20px]]||es wurde noch keine neue Kontenabfrage durchgeführt seit diese Mail neu hinzugekommen ist
|-
|[[Bild:TuxMail03.jpg.png|20px]]||diese Mail war schon vorhanden seit das Plugin geöffnet wurde und eine neue Kontenabfrage durchgerührt wurde
|-
|[[Bild:TuxMail04.jpg.png|20px]]||diese Mail soll bei der nächsten Kontenabfrage gelöscht werden
|}

TYPEFLAG=3
{|
|[[Bild:TuxMail02.jpg.png|20px]]||diese Mail ist seit dem letzten Öffnen des Plugins neu hinzugekommen
|-
|[[Bild:TuxMail03.jpg.png|20px]]||diese Mail war beim letzten Öffnen des Plugins bereits vorhanden
|-
|[[Bild:TuxMail04.jpg.png|20px]]||diese Mail soll bei der nächsten Kontenabfrage gelöscht werden
|}

==Konto auswählen==
Mit '''[+]''' '''[-]''' bzw. '''[VOLUME +]''' '''[VOLUME -]''' kann das nächste bzw. vorhergehende Konto angezeigt werden. Ungenutzte Konten werden hierbei übersprungen. Eine Direktwahl (auch ungenutzter Konten) erfolgt über '''[0]...[9]'''.

Falls eine PIN für dieses Konto definiert wurde wird diese zunächst abgefragt und muss mit '''[0]'''...'''[9]''' eingegeben oder mit '''[HOME]''' bzw. '''[EXIT]''' abgebrochen werden.

[[Bild:TuxMail11.png|200px]]
[[Bild:TuxMail12.png|200px]]
[[Bild:TuxMail13.png|200px]]
[[Bild:TuxMail14.png|200px]]

Nach 3 Fehlversuchen wird das Konto gesperrt. Ein Zugriff ist erst nach neustarten des Plugins wieder möglich.

==Mail löschen==
Mittels '''[HOCH] [RUNTER]''' kann die vorhergehende bzw. nächste Mail ausgewählt und durch einen Druck auf '''[ROT]''' zum Löschen vorgemerkt werden. Ein weiterer Druck auf '''[ROT]''' hebt die Markierung wieder auf. Seitenweise kann mit '''[RECHTS] [LINKS]''' geblättert werden.

Beim verlassen des [[Plugins]] werden diese Informationen gespeichert und somit aktiv. Die Löschung vom Mailserver erfolgt jedoch erst bei der nächsten Abfrage des Kontos durch den [[Daemon]].

== Mail schreiben ==
Um eine Mail zu schreiben '''[GRÜN]''' drücken.

Der Absender der selektierten Mail wird dabei automatisch als Empfänger eingetragen und der Betreff um "Re: " erweitert.

Vorgefertigte Textblöcke können mit den Namen tuxmail.01, tuxmail.02 usw. in /var/tuxbox/config/tuxmail abgelegt werden.
Eine Adressenliste kann mit dem Namen tuxmail.addr in /var/tuxbox/config/tuxmail abgelegt werden.

Zeichen können mit '''[MUTE]''' gelöscht und mit '''[BLAU]''' bzw. '''[RECHTS]''' eingefügt werden. Die Zeile kann mit '''[HOCH]''' und '''[RUNTER]''' gewechselt werden. Textblöcke bzw. die letzte gelesene EMail können mit '''[+]''' '''[-]''' bzw. '''[VOLUME +]''' '''[VOLUME -]''' gewechselt werden ( im Mode '''Texte''' ), Adressen aus der Adressenliste können ebenfalls mit '''[+]''' '''[-]''' bzw. '''[VOLUME +]''' '''[VOLUME -]''' gewechselt werden wenn die entsprechende Zeile ausgewählt ist.

Die Mail wird mit '''[OK]''' gesendet oder mit '''[HOME]''' bzw. '''[EXIT]''' verworfen.

== Mail lesen ==
Um eine Mail zu lesen '''[GELB]''' drücken.

Die ausgewählte Mail wird nun (ohne sie zu löschen) vom Server geladen bzw. die schon vorher geladene Mail wird ausgewählt und angezeigt. Durch die Anzeige kann mittels '''[LINKS]''' / '''[HOCH]''' und '''[RECHTS]''' / '''[RUNTER]''' geblättert werden. Zurück kommt man mit '''[HOME]''' bzw. '''[EXIT]'''.

== Mail ausführen ==
Wenn die Optionen MAILCACHE und MAILDIR, sowie SECURITY gesetzt sind, wird jede vom [[Daemon]] gelesene Mail ausgewertet. Damit der Inhalt einer Mail ausgeführt wird, muss die erste Zeile dieser Mail exakt mit der in SECURITY definierten Zeichenfolge übereinstimmen. Alle weiteren Zeilen werden dann als Befehle auf der Box exekutiert.

Da Mails beim Lesen vom [[Daemon]] eine maximale Zeilenlänge von 80 Zeichen haben, müssen Befehle, um aus mehreren Zeilen zusammengesetzt werden zu können, am Zeilenende ein '''&''' Zeichen haben.

==Spamfilter erweitern==
Mit '''[BLAU]''' wird die momentan selektierte Mail (Absenderadresse) zur Spamliste hinzugefügt. Sollte bisher noch keine Liste existieren wird diese automatisch angelegt. Gleichzeitig wird die Mail zum Löschen markiert. Sollten sich bereits weitere Mails dieses Absenders in der Datenbank befinden müssen diese manuell gelöscht werden. Das Löschen und das Hinzufügen zur Spamliste kann mit '''[BLAU]''' wieder rückgängig gemacht werden.

[[Bild:TuxMail15.png|200px]]
[[Bild:TuxMail16.png|200px]]

==Kontenabfrage steuern==
Normalerweise wird der [[Daemon]] beim Start der Box automatisch gestartet und fragt die Konten im festgelegten Intervall periodisch ab. Die Abfrage kann auch mit '''[MUTE]''' gesteuert werden, z.B. wenn man eine Sendung ungestört ansehen oder eine manuelle Prüfung auslösen möchte. Ein Druck schaltet die Abfrage aus, ein weiterer wieder ein.

[[Bild:TuxMail05.png|200px]]
[[Bild:TuxMail06.png|200px]]

Die Konten werden beim Reaktivieren der Abfrage sofort geprüft. Einige Mailserver haben jedoch ein minimales Loginintervall (z.B. web.de FreeMail = 15min). Mehrfache Anfragen innerhalb dieser Zeit sind nutzlos und werden vom [[Server]] mit einem entsprechenden Hinweis abgelehnt.

Um im Standby eine Kontenabfrage zu unterbinden kann unter [[Enigma]] das Script "/var/etc/enigma_enter_standby.sh" sowie unter [[Neutrino]] das Script "/var/tuxbox/config/standby.on" mit dem Inhalt "if [ -e /tmp/tuxmaild.pid ]; then kill -usr2 $(cat /tmp/tuxmaild.pid); fi" angelegt werden. Zum Fortsetzen der Kontenabfrage muss unter [[Enigma]] das Script "/var/etc/enigma_leave_standby.sh" sowie unter [[Neutrino]] das Script "/var/tuxbox/config/standby.off" mit dem Inhalt "if [ -e /tmp/tuxmaild.pid ]; then kill -usr1 $(cat /tmp/tuxmaild.pid); fi" angelegt werden.

Die Abfrage wird so mit dem Beginn des Standby pausiert und startet erst beim Beenden des Standby wieder. Eingehende Nachrichten während dieser Zeit werden nun nicht mehr verpasst.

==Versionsnummern anzeigen==
Zur Fehlereingrenzung ist die genutzte Version von Daemon und Plugin wichtig. Diese kann durch drücken von '''[?]''' bzw. '''[INFO]''' ermittelt werden.

==Autostart festlegen==
Über das Plugin kann auch der Start des [[Daemon]] kontrolliert werden. Ein Druck auf '''[STANDBY]''' aktiviert den Autostart, ein weiterer deaktiviert diesen wieder.

[[Bild:TuxMail07.png|200px]]
[[Bild:TuxMail08.png|200px]]

Vom Plugin wird dabei unter /var/etc die Datei .tuxmaild angelegt oder gelöscht. Eine vorhandene .tuxmaild bedeutet das der Autostart aktiviert ist. Allerdings muss dies vom Initscript der [[DBox2]] oder dem Startscript der jeweiligen [[GUI]] (start_enigma, start_neutrino, start_lcars) ausgewertet werden.

==Scriptbeispiel zum Daemon starten==
if [ -e /var/etc/.tuxmaild ]; then /Pfad zum Daemon/tuxmaild; fi

Ohne einen aktiven [[Daemon]] findet keine Kontenabfrage statt und im Plugin wird somit "keine Info verfügbar" angezeigt. Der Autostart muss vom Nutzer also erst einmal aktiviert werden da er standardmäßig deaktiviert ist. Bei jedem Start der [[DBox2]] bzw. [[GUI]] wird er danach automatisch gestartet.

==Plugin verlassen==
Das Plugin kann mittels '''[HOME]''' beendet werden. Dabei werden die Datenbanken upgedatet und der [[Daemon]] kann bei der nächsten Abfrage die zum Löschen selektierte Mail vom [[Server]] entfernen.

=Kommandozeile=
Der [[Daemon]] kann auch von der Kommandozeile aus gestartet bzw. kontrolliert werden. Folgende Startparameter sind derzeit möglich:

*-nodelay : die Konten werden sofort nach dem Start abgefragt und das festgelegte STARTDELAY übergangen
*-syslog : die Informationen werden nicht auf die Konsole ausgegeben sondern an einen Syslog-Server gesendet
*-play <audio-Datei> : die angegebene Audio-Datei wird gespielt, der [[Daemon]] wird nicht gestartet
*-send <Kontonummer> <Empfängeradresse> <Text-Datei> : die angegebene Datei wird mit den Kontoeinstellungen der übergebenen Kontonummer an die Empfängeradresse gesendet, wobei die erste Zeile der Datei als Subject interpretiert wird. Der [[Daemon]] wird nicht gestartet

Um alle Ausgaben des Daemons auf seinen PC umzuleiten muss auf der Box mittels "[[syslogd]] -R <[[IP-Adresse]] des PC>" das Logging aktiviert werden. Auf dem PC muss natürlich ein Syslog-Server installiert sein, welcher die Ausgaben entgegen nimmt. Zur lokalen Speicherung auf der Box genügt ein "syslogd" ohne Parameter. Die Ausgaben werden so unter /var/log/messages gespeichert. Alternativ kann durch "syslogd -O <Pfad der Logdatei>" auch ein anderer Pfad eingestellt werden.

Sobald der [[Daemon]] läuft kann er über Signale an seine [[PID]] gesteuert werden. Die [[PID]] kann auf 2 Arten ermittelt werden:

*verwenden des Befehls "ps | grep tuxmaild" oder "pidof tuxmaild" und nutzen der kleinsten aufgelisteten [[PID]]
*auslesen aus der Datei /tmp/tuxmaild.pid z.B. mit "cat /tmp/tuxmaild.pid"

Damit kann nun die Konfiguration aktualisiert, die Kontenabfrage gesteuert oder der [[Daemon]] sauber beendet werden.

==Konfiguration aktualisieren==
Falls zur Laufzeit die Konfiguration geändert wurde kann der [[Daemon]] die neue Konfiguration einlesen ohne hierfür extra beendet und neugestartet zu werden:

kill -HUP <PID> bzw. kill -1 <PID>

==Kontenabfrage steuern==
Die Kontenprüfung kann ebenfalls unterbrochen und wieder gestartet werden ohne den [[Daemon]] zu beenden.

kill -USR1 <PID> bzw. kill -10 <PID> startet die Kontenprüfung,
kill -USR2 <PID> stoppt die Kontenprüfung,

==Daemon beenden==
Ein sauberes Beenden mit Sicherung der Datenbanken erfolgt mit diesem Befehl:

Kill -TERM <PID> bzw. kill -15 <PID> oder einfach mit kill <PID>

Zur Laufzeit des [[Daemon]] wird pro Konto eine Datenbank geführt, welche alle relevanten Daten enthält. Um den [[Flash]] zu schonen befinden sich diese Datenbanken unter /tmp/tuxmail.n (n = 0...9) im [[RAM]]. Beim Beenden werden diese Dateien nach /var/tuxbox/config/tuxmail gesichert damit diese beim nächsten Start nach /tmp zurückkopiert werden können und somit wieder zur Verfügung stehen.

Damit diese Dateien beim Herunterfahren der Box gesichert werden können, muss der [[Daemon]] sauber beendet werden bevor das [[JFFS2]]-Filesystem ungemountet wird!

==Scriptbeispiel zum Daemon beenden==
kill -term $(cat /tmp/tuxmaild.pid)
sleep 3

=LCD=
==Plugin==
Im [[LCD]] wird eine Übersicht des gewählten Kontos dargestellt. Angezeigt wird der Status des [[Daemon]], die Nummer des Kontos, Zeitpunkt der letzten Abfrage sowie Anzahl neuer und gesamter Mails.

[[Bild:TuxMail09.png]]

Oben links ist erkennbar ob der [[Daemon]] läuft bzw. die Kontenprüfung aktiv oder inaktiv ist. Das Symbol "OFL" bedeutet das der [[Daemon]] derzeit nicht geladen ist (z.B. wenn der Autostart deaktiviert ist) und demzufolge keine Prüfung der Konten erfolgt, "ONL" zeigt an das die Konten im festgelegten Intervall abgefragt werden und bei "PAU" ist die Kontenabfrage derzeit deaktiviert.

Dahinter wird die momentan gewählte Kontonummer angezeigt und im Anschluss daran der Zeitpunkt der letzten Abfrage.

In der unteren Zeile wird nun noch die Anzahl der neuen und gesamten Mails für das Konto ausgegeben.

==Daemon==
Ist die Option "LCD=Y" gesetzt gibt auch der Daemon den Mailstatus auf das [[LCD]] aus.

[[Bild:TuxMail10.png]]

Diese Anzeige bleibt solange aktiv (die Anzahl neuer Mails wird bei jeder Kontenabfrage aktualisiert) bis das Plugin gestartet und wieder beendet wird. Erst mit dieser Aktion wird die Sperrdatei /tmp/lcd.locked gelöscht und die Zählung beginnt wieder bei Null.

Damit ist z.B. sichergestellt, dass bei Abwesenheit keine Mails verpasst werden und bei Rückkehr der aktuelle Status sofort im [[LCD]] sichtbar ist.

Hinweis: Diese Funktion kann nur genutzt werden, wenn die [[GUI]] die Sperrdatei auswertet und bei Vorhandensein das [[LCD]] nicht mehr durch eigene Ausgaben überschreibt!

{{body}}

Datei:TuxMail10.png

2008-08-07T14:53:33Z

DrStoned: hat eine neue Version von „Bild:TuxMail10.png“ hochgeladen: Tuxmail - LCD-Anzeige empfangener Emails

Tuxmail - LCD-Anzeige empfangener Emails

Datei:TuxMail10.png

2008-08-07T14:39:45Z

DrStoned: Tuxmail - LCD-Anzeige empfangener Emails

Tuxmail - LCD-Anzeige empfangener Emails

Datei:TuxMail16.png

2008-08-07T14:38:09Z

DrStoned: Tuxmail - Spamliste Eintrag entfernt

Tuxmail - Spamliste Eintrag entfernt

Datei:TuxMail15.png

2008-08-07T14:37:22Z

DrStoned: Tuxmail - Spamliste Eintrag erweitert

Tuxmail - Spamliste Eintrag erweitert

Datei:TuxMail14.png

2008-08-07T14:36:03Z

DrStoned: Tuxmail - 3x falsche Pin-Code Eingabe Zugriff auf Email-Konto verweigert

Tuxmail - 3x falsche Pin-Code Eingabe
Zugriff auf Email-Konto verweigert

Datei:TuxMail13.png

2008-08-07T14:33:57Z

DrStoned: hat eine neue Version von „Bild:TuxMail13.png“ hochgeladen: Tuxmail - falsche Pin-Code Eingabe

Datei:TuxMail12.png

2008-08-07T14:32:40Z

DrStoned: Tuxmail - Pin-Code Eingabe

Tuxmail - Pin-Code Eingabe

Datei:TuxMail11.png

2008-08-07T14:31:36Z

DrStoned: Tuxmail - Pin-Code Abfrage

Tuxmail - Pin-Code Abfrage

Plugins:Kalender

2008-08-04T19:16:08Z

DrStoned: Restliche Bilder hochgeladen und logische Reihenfolge der Funktionen angepasst

[[Category:Register]]
[[Category:Plugins]]
{{Plugins_sidebar}}
__TOC__

=Allgemeines=
TuxCal ist ein Kalender, mit dem es möglich ist Feiertage, Geburtstage, Termine und Zeiträume auf der [[DBox2]] und auf der [[Dreambox]] zu verwalten. Die wichtigsten Feiertage sind fest im Programm integriert, es können jedoch auch regionale Feiertage eingefügt werden, die nicht fest eingebaut wurden. Der integrierte [[Daemon]] '''tuxcald''' erinnert auf Wunsch optisch und akustisch an die eingetragenen Events (Ereignisse). Somit vergisst man keine wichtigen Termine und Geburtstage mehr. Außerdem kann auch noch eine [[Plugins:Kalender#Bildschirmuhr|Bildschirmuhr]] frei positionierbar auf dem Bildschirm angezeigt werden.

Das Programm besteht aus 2 Teilen:
*dem [[Daemon]] '''tuxcald''', welcher im Hintergrund läuft und die Uhr steuert und die Termine überwacht, und optisch und akustisch signalisiert.
*dem Plugin '''tuxcal.so + tuxcal.cfg''', das den Kalender anzeigt und in dem neue Events verwaltet werden können und das den [[Daemon]] steuert.

Außerdem wird noch eine Datendatei '''tuxcal.list''' verwendet. In ihr werden die Termine, Geburtstage, Zeiträume und frei definierbare Feiertage verwaltet.

Sobald der [[Daemon]] einen neuen Termin gefunden hat, wird eine optische und/oder akustische Benachrichtigung ausgelöst, um den Nutzer darüber zu informieren. Dies kann über ein Nachrichtenfenster erfolgen oder das Plugin kann gleich gestartet werden.

Um bei einer interessanten Sendung nicht gestört zu werden, kann die Abfrage über das [[Plugins|Plugin]] angehalten und auch wieder gestartet werden. Sofern der [[Daemon]] aktiviert ist, werden beim Verlassen des [[Plugins]] alle Feiertage, Geburtstage, Termine und Zeiträume innerhalb des konfigurierten Zeitraums signalisiert.

=Installation=
Folgende Dateien nach '''/var/tuxbox/plugins/''' kopieren:

- '''tuxcal.cfg'''

- '''tuxcal.so'''

und folgende nach '''/var/bin/''':

- '''tuxcald'''

Die Dateien '''tuxcal.so''' und '''tuxcald''' benötigen Ausführrechte (755).

Das Datenfile '''tuxcal.list''' kommt nach '''/var/tuxbox/config/tuxcal/'''.

==Plugin updaten, was ist dabei zu beachten==
Wenn man das Plugin updaten will, ist zu beachten, dass man dazu vorher den Daemon '''tuxcald''' beenden muss, um eine neue Version dieser Datei auf die Box kopieren zu können. Dazu per Telnet unter Windows auf der [[DBox2]] einloggen mit '''[Start]''' '''[Ausführen]''', dann eingeben '''telnet <DBOXIP>''' wobei <DBOXIP> durch die [[IP-Adresse]] der [[DBox2]] zu ersetzen ist, z.B.:
telnet 192.168.0.23
Dann sollte ein Fenster auftauchen, in dem '''login''' drinsteht. Bei
'''login:''' root
'''Password:''' dbox2
eingeben. Die Passworteingabe wird nicht angezeigt, ist also blind einzugeben. Bei YADI-Images ist standardmäßig kein Passwort vergeben.
Dann folgenden Befehl eingeben:
killall -9 tuxcald
Jetzt kann man die neuere Version des Daemons '''tuxcald''' per FTP nach '''/var/bin/''' auf die Box kopieren und die ältere Version überschreiben. War dort schon eine ältere Version drin, sollten die Ausführrechte (755) schon passen. Sonst per Telnet diesen Befehl ausführen:
chmod 755 /var/bin/tuxcald
Dann entweder die Box runterfahren und neu starten, oder per Telnet diesen Befehl ausführen:
/var/bin/tuxcald -nodelay
Bitte auch zu beachten, dass man beim Plugin-Update auch immer die passende Version des Plugins '''tuxcal.so''' und '''tuxcal.cfg''' nach '''/var/tuxbox/plugins/''' kopieren muss.
Sollte das Plugin noch nicht in diesem Verzeichnis installiert gewesen sein, per Telnet diesen Befehl ausführen:
chmod 755 /var/tuxbox/plugins/tuxcal.so
Damit wird das Plugin ausführbar gemacht. Jetzt entweder die Box neu starten oder auf der Fernbedienung '''Dbox-Taste - Service - Plugins neu einlesen - Dbox-Taste''' drücken, um das Plugin '''Kalender''' auf der blauen Taste angezeigt zu bekommen.

=Konfiguration=
Damit der [[Daemon]] die Termine überprüfen kann, erzeugt er beim ersten Start die Konfigurationsdatei '''tuxcal.conf''' im Verzeichnis '''/var/tuxbox/config/tuxcal/''', falls diese nicht existiert. Die Datei wird mit Standardwerten vorbelegt, die im Rahmen der Parametergrenzen geändert werden können. Hier können nun die gewünschen Angaben eingetragen, oder alternativ eine fertige Datei vom [[PC]] per [[FTP]] übertragen werden.
Damit diese Datei erzeugt wird, muss das [[Plugins|Plugin]] gestartet werden und der [[Plugins:Kalender#Autostart festlegen|Autostart]] aktiviert werden, danach die [[DBox2]] neu
starten.

Die Datei '''tuxcal.conf''' hat folgenden Aufbau:

{| border="1"
|Eintrag||Bedeutung||mögliche Werte||Standard
|-
|STARTDELAY||Wartezeit bis der [[Daemon]] mit der ersten Abfrage beginnt (die [[GUI]] benötigt einige Zeit zum Starten)||15...60||30
|-
|INTERVALL||Abstand zwischen den Abfragen, bzw. Aktualisierung der Uhr in Sekunden||0...60||1
|-
|LOGGING||loggen bestimmter Ausgaben des [[Daemon]] ||Y / N||Y
|-
|AUDIO||akustische Signalisierung: Benutzerdefinierte 12/24/48KHz PCM Wave-Dateien können unter '''/var/tuxbox/config/tuxcal/''' abgelegt werden. '''tuxcal_birthday.wav''' für Geburtstage '''tuxcal_event.wav''' für Termine, Feiertage, Zeiträume '''tuxcal_timer.wav''' für uhrzeitgenaue Termine||Y / N||Y
|-
|VIDEO||optische Signalisierung (Message: muss per [[Fernbedienung]] bestätigt werden) (Popup: wird nach einiger Zeit automatisch geschlossen)||1 = Plugin starten 2 = [[Enigma]] Popup 3 = [[Neutrino]] Message 4 = [[Neutrino]] Popup 5 = keine Signalisierung||1
|-
|SIGNAL||Signalisierung von Ereignissen, wie sie mit dem Parameter SIGMODE eingestellt wurden||1 = nur von heute 2 = von heute und morgen 3 = bis 2 Tage im voraus 4 = bis 3 Tage im voraus 5 = bis 4 Tage im voraus||1
|-
|SIGMODE||Signalisierung bestimmter Ereignisse||0 = nur Termine und Geburtstage 1 = auch Zeitspannen 2 = 0 + Feiertage 3 = alles||0
|-
|SIGTIME||Signalisierung zu festen Uhrzeiten, zu diesen Zeiten wird die Signalisierung täglich ausgeführt. Es können mehrere Zeiten, getrennt durch ein ; eingetragen werden (max. 5 Zeiten)||00:00 - 23:59||leer
|-
|OSD||TV-Ausgaben in Deutsch oder Englisch||G / E||G
|-
|SKIN||Farbpalette wählen (1=blau, 2=grau)||1...3||1
|-
|WEBPORT||Port des [[Webinterface]] der [[DBox2]] || 1 - 65535||80
|-
|WEBUSER||Benutzername für das [[Webinterface]] der [[DBox2]] ||Text ohne Leerzeichen von bis zu 32 Zeichen||leer
|-
|WEBPASS||Passwort für das [[Webinterface]] der [[DBox2]] ||Text ohne Leerzeichen von bis zu 32 Zeichen||leer
|-
|POS_X||Position für die Bildschirmuhr horizontal (sinnvoll ca. 40 - 550)||0 - 720||500
|-
|POS_Y||Position für die Bildschirmuhr vertikal (sinnvoll ca. 10 - 500)||0 - 540||30
|-
|SHOW||Bildschirmuhr beim Start anzeigen, kann dann nachher im Plugin mit Dbox-Taste ein- oder ausgeschaltet werden||Y / N||Y
|-
|DATE||Bildschirmuhr Anzeige Datum||Y / N||N
|-
|CLOCK||Bildschirmuhr Anzeige Uhrzeit||Y / N||Y
|-
|SEC||Bildschirmuhr Anzeige der Sekunden||Y / N||Y
|-
|SIZE||Bildschirmuhr Größe der Anzeige (S)mall, (N)ormal oder (B)ig||S / N / B||S
|-
|COLOR||Bildschirmuhr Schriftfarbe: 0 Transparent, 1: schwarz, 2: weiß die direkte Angabe (außer 0,1,2 funktioniert aber nur wenn DETECT = N)||0-255||1
|-
|BACK||Bildschirmuhr Hintergrundfarbe: 0 Transparent, 1: schwarz, 2: weiß die direkte Angabe (außer 0,1,2 funktioniert aber nur wenn DETECT = N)||0-255||1
|-
|DETECT||Bildschirmuhr Versuch der Erkennung der gewählten Farbe aus der bestehenden Palette||0 / 1||1
|-
|MAIL||Bildschirmuhr Anzeige von mit [[Plugins:E-Mail|Tuxmail]] empfangener, ungelesener Mails||Y / N||Y
|}

"WEBUSER" und "WEBPASS" können leer gelassen werden, wenn das [[Webinterface]] keine Authorisation erfordert.

==Konfigurationsbeispiel "tuxcal.conf"==
<nowiki>
STARTDELAY=40
INTERVALL=1
LOGGING=Y
AUDIO=Y
VIDEO=3
SIGNAL=3
SIGMODE=0
SIGTIME=12:00;20:15;

OSD=G
SKIN=1

WEBPORT=80
WEBUSER=#
WEBPASS=#

POS_X=75
POS_Y=20
SHOW=Y
DATE=N
CLOCK=Y
SEC=Y
SIZE=S
COLOR=2
BACK=0
DETECT=1
MAIL=Y
</nowiki>

==Datendatei tuxcal.list==
Die Datendatei '''tuxcal.list''' ist eigentlich selbsterklärend:

das Format ist wie folgt:
<Art>;<Datum bzw. Zeitraum>;<Text>
z.B.:

Beispiel für frei definierte Feiertage:

f;26.10.;Nationalfeiertag Österreich;

Beispiele für Zeiträume:

z;10.02.-21.02.;Winterferien;
z;18.04.-25.04.;Osterferien;
z;16.03.2006 07:00-20.03.2006 17:30;Geschäftsreise Italien;

Beispiele für Geburtstage:

g;29.05.;Freundin;
g;25.04.1911;Oma;

Beispiele für Termine:

t;23.05.;Hochzeitstag!!!;
t;03.12.2006;Freundin Blumen schenken!;
t;23.02.2006 14:45;Zahnarzt;

Abkürzungen:
{|
|f||=||Feiertag
|-
|z||=||Zeitraum
|-
|g||=||Geburtstag
|-
|t||=||Termin
|}

Die Datendatei '''tuxcal.list''' kann entweder mit einem Unix-Editor auf dem [[PC]] erstellt werden und dann per [[FTP]] auf die [[DBox2]] nach '''/var/tuxbox/config/tuxcal/''' kopiert werden.
Oder sie kann direkt mit dem integrierten [[Plugins:Kalender#Termin-Editor|Termin-Editor]] auf der [[DBox2]] erstellt und bearbeitet werden.

=Signalisierung=
Die Signalisierung von Terminen ohne Uhrzeit wird ohne weitere Maßnahmen [[Plugins:Kalender#Scriptbeispiel um tuxcald über das Startscript der DBox2 automatisch zu starten|automatisch nur beim Start der DBox2 aus dem Deep-Standby]] oder bei einem Datumswechsel ausgeführt. Außerdem kann über den Parameter '''SIGTIME=12:00;20:15;''' in der '''tuxcal.conf''' zu diesen Uhrzeiten eine automatische Signalisierung ausgeführt werden. Maximal sind 5 Zeiten möglich.
Außerdem besteht die Möglichkeit, durch Einfügen von Befehlen in die Datei '''standby.off''' die Signalisierung auch beim [[Plugins:Kalender#Signalisierung nach Start aus dem Standby|Starten der DBox2 aus dem Standby]] auszuführen. Des Weiteren gibt es noch Möglichkeiten die Signalisierung auch beim [[Plugins:Kalender#Signalisierung während Movieplayer und Audioplayer deaktivieren|Beenden des Movie- bzw. Audioplayers]] auszuführen. Auch das [[Plugins:Kalender#Signalisierung während Aufnahme deaktivieren|Abschalten der Signalisierung während einer Aufnahme]] über die Dateien '''recording.start''' und '''recording.end''' ist möglich, was vor allem für die Benutzer eines Videorecorders oder DVD-Recorders am Scart-Eingang wichtig ist.
Außerdem werden alle aktuellen Termine beim Verlassen des Tuxcal-Plugins optisch und/oder akustisch angezeigt.

==Optische Signalisierung==
Bei der optischen Signalisierung über Popup- oder Message-Fenster werden alle aktuellen Termine abhängig von den Einstellungen in der Datei '''tuxcal.list''' angezeigt. Passen die Termine nicht auf ein Fenster, so taucht rechts im Fenster ein Scrollbalken auf. Mit '''[Runter]''' bzw. '''[Hoch]''' kann dann das nächste bzw. vorherige Fenster anzeigen. '''[Home]''' bzw. '''[Ok]''' schließt dieses Fenster. 
Bei der [[IR-Tastatur]] kann ebenfalls mit '''[Runter]''' bzw. '''[Hoch]''' auf die nächste bzw. vorherige Seite geblättert werden, '''[Pos1]''' schließt das Fenster. 
Es wird empfohlen, in den Einstellungen für [[Neutrino]] beim Parameter '''VIDEO=3''' einzustellen, da bei einem Popup die Anzeige zu schnell wieder verschwindet, bevor man sie lesen kann.

[[Bild:TuxCal16.png|400px]]
[[Bild:TuxCal17.png|400px]]

Wird bei einem Termin die Uhrzeit mit eingetragen, so wird nur dieser Termin zur eingestellten Uhrzeit angezeigt. Man beachte die Bildschirmuhr und die Uhrzeit des Termins. Die Signalisierung erfolgt wirklich genau auf die Sekunde.

[[Bild:Tuxcal15.png|400px]]

==Akustische Signalisierung durch Sounddateien==
Für die akustische Signalisierung können noch spezielle benutzerdefinierte 12/24/48KHz PCM WAV-Dateien unter '''/var/tuxbox/config/tuxcal/'''

- '''tuxcal_birthday.wav''', für die akustische Benachrichtigung bei Geburtstagen.

- '''tuxcal_timer.wav''', für die akustische Benachrichtigung bei Terminen, die genau auf die Minute signalisiert werden sollen. Dazu ist es notwendig, eine Uhrzeit einzutragen.

- '''tuxcal_event.wav''', für die akustische Benachrichtigung bei den restlichen Ereignissen.

Fertige Sounddateien können im [http://www.jackthegrabber.de/viewtopic.php?t=8809| Jack the Grabber-Forum] heruntergeladen werden.

===Sounddateien verlinken um Platz zu sparen===
Da die Sounddateien relativ groß sind und der Speicherplatz auf der Box begrenzt ist, kann man auch nur eine Sounddatei auf der Box anlegen. Um trotzdem bei allen Ereignissen akustisch informiert zu werden, hat man die Möglichkeit, nur eine Datei z.B. '''tuxcal_event.wav''' nach '''/var/tuxbox/config/tuxcal/''' auf der Box zu speichern. Die anderen Dateien werden mit folgenden Befehlen verlinkt. Dazu per Telnet auf die Box einloggen.

Per Telnet kann man sich unter Windows auf der [[DBox2]] einloggen mit '''[Start]''' '''[Ausführen]''', dann eingeben '''telnet <DBOXIP>''' wobei <DBOXIP> durch die [[IP-Adresse]] der [[DBox2]] zu ersetzen ist, z.B.:
telnet 192.168.0.23
Dann sollte ein Fenster auftauchen, in dem '''login''' drinsteht. Bei
'''login:''' root
'''Password:''' dbox2
eingeben. Die Passworteingabe wird nicht angezeigt, ist also blind einzugeben. Bei YADI-Images ist standardmäßig kein Passwort vergeben.

Dann diese beiden Befehle ausführen:
ln -s /var/tuxbox/config/tuxcal/tuxcal_event.wav /var/tuxbox/config/tuxcal/tuxcal_timer.wav
ln -s /var/tuxbox/config/tuxcal/tuxcal_event.wav /var/tuxbox/config/tuxcal/tuxcal_birthday.wav
Dadurch wurden für die Dateien '''tuxcal_timer.wav''' und '''tuxcal_birthday.wav''' sogenannte Symlinks auf die Datei '''tuxcal_event.wav''' erstellt. Die 2 verlinkten Dateien '''tuxcal_timer.wav''' und '''tuxcal_birthday.wav''' existieren zwar nicht, aber bei ihrem Aufruf wird jetzt die Datei '''tuxcal_event.wav''' abgespielt.

Für zukünftige Versionen ist jedoch geplant, die Sounddateien zu packen, und beim Aufruf nach '''/tmp/''' zu entpacken und sie dann abzuspielen.

===Erstellung der Sounddateien===
Die [[DBox2]] spielt nur Sounddateien in einem speziellen Format ab. Die PCM WAV-Dateien solltet ihr mit dem Audiorecorder unter Windows in 8 oder 16 Bit Mono, 12, 24, oder 48 KHz umwandeln. Stereo geht auch, die Dateien werden dann aber entsprechend größer. Ich empfehle deswegen 8 Bit Mono, 12 KHz.

=Scripte um Tuxcal bei bestimmten Vorgängen auf der Box zu steuern=
Das TuxCal-Plugin lässt sich über verschiedene Scripte auf der [[DBox2]] steuern. Nachfolgend sind einige Beispiel aufgeführt. Alle Scripte müssen im UNIX-Format erstellt werden und benötigen Ausführrechte (755).

==Scriptbeispiel um tuxcald über das Startscript der Box automatisch zu starten==
Ohne einen aktiven [[Daemon]] '''tuxcald''' finden keine Abfragen statt und die Bildschirmuhr wird auch nicht angezeigt. Der [[Plugins:Kalender#Autostart festlegen|Autostart muss vom Nutzer also erst einmal aktiviert werden]], da er standardmäßig deaktiviert ist. Bei jedem Start der [[DBox2]] bzw. [[GUI]] wird er danach automatisch gestartet. Der folgende Code muss entweder in die '''start_neutrino''' oder in die '''rc.S''' bzw. '''rcS.local''' eingetragen werden. Bei [[Enigma]] kommt dieser Code in die '''start_enigma'''.

'''Normalerweise sollte jedoch die folgende Startsequenz mittlerweile in jedem aktuellen Image so eingetragen sein:'''
<nowiki>
if [ -e /var/etc/.tuxcald ]; then
if [ -e /var/bin/tuxcald ]; then
/var/bin/tuxcald &
else
/bin/tuxcald &
fi
fi</nowiki>

Bitte beachten, dass die Eintragung unbedingt mit einem UNIX-Editor (vi, Ultraedit, Crimson-Editor) gemacht werden muss, und dass die Datei auch im UNIX-Format abgespeichert wird. Sonst startet die [[DBox2]] nicht mehr.
Falls das doch einmal passiert, besteht jedoch kein Grund zur Panik. Man kann nämlich immer noch per [[FTP]] oder [[Telnet]] auf die [[DBox2]] zugreifen.
Per [[FTP]] einfach die betreffende Datei nochmal von der [[DBox2]] herunterladen und im UNIX-Format abspeichern. Dann wieder auf die [[DBox2]] laden und diese neu starten. Per Telnet kann man sich unter Windows auf der [[DBox2]] einloggen mit '''[Start]''' '''[Ausführen]''', dann eingeben '''telnet <DBOXIP>''' wobei <DBOXIP> durch die [[IP-Adresse]] der [[DBox2]] zu ersetzen ist, z.B.:
telnet 192.168.0.23
Dann sollte ein Fenster auftauchen, in dem '''login''' drinsteht. Bei
'''login:''' root
'''Password:''' dbox2
eingeben. Die Passworteingabe wird nicht angezeigt, ist also blind einzugeben. Bei YADI-Images ist standardmäßig kein Passwort vergeben.

Dann folgende Befehle eingeben (dies bezieht sich jetzt auf eine fehlerhafte '''start_neutrino''', die in '''/var/tuxbox/''' liegt wie beim [[Image#JtG-Image|Jack-the-Grabber-Image]]. Andere Speicherorte und Dateien im Pfad anpassen):
dos2unix /var/tuxbox/start_neutrino
chmod 755 /var/tuxbox/start_neutrino
reboot
Mit diesem Befehl wird die Datei vom DOS- ins UNIX-Format umgewandelt und Ihr werden Ausführechte vergeben, womit die [[DBox2]] auch wieder klarkommt. Dann wird die [[DBox2]] neu gestartet.

==Signalisierung nach Start aus dem Standby==
Um die Abfrage gleich nach dem Aufwachen aus dem Standby zu aktivieren, kann unter [[Enigma]] das Script '''/var/etc/enigma_leave_standby.sh''' sowie unter [[Neutrino]] das Script '''/var/tuxbox/config/standby.off''' mit dem Inhalt
if [ -e /tmp/tuxcald.pid ]; then kill -hup $(cat /tmp/tuxcald.pid); fi
angelegt werden.

==Signalisierung während Movieplayer und Audioplayer deaktivieren==
Um beim Abspielen von Filmen im [[Neutrino:Movieplayer|Movieplayer]] oder MP3s im [[Neutrino:Audioplayer|Audioplayer]] nicht gestört zu werden, besteht die Möglichkeit den [[Daemon]] während der Wiedergabe vorübergehend abzuschalten, und nach dem Beenden automatisch wieder zu aktivieren. Das Ausschalten von '''tuxcald''' erfolgt über die Scripte '''/var/tuxbox/config/movieplayer.start''' bzw. '''/var/tuxbox/config/audioplayer.start'''. Dort muss folgender Code eingefügt werden:
if [ -e /tmp/tuxcald.pid ]; then kill -usr2 $(cat /tmp/tuxcald.pid); fi
Um den [[Daemon]] '''tuxcald''' nach dem Beenden von Movie- bzw. Audioplayer wieder zu reaktivieren, ist in den Scripten '''/var/tuxbox/config/movieplayer.end''' bzw. '''/var/tuxbox/config/audioplayer.end''' folgender Code einzufügen:
if [ -e /tmp/tuxcald.pid ]; then kill -usr1 $(cat /tmp/tuxcald.pid); fi
Bitte beachten, dass dabei auch Termine, die uhrzeitgesteuert angezeigt werden sollen, erst nach dem Beenden von Movie- bzw. Audioplayer angezeigt werden. Somit besteht das Risiko, einen wichtigen Termin zu verpassen.

==Signalisierung während Aufnahme deaktivieren==
Um beim Aufnehmen von Filmen nicht gestört zu werden, besteht die Möglichkeit den [[Daemon]] während der Aufnahme vorübergehend abzuschalten, und nach dem Beenden automatisch wieder zu aktivieren. Das Ausschalten von '''tuxcald''' erfolgt über das Script '''/var/tuxbox/config/recording.start'''. Dort muss folgender Code eingefügt werden:
if [ -e /tmp/tuxcald.pid ]; then kill -usr2 $(cat /tmp/tuxcald.pid); fi
Um den [[Daemon]] '''tuxcald''' nach dem Beenden der Aufnahme wieder zu reaktivieren, ist im Script '''/var/tuxbox/config/recording.end''' folgender Code einzufügen:
if [ -e /tmp/tuxcald.pid ]; then kill -usr1 $(cat /tmp/tuxcald.pid); fi
Bitte beachten, dass dabei auch Termine, die uhrzeitgesteuert angezeigt werden sollen, erst nach dem Beenden der Aufnahme angezeigt werden. Somit besteht das Risiko, einen wichtigen Termin zu verpassen.

=Bedienung=
Zum Starten des [[Plugins]] '''[BLAU]''' drücken und dann den Eintrag "Kalender" wählen.

Das Plugin zeigt nun den Kalender an.

[[Bild:Tuxcal01.png|400px]]

Das Plugin kann sowohl mit der [[Fernbedienung]], als auch mit der [[IR-Tastatur]] bedient werden.

Die Zeile kann mit '''[HOCH]''' und '''[RUNTER]''' gewechselt werden, die Spalte '''[RECHTS]''' und '''[LINKS]'''. Mit '''[+]''' '''[-]''' bzw. '''[Bild Hoch]''' '''[Bild runter]''' kann der nächste bzw. vorhergehende Monat angezeigt werden. '''[0]''' springt auf das aktuelle Datum.

Durch Druck auf '''[OK]''' bzw. '''[Enter]''' werden die Einträge des aktuellen Tages angezeigt. Man kann hier ebenfalls mit den vorher beschriebenen Tasten navigieren.

[[Bild:TuxCal02.png|400px]]

Durch Betätigen von '''[Gelb]''' bzw. '''[F3]''' kann man einen neuen Termin einfügen, nach Bestätigung mit '''[OK]''' bzw. '''[Enter]''' wird dieser eingefügt, '''[Home]''' bzw. '''[Esc]''' oder '''[Pos1]''' verlässt das Fenster, ohne den Eintrag einzufügen. Wird ein Eintrag eingefügt, so springt der Cursor jetzt auf den eingefügten Termin unten im Fenster. Hier kann noch bei mehreren Einträgen mit '''[HOCH]''' und '''[RUNTER]''' der gewünschte Eintrag gewechselt werden.

[[Bild:TuxCal23.png|300px]]

Durch Betätigen von '''[Rot]''' bzw. '''[F1]''' kann man Einträge nach einer Bestätigung durch '''[OK]''' oder '''[Enter]''' löschen, '''[Home]''' bzw. '''[Esc]''' oder '''[Pos1]''' verlässt das Fenster ohne den Eintrag zu löschen.

[[Bild:TuxCal24.png|300px]]

Durch Betätigen von '''[Grün]''' bzw. '''[F2]''' gelangt man in den Markieren-Modus, wo bei mehreren Einträgen mit '''[HOCH]''' und '''[RUNTER]''' der gewünschte Eintrag gewechselt werden kann.

[[Bild:TuxCal03.png|400px]]

Durch Betätigen von '''[Blau]''' bzw. '''[F4]''' gelangt man in den Termin-Editor.

==Termin-Editor==
Der Termin-Editor kann sowohl mit der [[Fernbedienung]] als auch mit der [[IR-Tastatur]] bedient werden. Mit '''[Rot]''' bzw. '''[F1]''' kann zwischen den verschiedenen Terminarten '''Einträge''', '''Zeitraum''', '''Feiertag''' und '''Geburtstag''' umgeschaltet werden.

Mit '''[Grün]''' bzw. '''[F2]''' wird die Jahreszahl ein- und ausgeblendet.

'''[Gelb]''' bzw. '''[F3]''' blendet die Uhrzeit ein und aus.

Durch Betätigen von '''[Blau]''' bzw. '''[F4]''' wird das Enddatum ein- oder ausgeblendet, was gleichzeitig dem Editieren von Zeiträumen entspricht.

Jetzt können die Einträge gemacht werden. Die Belegung der Tasten für die [[Fernbedienung]] werden links unten im Fenster angezeigt. Mit '''[+]''' und '''[-]''' kann eine einzelne Ziffer oder ein Buchstabe solange durchgescrollt werden, bis er dem gewünschten Ergebnis entspricht.

Mit '''[HOCH]''', '''[RUNTER]''', '''[RECHTS]''' und '''[LINKS]''' kann man in den Eingabefenstern die Positionen wechseln.

Mit '''[OK]''' bzw. '''[Enter]''' wird die Eingabe abgeschlossen. Nochmaliges Betätigen der Tasten '''[OK]''' bzw. '''[Enter]''' speichert den Eintrag ab, wird hier '''[Home]''' bzw. '''[Esc]''' oder '''[Pos1]''' gedrückt, bleibt man im Termin-Editor.

[[Bild:TuxCal19.png|300px]]

Will man den Termin-Editor verlassen, ohne den Termin abzuspeichern, ist zuerst '''[Home]''' bzw. '''[Esc]''' oder '''[Pos1]''' zu betätigen. Dann im folgenden Fenster '''[OK]''' bzw. '''[Enter]''' drücken, um den Termin-Editor zu verlassen, mit '''[Home]''' bzw. '''[Esc]''' oder '''[Pos1]''' bleibt man im Termin-Editor.

[[Bild:TuxCal20.png|300px]]

Bitte beachten, dass die Uhrzeit nur bei den Terminarten '''Eintrag''' und '''Zeitraum''' wirksam ist. Nur in diesen Terminarten wird man also zeitgenau informiert. Bei Geburtstagen wird bei Eingabe einer Jahreszahl das Alter im Fenster angezeigt. Termine, die verjährt sind, werden nicht signalisiert, jedoch werden Termine ohne Angabe einer Jahreszahl jährlich zum eingetragenen Datum signalisiert.

[[Bild:TuxCal04.png|400px]]
[[Bild:TuxCal13.png|400px]]
[[Bild:TuxCal12.png|400px]]
[[Bild:TuxCal14.png|400px]]

==Versionsnummern anzeigen==
Zur Fehlereingrenzung ist die genutzte Version von [[Daemon]] und [[Plugins|Plugin]] wichtig. Diese kann durch Drücken von '''[?]''' bzw. '''[Pause]''' ermittelt werden.

[[Bild:TuxCal05.png|300px]]

==Autostart festlegen==
Über das [[Plugins|Plugin]] kann auch der Start des [[Daemon]] kontrolliert werden. Ein Druck auf '''[STANDBY]''' aktiviert den Autostart, ein weiterer deaktiviert diesen wieder, bei der [[IR-Tastatur]] liegt diese Funktion auf der '''[linken runden schwarzen Taste]''', links neben '''[Esc]'''.

[[Bild:TuxCal06.png|300px]]
[[Bild:TuxCal07.png|300px]]

Vom [[Plugins|Plugin]] wird dabei unter '''/var/etc/''' die Datei '''.tuxcald''' angelegt oder gelöscht. Eine vorhandene '''.tuxcald''' bedeutet, dass der Autostart aktiviert ist. Allerdings muss dies vom Initscript der [[DBox2]] oder dem [[Plugins:Kalender#Scriptbeispiel um tuxcald über das Startscript der Box automatisch zu starten|Startscript]] der jeweiligen [[GUI]] (start_enigma, start_neutrino, start_lcars) ausgewertet werden.

==Uhrzeitanzeige ein- oder ausblenden==
Mit '''[Dbox]''' bzw. '''[Num]''' wird die [[Plugins:Kalender#Bildschirmuhr|Bildschirmuhr]] ein- oder ausgeschaltet. Dies kann auch über das Script [[Plugins:Kalender#Scriptbeispiel um die Bildschirmuhr zu steuern|Bildschirmuhr steuern]] gemacht werden.

[[Bild:TuxCal18.png|300px]]

==Abfrage steuern==
Normalerweise wird der [[Daemon]] beim Start der [[DBox2]] automatisch gestartet und überwacht die Termine. Die Abfrage kann auch mit '''[MUTE]''' gesteuert werden, z.B. wenn man eine Sendung ungestört ansehen oder eine manuelle Prüfung auslösen möchte. Ein Druck schaltet die Abfrage aus, ein weiterer wieder ein. Dabei wird auch die Bildschirmuhr aus- bzw. eingeschaltet.
Die Einträge werden beim Verlassen des Plugins sofort geprüft und alle aktuellen Termine bei aktiviertem [[Daemon]] optisch und akustisch signalisiert.

[[Bild:TuxCal08.png|300px]]
[[Bild:TuxCal09.png|300px]]

==Plugin verlassen==
Das [[Plugins|Plugin]] kann mittels '''[Home]''' bzw. '''[Esc]''' oder '''[Pos1]''' beendet werden. Die Einträge in der '''tuxcal.list''' werden beim Verlassen des [[Plugins]] bei aktivem [[Daemon]] '''tuxcald''' sofort geprüft und alle aktuellen Termine optisch und akustisch signalisiert.

=Kommandozeile=
Der [[Daemon]] '''tuxcald''' kann auch von der Kommandozeile aus gestartet bzw. kontrolliert werden. Folgende Startparameter sind derzeit möglich:

*-nodelay : die Einträge in '''tuxcal.list''' werden sofort nach dem Start abgefragt und das festgelegte STARTDELAY übergangen.
*-syslog : die Informationen werden nicht auf die Konsole ausgegeben, sondern an einen Syslog-Server gesendet.
*-play <audio-Datei> : die angegebene Audio-Datei wird gespielt, der [[Daemon]] wird nicht gestartet.
*-v : die Versionsnummer von '''tuxcald''' wird angezeigt. Der [[Daemon]] wird nicht gestartet.

Um alle Ausgaben des Daemons auf seinen [[PC]] umzuleiten, muss auf der [[DBox2]] mittels
[[syslogd]] -R <[[IP-Adresse]]>
des [[PC]] das Logging aktiviert werden. Auf dem [[PC]] muss natürlich ein [[Syslogd|Syslog]]-Server installiert sein, welcher die Ausgaben entgegen nimmt. Zur lokalen Speicherung auf der [[DBox2]] genügt ein '''syslogd''' ohne Parameter. Die Ausgaben werden so unter '''/var/log/messages''' gespeichert. Alternativ kann durch '''syslogd -O <Pfad der Logdatei>''' auch ein anderer Pfad eingestellt werden.

Sobald der [[Daemon]] läuft kann er über Signale an seine [[PID]] gesteuert werden. Die [[PID]] kann auf 2 Arten ermittelt werden:

*verwenden des Befehls '''ps | grep tuxmcald''' oder '''pidof tuxcald''' und nutzen der kleinsten aufgelisteten [[PID]]
*auslesen aus der Datei '''/tmp/tuxcald.pid''' z.B. mit '''cat /tmp/tuxcald.pid'''

Damit kann nun die Konfiguration aktualisiert, die Kontenabfrage gesteuert oder der [[Daemon]] sauber beendet werden.

==Konfiguration aktualisieren==
Falls zur Laufzeit die Konfiguration geändert wurde, kann der [[Daemon]] die neue Konfiguration einlesen, ohne hierfür extra beendet und neu gestartet zu werden:

kill -HUP <PID> bzw. kill -1 <PID>

==Abfrage steuern==
Die Abfrage kann ebenfalls unterbrochen und wieder gestartet werden, ohne den [[Daemon]] zu beenden.

kill -USR1 <PID> bzw. kill -10 <PID> startet die Abfrage,
kill -USR2 <PID> stoppt die Abfrage,

==Daemon beenden==
Ein sauberes Beenden erfolgt mit diesem Befehl:

kill -TERM <PID> bzw. kill -15 <PID> oder einfach mit kill <PID>

==Scriptbeispiel zum Daemon beenden==
kill -term $(cat /tmp/tuxcald.pid)

==Scriptbeispiel um die Bildschirmuhr zu steuern==
Die [[Plugins:Kalender#Bildschirmuhr|Bildschirmuhr]] kann über dieses Script abwechselnd ein- oder ausgeschaltet werden:

if [ -e /tmp/tuxcald.pid ]; then kill -ALRM $(cat /tmp/tuxcald.pid); fi

Eine andere Möglichkeit die Bildschirmuhr gezielt ein- oder auszublenden, geht über die Schalterdatei '''/tmp/tuxcal.clk'''. Ist die Uhr eingeschaltet, so wird diese Datei angelegt. Will man die Uhr über ein Script ausschalten, so ist diese Datei mit dem Befehl
rm /tmp/tuxcal.clk
zu löschen.
Legt man die Datei mit dem Befehl
touch /tmp/tuxcal.clk
an, so wird die Bildschirmuhr wieder eingeblendet.

=Bildschirmuhr=
Ist der [[Daemon]] '''tuxcald''' aktiviert, und die Konfigurationsdatei '''tuxcal.conf''' wurde entsprechend konfiguriert, wird an der definierten Stelle eine Digitaluhr auf dem Bildschirm eingeblendet. Wenn der Parameter '''MAIL=Y''' eingestellt ist, werden bei neu eingegangenen Mails im [[Plugins:TuxMail|Email-Plugin]], links von der Uhrzeit abwechselnd die Zahl der eingegangenen Mails und ein Briefsymbol angezeigt. Diese Anzeige bleibt solange aktiviert, bis man das [[Plugins:TuxMail|Email-Plugin]] aufruft. Diese Information wird aus der Datei '''tuxmail.new''' in '''/tmp/''' ausgelesen. Die Uhr kann über '''[Dbox]''' bzw. '''[Num]''' im TuxCal-Plugin, wahlweise ein- oder ausgeblendet werden. Außerdem kann die Bildschirmuhr, wenn man sie beim Starten der Box nicht angezeigt haben will, über den Parameter '''SHOW=N''' ausgeblendet werden. Man kann sie dann trotzdem jederzeit im Plugin mit '''[Dbox]''' bzw. '''[Num]''' ein- und wieder ausschalten.

[[Bild:TuxCal10.png|150px]]
[[Bild:TuxCal11.png|150px]]

=Links=

Bitte beachten, dass dieses Wiki für die neueste Version von TuxCal gilt. Aktuell ist am (03.08.2008) Version Plugin 1.08 / Daemon 1.12.

[http://www.jackthegrabber.de/viewtopic.php?t=8637| Download TuxCal-Plugin:] Jedoch nur eine alte Version, da das Plugin im CVS ist, und eigentlich in jedem aktuellen Image eingebaut sein sollte 
[http://www.jackthegrabber.de/viewtopic.php?t=8809| Download Sounddateien:] 
[http://www.jackthegrabber.de/viewtopic.php?t=8637| Diskussion und Fragen:]

Bitte beachten, dass man sich im Jack-the-Grabber-Forum registrieren und einloggen muss, um die Downloadlinks zu sehen. 

[http://www.jackthegrabber.de/profile.php?mode=register&sid=3e1b875d9f1bd483692afa096939d5c9| Registrierung im JTG-Board:]

{{body}}

Datei:TuxCal14.png

2008-08-04T18:38:50Z

DrStoned: hat eine neue Version von „Bild:TuxCal14.png“ hochgeladen: Tuxcal Termineditor Geburtstag

TuxCal Termineditor Geburtstag

Datei:TuxCal14.png

2008-08-04T18:33:30Z

DrStoned: TuxCal Termineditor Geburtstag

TuxCal Termineditor Geburtstag

Datei:TuxCal12.png

2008-08-04T18:32:36Z

DrStoned: TuxCal Termineditor Termin

TuxCal Termineditor Termin

Datei:TuxCal13.png

2008-08-04T18:29:26Z

DrStoned: TuxCal Termineditor Feiertag

TuxCal Termineditor Feiertag

Datei:TuxCal04.png

2008-08-04T18:27:57Z

DrStoned: Tuxcal Termineditor Zeitraum

Tuxcal Termineditor Zeitraum

Plugins:Kalender

2008-08-04T18:26:03Z

DrStoned:

[[Category:Register]]
[[Category:Plugins]]
{{Plugins_sidebar}}
__TOC__

=Allgemeines=
TuxCal ist ein Kalender, mit dem es möglich ist Feiertage, Geburtstage, Termine und Zeiträume auf der [[DBox2]] und auf der [[Dreambox]] zu verwalten. Die wichtigsten Feiertage sind fest im Programm integriert, es können jedoch auch regionale Feiertage eingefügt werden, die nicht fest eingebaut wurden. Der integrierte [[Daemon]] '''tuxcald''' erinnert auf Wunsch optisch und akustisch an die eingetragenen Events (Ereignisse). Somit vergisst man keine wichtigen Termine und Geburtstage mehr. Außerdem kann auch noch eine [[Plugins:Kalender#Bildschirmuhr|Bildschirmuhr]] frei positionierbar auf dem Bildschirm angezeigt werden.

Das Programm besteht aus 2 Teilen:
*dem [[Daemon]] '''tuxcald''', welcher im Hintergrund läuft und die Uhr steuert und die Termine überwacht, und optisch und akustisch signalisiert.
*dem Plugin '''tuxcal.so + tuxcal.cfg''', das den Kalender anzeigt und in dem neue Events verwaltet werden können und das den [[Daemon]] steuert.

Außerdem wird noch eine Datendatei '''tuxcal.list''' verwendet. In ihr werden die Termine, Geburtstage, Zeiträume und frei definierbare Feiertage verwaltet.

Sobald der [[Daemon]] einen neuen Termin gefunden hat, wird eine optische und/oder akustische Benachrichtigung ausgelöst, um den Nutzer darüber zu informieren. Dies kann über ein Nachrichtenfenster erfolgen oder das Plugin kann gleich gestartet werden.

Um bei einer interessanten Sendung nicht gestört zu werden, kann die Abfrage über das [[Plugins|Plugin]] angehalten und auch wieder gestartet werden. Sofern der [[Daemon]] aktiviert ist, werden beim Verlassen des [[Plugins]] alle Feiertage, Geburtstage, Termine und Zeiträume innerhalb des konfigurierten Zeitraums signalisiert.

=Installation=
Folgende Dateien nach '''/var/tuxbox/plugins/''' kopieren:

- '''tuxcal.cfg'''

- '''tuxcal.so'''

und folgende nach '''/var/bin/''':

- '''tuxcald'''

Die Dateien '''tuxcal.so''' und '''tuxcald''' benötigen Ausführrechte (755).

Das Datenfile '''tuxcal.list''' kommt nach '''/var/tuxbox/config/tuxcal/'''.

==Plugin updaten, was ist dabei zu beachten==
Wenn man das Plugin updaten will, ist zu beachten, dass man dazu vorher den Daemon '''tuxcald''' beenden muss, um eine neue Version dieser Datei auf die Box kopieren zu können. Dazu per Telnet unter Windows auf der [[DBox2]] einloggen mit '''[Start]''' '''[Ausführen]''', dann eingeben '''telnet <DBOXIP>''' wobei <DBOXIP> durch die [[IP-Adresse]] der [[DBox2]] zu ersetzen ist, z.B.:
telnet 192.168.0.23
Dann sollte ein Fenster auftauchen, in dem '''login''' drinsteht. Bei
'''login:''' root
'''Password:''' dbox2
eingeben. Die Passworteingabe wird nicht angezeigt, ist also blind einzugeben. Bei YADI-Images ist standardmäßig kein Passwort vergeben.
Dann folgenden Befehl eingeben:
killall -9 tuxcald
Jetzt kann man die neuere Version des Daemons '''tuxcald''' per FTP nach '''/var/bin/''' auf die Box kopieren und die ältere Version überschreiben. War dort schon eine ältere Version drin, sollten die Ausführrechte (755) schon passen. Sonst per Telnet diesen Befehl ausführen:
chmod 755 /var/bin/tuxcald
Dann entweder die Box runterfahren und neu starten, oder per Telnet diesen Befehl ausführen:
/var/bin/tuxcald -nodelay
Bitte auch zu beachten, dass man beim Plugin-Update auch immer die passende Version des Plugins '''tuxcal.so''' und '''tuxcal.cfg''' nach '''/var/tuxbox/plugins/''' kopieren muss.
Sollte das Plugin noch nicht in diesem Verzeichnis installiert gewesen sein, per Telnet diesen Befehl ausführen:
chmod 755 /var/tuxbox/plugins/tuxcal.so
Damit wird das Plugin ausführbar gemacht. Jetzt entweder die Box neu starten oder auf der Fernbedienung '''Dbox-Taste - Service - Plugins neu einlesen - Dbox-Taste''' drücken, um das Plugin '''Kalender''' auf der blauen Taste angezeigt zu bekommen.

=Konfiguration=
Damit der [[Daemon]] die Termine überprüfen kann, erzeugt er beim ersten Start die Konfigurationsdatei '''tuxcal.conf''' im Verzeichnis '''/var/tuxbox/config/tuxcal/''', falls diese nicht existiert. Die Datei wird mit Standardwerten vorbelegt, die im Rahmen der Parametergrenzen geändert werden können. Hier können nun die gewünschen Angaben eingetragen, oder alternativ eine fertige Datei vom [[PC]] per [[FTP]] übertragen werden.
Damit diese Datei erzeugt wird, muss das [[Plugins|Plugin]] gestartet werden und der [[Plugins:Kalender#Autostart festlegen|Autostart]] aktiviert werden, danach die [[DBox2]] neu
starten.

Die Datei '''tuxcal.conf''' hat folgenden Aufbau:

{| border="1"
|Eintrag||Bedeutung||mögliche Werte||Standard
|-
|STARTDELAY||Wartezeit bis der [[Daemon]] mit der ersten Abfrage beginnt (die [[GUI]] benötigt einige Zeit zum Starten)||15...60||30
|-
|INTERVALL||Abstand zwischen den Abfragen, bzw. Aktualisierung der Uhr in Sekunden||0...60||1
|-
|LOGGING||loggen bestimmter Ausgaben des [[Daemon]] ||Y / N||Y
|-
|AUDIO||akustische Signalisierung: Benutzerdefinierte 12/24/48KHz PCM Wave-Dateien können unter '''/var/tuxbox/config/tuxcal/''' abgelegt werden. '''tuxcal_birthday.wav''' für Geburtstage '''tuxcal_event.wav''' für Termine, Feiertage, Zeiträume '''tuxcal_timer.wav''' für uhrzeitgenaue Termine||Y / N||Y
|-
|VIDEO||optische Signalisierung (Message: muss per [[Fernbedienung]] bestätigt werden) (Popup: wird nach einiger Zeit automatisch geschlossen)||1 = Plugin starten 2 = [[Enigma]] Popup 3 = [[Neutrino]] Message 4 = [[Neutrino]] Popup 5 = keine Signalisierung||1
|-
|SIGNAL||Signalisierung von Ereignissen, wie sie mit dem Parameter SIGMODE eingestellt wurden||1 = nur von heute 2 = von heute und morgen 3 = bis 2 Tage im voraus 4 = bis 3 Tage im voraus 5 = bis 4 Tage im voraus||1
|-
|SIGMODE||Signalisierung bestimmter Ereignisse||0 = nur Termine und Geburtstage 1 = auch Zeitspannen 2 = 0 + Feiertage 3 = alles||0
|-
|SIGTIME||Signalisierung zu festen Uhrzeiten, zu diesen Zeiten wird die Signalisierung täglich ausgeführt. Es können mehrere Zeiten, getrennt durch ein ; eingetragen werden (max. 5 Zeiten)||00:00 - 23:59||leer
|-
|OSD||TV-Ausgaben in Deutsch oder Englisch||G / E||G
|-
|SKIN||Farbpalette wählen (1=blau, 2=grau)||1...3||1
|-
|WEBPORT||Port des [[Webinterface]] der [[DBox2]] || 1 - 65535||80
|-
|WEBUSER||Benutzername für das [[Webinterface]] der [[DBox2]] ||Text ohne Leerzeichen von bis zu 32 Zeichen||leer
|-
|WEBPASS||Passwort für das [[Webinterface]] der [[DBox2]] ||Text ohne Leerzeichen von bis zu 32 Zeichen||leer
|-
|POS_X||Position für die Bildschirmuhr horizontal (sinnvoll ca. 40 - 550)||0 - 720||500
|-
|POS_Y||Position für die Bildschirmuhr vertikal (sinnvoll ca. 10 - 500)||0 - 540||30
|-
|SHOW||Bildschirmuhr beim Start anzeigen, kann dann nachher im Plugin mit Dbox-Taste ein- oder ausgeschaltet werden||Y / N||Y
|-
|DATE||Bildschirmuhr Anzeige Datum||Y / N||N
|-
|CLOCK||Bildschirmuhr Anzeige Uhrzeit||Y / N||Y
|-
|SEC||Bildschirmuhr Anzeige der Sekunden||Y / N||Y
|-
|SIZE||Bildschirmuhr Größe der Anzeige (S)mall, (N)ormal oder (B)ig||S / N / B||S
|-
|COLOR||Bildschirmuhr Schriftfarbe: 0 Transparent, 1: schwarz, 2: weiß die direkte Angabe (außer 0,1,2 funktioniert aber nur wenn DETECT = N)||0-255||1
|-
|BACK||Bildschirmuhr Hintergrundfarbe: 0 Transparent, 1: schwarz, 2: weiß die direkte Angabe (außer 0,1,2 funktioniert aber nur wenn DETECT = N)||0-255||1
|-
|DETECT||Bildschirmuhr Versuch der Erkennung der gewählten Farbe aus der bestehenden Palette||0 / 1||1
|-
|MAIL||Bildschirmuhr Anzeige von mit [[Plugins:E-Mail|Tuxmail]] empfangener, ungelesener Mails||Y / N||Y
|}

"WEBUSER" und "WEBPASS" können leer gelassen werden, wenn das [[Webinterface]] keine Authorisation erfordert.

==Konfigurationsbeispiel "tuxcal.conf"==
<nowiki>
STARTDELAY=40
INTERVALL=1
LOGGING=Y
AUDIO=Y
VIDEO=3
SIGNAL=3
SIGMODE=0
SIGTIME=12:00;20:15;

OSD=G
SKIN=1

WEBPORT=80
WEBUSER=#
WEBPASS=#

POS_X=75
POS_Y=20
SHOW=Y
DATE=N
CLOCK=Y
SEC=Y
SIZE=S
COLOR=2
BACK=0
DETECT=1
MAIL=Y
</nowiki>

==Datendatei tuxcal.list==
Die Datendatei '''tuxcal.list''' ist eigentlich selbsterklärend:

das Format ist wie folgt:
<Art>;<Datum bzw. Zeitraum>;<Text>
z.B.:

Beispiel für frei definierte Feiertage:

f;26.10.;Nationalfeiertag Österreich;

Beispiele für Zeiträume:

z;10.02.-21.02.;Winterferien;
z;18.04.-25.04.;Osterferien;
z;16.03.2006 07:00-20.03.2006 17:30;Geschäftsreise Italien;

Beispiele für Geburtstage:

g;29.05.;Freundin;
g;25.04.1911;Oma;

Beispiele für Termine:

t;23.05.;Hochzeitstag!!!;
t;03.12.2006;Freundin Blumen schenken!;
t;23.02.2006 14:45;Zahnarzt;

Abkürzungen:
{|
|f||=||Feiertag
|-
|z||=||Zeitraum
|-
|g||=||Geburtstag
|-
|t||=||Termin
|}

Die Datendatei '''tuxcal.list''' kann entweder mit einem Unix-Editor auf dem [[PC]] erstellt werden und dann per [[FTP]] auf die [[DBox2]] nach '''/var/tuxbox/config/tuxcal/''' kopiert werden.
Oder sie kann direkt mit dem integrierten [[Plugins:Kalender#Termin-Editor|Termin-Editor]] auf der [[DBox2]] erstellt und bearbeitet werden.

=Signalisierung=
Die Signalisierung von Terminen ohne Uhrzeit wird ohne weitere Maßnahmen [[Plugins:Kalender#Scriptbeispiel um tuxcald über das Startscript der DBox2 automatisch zu starten|automatisch nur beim Start der DBox2 aus dem Deep-Standby]] oder bei einem Datumswechsel ausgeführt. Außerdem kann über den Parameter '''SIGTIME=12:00;20:15;''' in der '''tuxcal.conf''' zu diesen Uhrzeiten eine automatische Signalisierung ausgeführt werden. Maximal sind 5 Zeiten möglich.
Außerdem besteht die Möglichkeit, durch Einfügen von Befehlen in die Datei '''standby.off''' die Signalisierung auch beim [[Plugins:Kalender#Signalisierung nach Start aus dem Standby|Starten der DBox2 aus dem Standby]] auszuführen. Des Weiteren gibt es noch Möglichkeiten die Signalisierung auch beim [[Plugins:Kalender#Signalisierung während Movieplayer und Audioplayer deaktivieren|Beenden des Movie- bzw. Audioplayers]] auszuführen. Auch das [[Plugins:Kalender#Signalisierung während Aufnahme deaktivieren|Abschalten der Signalisierung während einer Aufnahme]] über die Dateien '''recording.start''' und '''recording.end''' ist möglich, was vor allem für die Benutzer eines Videorecorders oder DVD-Recorders am Scart-Eingang wichtig ist.
Außerdem werden alle aktuellen Termine beim Verlassen des Tuxcal-Plugins optisch und/oder akustisch angezeigt.

==Optische Signalisierung==
Bei der optischen Signalisierung über Popup- oder Message-Fenster werden alle aktuellen Termine abhängig von den Einstellungen in der Datei '''tuxcal.list''' angezeigt. Passen die Termine nicht auf ein Fenster, so taucht rechts im Fenster ein Scrollbalken auf. Mit '''[Runter]''' bzw. '''[Hoch]''' kann dann das nächste bzw. vorherige Fenster anzeigen. '''[Home]''' bzw. '''[Ok]''' schließt dieses Fenster. 
Bei der [[IR-Tastatur]] kann ebenfalls mit '''[Runter]''' bzw. '''[Hoch]''' auf die nächste bzw. vorherige Seite geblättert werden, '''[Pos1]''' schließt das Fenster. 
Es wird empfohlen, in den Einstellungen für [[Neutrino]] beim Parameter '''VIDEO=3''' einzustellen, da bei einem Popup die Anzeige zu schnell wieder verschwindet, bevor man sie lesen kann.

[[Bild:TuxCal16.png|400px]]
[[Bild:TuxCal17.png|400px]]

Wird bei einem Termin die Uhrzeit mit eingetragen, so wird nur dieser Termin zur eingestellten Uhrzeit angezeigt. Man beachte die Bildschirmuhr und die Uhrzeit des Termins. Die Signalisierung erfolgt wirklich genau auf die Sekunde.

[[Bild:Tuxcal15.png|400px]]

==Akustische Signalisierung durch Sounddateien==
Für die akustische Signalisierung können noch spezielle benutzerdefinierte 12/24/48KHz PCM WAV-Dateien unter '''/var/tuxbox/config/tuxcal/'''

- '''tuxcal_birthday.wav''', für die akustische Benachrichtigung bei Geburtstagen.

- '''tuxcal_timer.wav''', für die akustische Benachrichtigung bei Terminen, die genau auf die Minute signalisiert werden sollen. Dazu ist es notwendig, eine Uhrzeit einzutragen.

- '''tuxcal_event.wav''', für die akustische Benachrichtigung bei den restlichen Ereignissen.

Fertige Sounddateien können im [http://www.jackthegrabber.de/viewtopic.php?t=8809| Jack the Grabber-Forum] heruntergeladen werden.

===Sounddateien verlinken um Platz zu sparen===
Da die Sounddateien relativ groß sind und der Speicherplatz auf der Box begrenzt ist, kann man auch nur eine Sounddatei auf der Box anlegen. Um trotzdem bei allen Ereignissen akustisch informiert zu werden, hat man die Möglichkeit, nur eine Datei z.B. '''tuxcal_event.wav''' nach '''/var/tuxbox/config/tuxcal/''' auf der Box zu speichern. Die anderen Dateien werden mit folgenden Befehlen verlinkt. Dazu per Telnet auf die Box einloggen.

Per Telnet kann man sich unter Windows auf der [[DBox2]] einloggen mit '''[Start]''' '''[Ausführen]''', dann eingeben '''telnet <DBOXIP>''' wobei <DBOXIP> durch die [[IP-Adresse]] der [[DBox2]] zu ersetzen ist, z.B.:
telnet 192.168.0.23
Dann sollte ein Fenster auftauchen, in dem '''login''' drinsteht. Bei
'''login:''' root
'''Password:''' dbox2
eingeben. Die Passworteingabe wird nicht angezeigt, ist also blind einzugeben. Bei YADI-Images ist standardmäßig kein Passwort vergeben.

Dann diese beiden Befehle ausführen:
ln -s /var/tuxbox/config/tuxcal/tuxcal_event.wav /var/tuxbox/config/tuxcal/tuxcal_timer.wav
ln -s /var/tuxbox/config/tuxcal/tuxcal_event.wav /var/tuxbox/config/tuxcal/tuxcal_birthday.wav
Dadurch wurden für die Dateien '''tuxcal_timer.wav''' und '''tuxcal_birthday.wav''' sogenannte Symlinks auf die Datei '''tuxcal_event.wav''' erstellt. Die 2 verlinkten Dateien '''tuxcal_timer.wav''' und '''tuxcal_birthday.wav''' existieren zwar nicht, aber bei ihrem Aufruf wird jetzt die Datei '''tuxcal_event.wav''' abgespielt.

Für zukünftige Versionen ist jedoch geplant, die Sounddateien zu packen, und beim Aufruf nach '''/tmp/''' zu entpacken und sie dann abzuspielen.

===Erstellung der Sounddateien===
Die [[DBox2]] spielt nur Sounddateien in einem speziellen Format ab. Die PCM WAV-Dateien solltet ihr mit dem Audiorecorder unter Windows in 8 oder 16 Bit Mono, 12, 24, oder 48 KHz umwandeln. Stereo geht auch, die Dateien werden dann aber entsprechend größer. Ich empfehle deswegen 8 Bit Mono, 12 KHz.

=Scripte um Tuxcal bei bestimmten Vorgängen auf der Box zu steuern=
Das TuxCal-Plugin lässt sich über verschiedene Scripte auf der [[DBox2]] steuern. Nachfolgend sind einige Beispiel aufgeführt. Alle Scripte müssen im UNIX-Format erstellt werden und benötigen Ausführrechte (755).

==Scriptbeispiel um tuxcald über das Startscript der Box automatisch zu starten==
Ohne einen aktiven [[Daemon]] '''tuxcald''' finden keine Abfragen statt und die Bildschirmuhr wird auch nicht angezeigt. Der [[Plugins:Kalender#Autostart festlegen|Autostart muss vom Nutzer also erst einmal aktiviert werden]], da er standardmäßig deaktiviert ist. Bei jedem Start der [[DBox2]] bzw. [[GUI]] wird er danach automatisch gestartet. Der folgende Code muss entweder in die '''start_neutrino''' oder in die '''rc.S''' bzw. '''rcS.local''' eingetragen werden. Bei [[Enigma]] kommt dieser Code in die '''start_enigma'''.

'''Normalerweise sollte jedoch die folgende Startsequenz mittlerweile in jedem aktuellen Image so eingetragen sein:'''
<nowiki>
if [ -e /var/etc/.tuxcald ]; then
if [ -e /var/bin/tuxcald ]; then
/var/bin/tuxcald &
else
/bin/tuxcald &
fi
fi</nowiki>

Bitte beachten, dass die Eintragung unbedingt mit einem UNIX-Editor (vi, Ultraedit, Crimson-Editor) gemacht werden muss, und dass die Datei auch im UNIX-Format abgespeichert wird. Sonst startet die [[DBox2]] nicht mehr.
Falls das doch einmal passiert, besteht jedoch kein Grund zur Panik. Man kann nämlich immer noch per [[FTP]] oder [[Telnet]] auf die [[DBox2]] zugreifen.
Per [[FTP]] einfach die betreffende Datei nochmal von der [[DBox2]] herunterladen und im UNIX-Format abspeichern. Dann wieder auf die [[DBox2]] laden und diese neu starten. Per Telnet kann man sich unter Windows auf der [[DBox2]] einloggen mit '''[Start]''' '''[Ausführen]''', dann eingeben '''telnet <DBOXIP>''' wobei <DBOXIP> durch die [[IP-Adresse]] der [[DBox2]] zu ersetzen ist, z.B.:
telnet 192.168.0.23
Dann sollte ein Fenster auftauchen, in dem '''login''' drinsteht. Bei
'''login:''' root
'''Password:''' dbox2
eingeben. Die Passworteingabe wird nicht angezeigt, ist also blind einzugeben. Bei YADI-Images ist standardmäßig kein Passwort vergeben.

Dann folgende Befehle eingeben (dies bezieht sich jetzt auf eine fehlerhafte '''start_neutrino''', die in '''/var/tuxbox/''' liegt wie beim [[Image#JtG-Image|Jack-the-Grabber-Image]]. Andere Speicherorte und Dateien im Pfad anpassen):
dos2unix /var/tuxbox/start_neutrino
chmod 755 /var/tuxbox/start_neutrino
reboot
Mit diesem Befehl wird die Datei vom DOS- ins UNIX-Format umgewandelt und Ihr werden Ausführechte vergeben, womit die [[DBox2]] auch wieder klarkommt. Dann wird die [[DBox2]] neu gestartet.

==Signalisierung nach Start aus dem Standby==
Um die Abfrage gleich nach dem Aufwachen aus dem Standby zu aktivieren, kann unter [[Enigma]] das Script '''/var/etc/enigma_leave_standby.sh''' sowie unter [[Neutrino]] das Script '''/var/tuxbox/config/standby.off''' mit dem Inhalt
if [ -e /tmp/tuxcald.pid ]; then kill -hup $(cat /tmp/tuxcald.pid); fi
angelegt werden.

==Signalisierung während Movieplayer und Audioplayer deaktivieren==
Um beim Abspielen von Filmen im [[Neutrino:Movieplayer|Movieplayer]] oder MP3s im [[Neutrino:Audioplayer|Audioplayer]] nicht gestört zu werden, besteht die Möglichkeit den [[Daemon]] während der Wiedergabe vorübergehend abzuschalten, und nach dem Beenden automatisch wieder zu aktivieren. Das Ausschalten von '''tuxcald''' erfolgt über die Scripte '''/var/tuxbox/config/movieplayer.start''' bzw. '''/var/tuxbox/config/audioplayer.start'''. Dort muss folgender Code eingefügt werden:
if [ -e /tmp/tuxcald.pid ]; then kill -usr2 $(cat /tmp/tuxcald.pid); fi
Um den [[Daemon]] '''tuxcald''' nach dem Beenden von Movie- bzw. Audioplayer wieder zu reaktivieren, ist in den Scripten '''/var/tuxbox/config/movieplayer.end''' bzw. '''/var/tuxbox/config/audioplayer.end''' folgender Code einzufügen:
if [ -e /tmp/tuxcald.pid ]; then kill -usr1 $(cat /tmp/tuxcald.pid); fi
Bitte beachten, dass dabei auch Termine, die uhrzeitgesteuert angezeigt werden sollen, erst nach dem Beenden von Movie- bzw. Audioplayer angezeigt werden. Somit besteht das Risiko, einen wichtigen Termin zu verpassen.

==Signalisierung während Aufnahme deaktivieren==
Um beim Aufnehmen von Filmen nicht gestört zu werden, besteht die Möglichkeit den [[Daemon]] während der Aufnahme vorübergehend abzuschalten, und nach dem Beenden automatisch wieder zu aktivieren. Das Ausschalten von '''tuxcald''' erfolgt über das Script '''/var/tuxbox/config/recording.start'''. Dort muss folgender Code eingefügt werden:
if [ -e /tmp/tuxcald.pid ]; then kill -usr2 $(cat /tmp/tuxcald.pid); fi
Um den [[Daemon]] '''tuxcald''' nach dem Beenden der Aufnahme wieder zu reaktivieren, ist im Script '''/var/tuxbox/config/recording.end''' folgender Code einzufügen:
if [ -e /tmp/tuxcald.pid ]; then kill -usr1 $(cat /tmp/tuxcald.pid); fi
Bitte beachten, dass dabei auch Termine, die uhrzeitgesteuert angezeigt werden sollen, erst nach dem Beenden der Aufnahme angezeigt werden. Somit besteht das Risiko, einen wichtigen Termin zu verpassen.

=Bedienung=
Zum Starten des [[Plugins]] '''[BLAU]''' drücken und dann den Eintrag "Kalender" wählen.

Das Plugin zeigt nun den Kalender an.

[[Bild:Tuxcal01.png|400px]]

Das Plugin kann sowohl mit der [[Fernbedienung]], als auch mit der [[IR-Tastatur]] bedient werden.

Die Zeile kann mit '''[HOCH]''' und '''[RUNTER]''' gewechselt werden, die Spalte '''[RECHTS]''' und '''[LINKS]'''. Mit '''[+]''' '''[-]''' bzw. '''[Bild Hoch]''' '''[Bild runter]''' kann der nächste bzw. vorhergehende Monat angezeigt werden. '''[0]''' springt auf das aktuelle Datum.

Durch Druck auf '''[OK]''' bzw. '''[Enter]''' werden die Einträge des aktuellen Tages angezeigt. Man kann hier ebenfalls mit den vorher beschriebenen Tasten navigieren.

[[Bild:TuxCal02.png|400px]]

Durch Betätigen von '''[Gelb]''' bzw. '''[F3]''' kann man einen neuen Termin einfügen, nach Bestätigung mit '''[OK]''' bzw. '''[Enter]''' wird dieser eingefügt, '''[Home]''' bzw. '''[Esc]''' oder '''[Pos1]''' verlässt das Fenster, ohne den Eintrag einzufügen. Wird ein Eintrag eingefügt, so springt der Cursor jetzt auf den eingefügten Termin unten im Fenster. Hier kann noch bei mehreren Einträgen mit '''[HOCH]''' und '''[RUNTER]''' der gewünschte Eintrag gewechselt werden.

[[Bild:TuxCal23.png|300px]]

Durch Betätigen von '''[Rot]''' bzw. '''[F1]''' kann man Einträge nach einer Bestätigung durch '''[OK]''' oder '''[Enter]''' löschen, '''[Home]''' bzw. '''[Esc]''' oder '''[Pos1]''' verlässt das Fenster ohne den Eintrag zu löschen.

[[Bild:TuxCal24.png|300px]]

Durch Betätigen von '''[Grün]''' bzw. '''[F2]''' gelangt man in den Markieren-Modus, wo bei mehreren Einträgen mit '''[HOCH]''' und '''[RUNTER]''' der gewünschte Eintrag gewechselt werden kann.

[[Bild:TuxCal03.png|400px]]

Durch Betätigen von '''[Blau]''' bzw. '''[F4]''' gelangt man in den Termin-Editor.

==Termin-Editor==
Der Termin-Editor kann sowohl mit der [[Fernbedienung]] als auch mit der [[IR-Tastatur]] bedient werden. Mit '''[Rot]''' bzw. '''[F1]''' kann zwischen den verschiedenen Terminarten '''Einträge''', '''Zeitraum''', '''Feiertag''' und '''Geburtstag''' umgeschaltet werden.

Mit '''[Grün]''' bzw. '''[F2]''' wird die Jahreszahl ein- und ausgeblendet.

'''[Gelb]''' bzw. '''[F3]''' blendet die Uhrzeit ein und aus.

Durch Betätigen von '''[Blau]''' bzw. '''[F4]''' wird das Enddatum ein- oder ausgeblendet, was gleichzeitig dem Editieren von Zeiträumen entspricht.

Jetzt können die Einträge gemacht werden. Die Belegung der Tasten für die [[Fernbedienung]] werden links unten im Fenster angezeigt. Mit '''[+]''' und '''[-]''' kann eine einzelne Ziffer oder ein Buchstabe solange durchgescrollt werden, bis er dem gewünschten Ergebnis entspricht.

Mit '''[HOCH]''', '''[RUNTER]''', '''[RECHTS]''' und '''[LINKS]''' kann man in den Eingabefenstern die Positionen wechseln.

Mit '''[OK]''' bzw. '''[Enter]''' wird die Eingabe abgeschlossen. Nochmaliges Betätigen der Tasten '''[OK]''' bzw. '''[Enter]''' speichert den Eintrag ab, wird hier '''[Home]''' bzw. '''[Esc]''' oder '''[Pos1]''' gedrückt, bleibt man im Termin-Editor.

[[Bild:TuxCal19.png|300px]]

Will man den Termin-Editor verlassen, ohne den Termin abzuspeichern, ist zuerst '''[Home]''' bzw. '''[Esc]''' oder '''[Pos1]''' zu betätigen. Dann im folgenden Fenster '''[OK]''' bzw. '''[Enter]''' drücken, um den Termin-Editor zu verlassen, mit '''[Home]''' bzw. '''[Esc]''' oder '''[Pos1]''' bleibt man im Termin-Editor.

[[Bild:TuxCal20.png|300px]]

Bitte beachten, dass die Uhrzeit nur bei den Terminarten '''Eintrag''' und '''Zeitraum''' wirksam ist. Nur in diesen Terminarten wird man also zeitgenau informiert. Bei Geburtstagen wird bei Eingabe einer Jahreszahl das Alter im Fenster angezeigt. Termine, die verjährt sind, werden nicht signalisiert, jedoch werden Termine ohne Angabe einer Jahreszahl jährlich zum eingetragenen Datum signalisiert.

[[Bild:TuxCal04.png|400px]]
[[Bild:TuxCal13.png|400px]]
[[Bild:TuxCal12.png|400px]]
[[Bild:TuxCal14.png|400px]]

==Versionsnummern anzeigen==
Zur Fehlereingrenzung ist die genutzte Version von [[Daemon]] und [[Plugins|Plugin]] wichtig. Diese kann durch Drücken von '''[?]''' bzw. '''[Pause]''' ermittelt werden.

[[Bild:TuxCal05.png|300px]]

==Autostart festlegen==
Über das [[Plugins|Plugin]] kann auch der Start des [[Daemon]] kontrolliert werden. Ein Druck auf '''[STANDBY]''' aktiviert den Autostart, ein weiterer deaktiviert diesen wieder, bei der [[IR-Tastatur]] liegt diese Funktion auf der '''[linken runden schwarzen Taste]''', links neben '''[Esc]'''.

[[Bild:TuxCal06.png|300px]]
[[Bild:TuxCal07.png|300px]]

Vom [[Plugins|Plugin]] wird dabei unter '''/var/etc/''' die Datei '''.tuxcald''' angelegt oder gelöscht. Eine vorhandene '''.tuxcald''' bedeutet, dass der Autostart aktiviert ist. Allerdings muss dies vom Initscript der [[DBox2]] oder dem [[Plugins:Kalender#Scriptbeispiel um tuxcald über das Startscript der Box automatisch zu starten|Startscript]] der jeweiligen [[GUI]] (start_enigma, start_neutrino, start_lcars) ausgewertet werden.

==Uhrzeitanzeige ein- oder ausblenden==
Mit '''[Dbox]''' bzw. '''[Num]''' wird die [[Plugins:Kalender#Bildschirmuhr|Bildschirmuhr]] ein- oder ausgeschaltet. Dies kann auch über das Script [[Plugins:Kalender#Scriptbeispiel um die Bildschirmuhr zu steuern|Bildschirmuhr steuern]] gemacht werden.

[[Bild:TuxCal18.png|300px]]

==Plugin verlassen==
Das [[Plugins|Plugin]] kann mittels '''[Home]''' bzw. '''[Esc]''' oder '''[Pos1]''' beendet werden. Die Einträge in der '''tuxcal.list''' werden beim Verlassen des [[Plugins]] bei aktivem [[Daemon]] '''tuxcald''' sofort geprüft und alle aktuellen Termine optisch und akustisch signalisiert.

==Abfrage steuern==
Normalerweise wird der [[Daemon]] beim Start der [[DBox2]] automatisch gestartet und überwacht die Termine. Die Abfrage kann auch mit '''[MUTE]''' gesteuert werden, z.B. wenn man eine Sendung ungestört ansehen oder eine manuelle Prüfung auslösen möchte. Ein Druck schaltet die Abfrage aus, ein weiterer wieder ein. Dabei wird auch die Bildschirmuhr aus- bzw. eingeschaltet.
Die Einträge werden beim Verlassen des Plugins sofort geprüft und alle aktuellen Termine bei aktiviertem [[Daemon]] optisch und akustisch signalisiert.

[[Bild:TuxCal08.png|300px]]
[[Bild:TuxCal09.png|300px]]

=Kommandozeile=
Der [[Daemon]] '''tuxcald''' kann auch von der Kommandozeile aus gestartet bzw. kontrolliert werden. Folgende Startparameter sind derzeit möglich:

*-nodelay : die Einträge in '''tuxcal.list''' werden sofort nach dem Start abgefragt und das festgelegte STARTDELAY übergangen.
*-syslog : die Informationen werden nicht auf die Konsole ausgegeben, sondern an einen Syslog-Server gesendet.
*-play <audio-Datei> : die angegebene Audio-Datei wird gespielt, der [[Daemon]] wird nicht gestartet.
*-v : die Versionsnummer von '''tuxcald''' wird angezeigt. Der [[Daemon]] wird nicht gestartet.

Um alle Ausgaben des Daemons auf seinen [[PC]] umzuleiten, muss auf der [[DBox2]] mittels
[[syslogd]] -R <[[IP-Adresse]]>
des [[PC]] das Logging aktiviert werden. Auf dem [[PC]] muss natürlich ein [[Syslogd|Syslog]]-Server installiert sein, welcher die Ausgaben entgegen nimmt. Zur lokalen Speicherung auf der [[DBox2]] genügt ein '''syslogd''' ohne Parameter. Die Ausgaben werden so unter '''/var/log/messages''' gespeichert. Alternativ kann durch '''syslogd -O <Pfad der Logdatei>''' auch ein anderer Pfad eingestellt werden.

Sobald der [[Daemon]] läuft kann er über Signale an seine [[PID]] gesteuert werden. Die [[PID]] kann auf 2 Arten ermittelt werden:

*verwenden des Befehls '''ps | grep tuxmcald''' oder '''pidof tuxcald''' und nutzen der kleinsten aufgelisteten [[PID]]
*auslesen aus der Datei '''/tmp/tuxcald.pid''' z.B. mit '''cat /tmp/tuxcald.pid'''

Damit kann nun die Konfiguration aktualisiert, die Kontenabfrage gesteuert oder der [[Daemon]] sauber beendet werden.

==Konfiguration aktualisieren==
Falls zur Laufzeit die Konfiguration geändert wurde, kann der [[Daemon]] die neue Konfiguration einlesen, ohne hierfür extra beendet und neu gestartet zu werden:

kill -HUP <PID> bzw. kill -1 <PID>

==Abfrage steuern==
Die Abfrage kann ebenfalls unterbrochen und wieder gestartet werden, ohne den [[Daemon]] zu beenden.

kill -USR1 <PID> bzw. kill -10 <PID> startet die Abfrage,
kill -USR2 <PID> stoppt die Abfrage,

==Daemon beenden==
Ein sauberes Beenden erfolgt mit diesem Befehl:

kill -TERM <PID> bzw. kill -15 <PID> oder einfach mit kill <PID>

==Scriptbeispiel zum Daemon beenden==
kill -term $(cat /tmp/tuxcald.pid)

==Scriptbeispiel um die Bildschirmuhr zu steuern==
Die [[Plugins:Kalender#Bildschirmuhr|Bildschirmuhr]] kann über dieses Script abwechselnd ein- oder ausgeschaltet werden:

if [ -e /tmp/tuxcald.pid ]; then kill -ALRM $(cat /tmp/tuxcald.pid); fi

Eine andere Möglichkeit die Bildschirmuhr gezielt ein- oder auszublenden, geht über die Schalterdatei '''/tmp/tuxcal.clk'''. Ist die Uhr eingeschaltet, so wird diese Datei angelegt. Will man die Uhr über ein Script ausschalten, so ist diese Datei mit dem Befehl
rm /tmp/tuxcal.clk
zu löschen.
Legt man die Datei mit dem Befehl
touch /tmp/tuxcal.clk
an, so wird die Bildschirmuhr wieder eingeblendet.

=Bildschirmuhr=
Ist der [[Daemon]] '''tuxcald''' aktiviert, und die Konfigurationsdatei '''tuxcal.conf''' wurde entsprechend konfiguriert, wird an der definierten Stelle eine Digitaluhr auf dem Bildschirm eingeblendet. Wenn der Parameter '''MAIL=Y''' eingestellt ist, werden bei neu eingegangenen Mails im [[Plugins:TuxMail|Email-Plugin]], links von der Uhrzeit abwechselnd die Zahl der eingegangenen Mails und ein Briefsymbol angezeigt. Diese Anzeige bleibt solange aktiviert, bis man das [[Plugins:TuxMail|Email-Plugin]] aufruft. Diese Information wird aus der Datei '''tuxmail.new''' in '''/tmp/''' ausgelesen. Die Uhr kann über '''[Dbox]''' bzw. '''[Num]''' im TuxCal-Plugin, wahlweise ein- oder ausgeblendet werden. Außerdem kann die Bildschirmuhr, wenn man sie beim Starten der Box nicht angezeigt haben will, über den Parameter '''SHOW=N''' ausgeblendet werden. Man kann sie dann trotzdem jederzeit im Plugin mit '''[Dbox]''' bzw. '''[Num]''' ein- und wieder ausschalten.

[[Bild:TuxCal10.png|150px]]
[[Bild:TuxCal11.png|150px]]

=Links=

Bitte beachten, dass dieses Wiki für die neueste Version von TuxCal gilt. Aktuell ist am (03.08.2008) Version Plugin 1.08 / Daemon 1.12.

[http://www.jackthegrabber.de/viewtopic.php?t=8637| Download TuxCal-Plugin:] Jedoch nur eine alte Version, da das Plugin im CVS ist, und eigentlich in jedem aktuellen Image eingebaut sein sollte 
[http://www.jackthegrabber.de/viewtopic.php?t=8809| Download Sounddateien:] 
[http://www.jackthegrabber.de/viewtopic.php?t=8637| Diskussion und Fragen:]

Bitte beachten, dass man sich im Jack-the-Grabber-Forum registrieren und einloggen muss, um die Downloadlinks zu sehen. 

[http://www.jackthegrabber.de/profile.php?mode=register&sid=3e1b875d9f1bd483692afa096939d5c9| Registrierung im JTG-Board:]

{{body}}

Plugins:Kalender

2008-08-04T17:30:15Z

DrStoned: Fehlende Bilder hochgeladen und das Wiki an die aktuelle Version von TuxCal angepasst

[[Category:Register]]
[[Category:Plugins]]
{{Plugins_sidebar}}
__TOC__

=Allgemeines=
TuxCal ist ein Kalender, mit dem es möglich ist Feiertage, Geburtstage, Termine und Zeiträume auf der [[DBox2]] und auf der [[Dreambox]] zu verwalten. Die wichtigsten Feiertage sind fest im Programm integriert, es können jedoch auch regionale Feiertage eingefügt werden, die nicht fest eingebaut wurden. Der integrierte [[Daemon]] '''tuxcald''' erinnert auf Wunsch optisch und akustisch an die eingetragenen Events (Ereignisse). Somit vergisst man keine wichtigen Termine und Geburtstage mehr. Außerdem kann auch noch eine [[Plugins:Kalender#Bildschirmuhr|Bildschirmuhr]] frei positionierbar auf dem Bildschirm angezeigt werden.

Das Programm besteht aus 2 Teilen:
*dem [[Daemon]] '''tuxcald''', welcher im Hintergrund läuft und die Uhr steuert und die Termine überwacht, und optisch und akustisch signalisiert.
*dem Plugin '''tuxcal.so + tuxcal.cfg''', das den Kalender anzeigt und in dem neue Events verwaltet werden können und das den [[Daemon]] steuert.

Außerdem wird noch eine Datendatei '''tuxcal.list''' verwendet. In ihr werden die Termine, Geburtstage, Zeiträume und frei definierbare Feiertage verwaltet.

Sobald der [[Daemon]] einen neuen Termin gefunden hat, wird eine optische und/oder akustische Benachrichtigung ausgelöst, um den Nutzer darüber zu informieren. Dies kann über ein Nachrichtenfenster erfolgen oder das Plugin kann gleich gestartet werden.

Um bei einer interessanten Sendung nicht gestört zu werden, kann die Abfrage über das [[Plugins|Plugin]] angehalten und auch wieder gestartet werden. Sofern der [[Daemon]] aktiviert ist, werden beim Verlassen des [[Plugins]] alle Feiertage, Geburtstage, Termine und Zeiträume innerhalb des konfigurierten Zeitraums signalisiert.

=Installation=
Folgende Dateien nach '''/var/tuxbox/plugins/''' kopieren:

- '''tuxcal.cfg'''

- '''tuxcal.so'''

und folgende nach '''/var/bin/''':

- '''tuxcald'''

Die Dateien '''tuxcal.so''' und '''tuxcald''' benötigen Ausführrechte (755).

Das Datenfile '''tuxcal.list''' kommt nach '''/var/tuxbox/config/tuxcal/'''.

==Plugin updaten, was ist dabei zu beachten==
Wenn man das Plugin updaten will, ist zu beachten, dass man dazu vorher den Daemon '''tuxcald''' beenden muss, um eine neue Version dieser Datei auf die Box kopieren zu können. Dazu per Telnet unter Windows auf der [[DBox2]] einloggen mit '''[Start]''' '''[Ausführen]''', dann eingeben '''telnet <DBOXIP>''' wobei <DBOXIP> durch die [[IP-Adresse]] der [[DBox2]] zu ersetzen ist, z.B.:
telnet 192.168.0.23
Dann sollte ein Fenster auftauchen, in dem '''login''' drinsteht. Bei
'''login:''' root
'''Password:''' dbox2
eingeben. Die Passworteingabe wird nicht angezeigt, ist also blind einzugeben. Bei YADI-Images ist standardmäßig kein Passwort vergeben.
Dann folgenden Befehl eingeben:
killall -9 tuxcald
Jetzt kann man die neuere Version des Daemons '''tuxcald''' per FTP nach '''/var/bin/''' auf die Box kopieren und die ältere Version überschreiben. War dort schon eine ältere Version drin, sollten die Ausführrechte (755) schon passen. Sonst per Telnet diesen Befehl ausführen:
chmod 755 /var/bin/tuxcald
Dann entweder die Box runterfahren und neu starten, oder per Telnet diesen Befehl ausführen:
/var/bin/tuxcald -nodelay
Bitte auch zu beachten, dass man beim Plugin-Update auch immer die passende Version des Plugins '''tuxcal.so''' und '''tuxcal.cfg''' nach '''/var/tuxbox/plugins/''' kopieren muss.
Sollte das Plugin noch nicht in diesem Verzeichnis installiert gewesen sein, per Telnet diesen Befehl ausführen:
chmod 755 /var/tuxbox/plugins/tuxcal.so
Damit wird das Plugin ausführbar gemacht. Jetzt entweder die Box neu starten oder auf der Fernbedienung '''Dbox-Taste - Service - Plugins neu einlesen - Dbox-Taste''' drücken, um das Plugin '''Kalender''' auf der blauen Taste angezeigt zu bekommen.

=Konfiguration=
Damit der [[Daemon]] die Termine überprüfen kann, erzeugt er beim ersten Start die Konfigurationsdatei '''tuxcal.conf''' im Verzeichnis '''/var/tuxbox/config/tuxcal/''', falls diese nicht existiert. Die Datei wird mit Standardwerten vorbelegt, die im Rahmen der Parametergrenzen geändert werden können. Hier können nun die gewünschen Angaben eingetragen, oder alternativ eine fertige Datei vom [[PC]] per [[FTP]] übertragen werden.
Damit diese Datei erzeugt wird, muss das [[Plugins|Plugin]] gestartet werden und der [[Plugins:Kalender#Autostart festlegen|Autostart]] aktiviert werden, danach die [[DBox2]] neu
starten.

Die Datei '''tuxcal.conf''' hat folgenden Aufbau:

{| border="1"
|Eintrag||Bedeutung||mögliche Werte||Standard
|-
|STARTDELAY||Wartezeit bis der [[Daemon]] mit der ersten Abfrage beginnt (die [[GUI]] benötigt einige Zeit zum Starten)||15...60||30
|-
|INTERVALL||Abstand zwischen den Abfragen, bzw. Aktualisierung der Uhr in Sekunden||0...60||1
|-
|LOGGING||loggen bestimmter Ausgaben des [[Daemon]] ||Y / N||Y
|-
|AUDIO||akustische Signalisierung: Benutzerdefinierte 12/24/48KHz PCM Wave-Dateien können unter '''/var/tuxbox/config/tuxcal/''' abgelegt werden. '''tuxcal_birthday.wav''' für Geburtstage '''tuxcal_event.wav''' für Termine, Feiertage, Zeiträume '''tuxcal_timer.wav''' für uhrzeitgenaue Termine||Y / N||Y
|-
|VIDEO||optische Signalisierung (Message: muss per [[Fernbedienung]] bestätigt werden) (Popup: wird nach einiger Zeit automatisch geschlossen)||1 = Plugin starten 2 = [[Enigma]] Popup 3 = [[Neutrino]] Message 4 = [[Neutrino]] Popup 5 = keine Signalisierung||1
|-
|SIGNAL||Signalisierung von Ereignissen, wie sie mit dem Parameter SIGMODE eingestellt wurden||1 = nur von heute 2 = von heute und morgen 3 = bis 2 Tage im voraus 4 = bis 3 Tage im voraus 5 = bis 4 Tage im voraus||1
|-
|SIGMODE||Signalisierung bestimmter Ereignisse||0 = nur Termine und Geburtstage 1 = auch Zeitspannen 2 = 0 + Feiertage 3 = alles||0
|-
|SIGTIME||Signalisierung zu festen Uhrzeiten, zu diesen Zeiten wird die Signalisierung täglich ausgeführt. Es können mehrere Zeiten, getrennt durch ein ; eingetragen werden (max. 5 Zeiten)||00:00 - 23:59||leer
|-
|OSD||TV-Ausgaben in Deutsch oder Englisch||G / E||G
|-
|SKIN||Farbpalette wählen (1=blau, 2=grau)||1...3||1
|-
|WEBPORT||Port des [[Webinterface]] der [[DBox2]] || 1 - 65535||80
|-
|WEBUSER||Benutzername für das [[Webinterface]] der [[DBox2]] ||Text ohne Leerzeichen von bis zu 32 Zeichen||leer
|-
|WEBPASS||Passwort für das [[Webinterface]] der [[DBox2]] ||Text ohne Leerzeichen von bis zu 32 Zeichen||leer
|-
|POS_X||Position für die Bildschirmuhr horizontal (sinnvoll ca. 40 - 550)||0 - 720||500
|-
|POS_Y||Position für die Bildschirmuhr vertikal (sinnvoll ca. 10 - 500)||0 - 540||30
|-
|SHOW||Bildschirmuhr beim Start anzeigen, kann dann nachher im Plugin mit Dbox-Taste ein- oder ausgeschaltet werden||Y / N||Y
|-
|DATE||Bildschirmuhr Anzeige Datum||Y / N||N
|-
|CLOCK||Bildschirmuhr Anzeige Uhrzeit||Y / N||Y
|-
|SEC||Bildschirmuhr Anzeige der Sekunden||Y / N||Y
|-
|SIZE||Bildschirmuhr Größe der Anzeige (S)mall, (N)ormal oder (B)ig||S / N / B||S
|-
|COLOR||Bildschirmuhr Schriftfarbe: 0 Transparent, 1: schwarz, 2: weiß die direkte Angabe (außer 0,1,2 funktioniert aber nur wenn DETECT = N)||0-255||1
|-
|BACK||Bildschirmuhr Hintergrundfarbe: 0 Transparent, 1: schwarz, 2: weiß die direkte Angabe (außer 0,1,2 funktioniert aber nur wenn DETECT = N)||0-255||1
|-
|DETECT||Bildschirmuhr Versuch der Erkennung der gewählten Farbe aus der bestehenden Palette||0 / 1||1
|-
|MAIL||Bildschirmuhr Anzeige von mit [[Plugins:E-Mail|Tuxmail]] empfangener, ungelesener Mails||Y / N||Y
|}

"WEBUSER" und "WEBPASS" können leer gelassen werden, wenn das [[Webinterface]] keine Authorisation erfordert.

==Konfigurationsbeispiel "tuxcal.conf"==
<nowiki>
STARTDELAY=40
INTERVALL=1
LOGGING=Y
AUDIO=Y
VIDEO=3
SIGNAL=3
SIGMODE=0
SIGTIME=12:00;20:15;

OSD=G
SKIN=1

WEBPORT=80
WEBUSER=#
WEBPASS=#

POS_X=75
POS_Y=20
SHOW=Y
DATE=N
CLOCK=Y
SEC=Y
SIZE=S
COLOR=2
BACK=0
DETECT=1
MAIL=Y
</nowiki>

==Datendatei tuxcal.list==
Die Datendatei '''tuxcal.list''' ist eigentlich selbsterklärend:

das Format ist wie folgt:
<Art>;<Datum bzw. Zeitraum>;<Text>
z.B.:

Beispiel für frei definierte Feiertage:

f;26.10.;Nationalfeiertag Österreich;

Beispiele für Zeiträume:

z;10.02.-21.02.;Winterferien;
z;18.04.-25.04.;Osterferien;
z;16.03.2006 07:00-20.03.2006 17:30;Geschäftsreise Italien;

Beispiele für Geburtstage:

g;29.05.;Freundin;
g;25.04.1911;Oma;

Beispiele für Termine:

t;23.05.;Hochzeitstag!!!;
t;03.12.2006;Freundin Blumen schenken!;
t;23.02.2006 14:45;Zahnarzt;

Abkürzungen:
{|
|f||=||Feiertag
|-
|z||=||Zeitraum
|-
|g||=||Geburtstag
|-
|t||=||Termin
|}

Die Datendatei '''tuxcal.list''' kann entweder mit einem Unix-Editor auf dem [[PC]] erstellt werden und dann per [[FTP]] auf die [[DBox2]] nach '''/var/tuxbox/config/tuxcal/''' kopiert werden.
Oder sie kann direkt mit dem integrierten [[Plugins:Kalender#Termin-Editor|Termin-Editor]] auf der [[DBox2]] erstellt und bearbeitet werden.

=Signalisierung=
Die Signalisierung von Terminen ohne Uhrzeit wird ohne weitere Maßnahmen [[Plugins:Kalender#Scriptbeispiel um tuxcald über das Startscript der DBox2 automatisch zu starten|automatisch nur beim Start der DBox2 aus dem Deep-Standby]] oder bei einem Datumswechsel ausgeführt. Außerdem kann über den Parameter '''SIGTIME=12:00;20:15;''' in der '''tuxcal.conf''' zu diesen Uhrzeiten eine automatische Signalisierung ausgeführt werden. Maximal sind 5 Zeiten möglich.
Außerdem besteht die Möglichkeit, durch Einfügen von Befehlen in die Datei '''standby.off''' die Signalisierung auch beim [[Plugins:Kalender#Signalisierung nach Start aus dem Standby|Starten der DBox2 aus dem Standby]] auszuführen. Des Weiteren gibt es noch Möglichkeiten die Signalisierung auch beim [[Plugins:Kalender#Signalisierung während Movieplayer und Audioplayer deaktivieren|Beenden des Movie- bzw. Audioplayers]] auszuführen. Auch das [[Plugins:Kalender#Signalisierung während Aufnahme deaktivieren|Abschalten der Signalisierung während einer Aufnahme]] über die Dateien '''recording.start''' und '''recording.end''' ist möglich, was vor allem für die Benutzer eines Videorecorders oder DVD-Recorders am Scart-Eingang wichtig ist.
Außerdem werden alle aktuellen Termine beim Verlassen des Tuxcal-Plugins optisch und/oder akustisch angezeigt.

==Optische Signalisierung==
Bei der optischen Signalisierung über Popup- oder Message-Fenster werden alle aktuellen Termine abhängig von den Einstellungen in der Datei '''tuxcal.list''' angezeigt. Passen die Termine nicht auf ein Fenster, so taucht rechts im Fenster ein Scrollbalken auf. Mit '''[Runter]''' bzw. '''[Hoch]''' kann dann das nächste bzw. vorherige Fenster anzeigen. '''[Home]''' bzw. '''[Ok]''' schließt dieses Fenster. 
Bei der [[IR-Tastatur]] kann ebenfalls mit '''[Runter]''' bzw. '''[Hoch]''' auf die nächste bzw. vorherige Seite geblättert werden, '''[Pos1]''' schließt das Fenster. 
Es wird empfohlen, in den Einstellungen für [[Neutrino]] beim Parameter '''VIDEO=3''' einzustellen, da bei einem Popup die Anzeige zu schnell wieder verschwindet, bevor man sie lesen kann.

[[Bild:TuxCal16.png|400px]]
[[Bild:TuxCal17.png|400px]]

Wird bei einem Termin die Uhrzeit mit eingetragen, so wird nur dieser Termin zur eingestellten Uhrzeit angezeigt. Man beachte die Bildschirmuhr und die Uhrzeit des Termins. Die Signalisierung erfolgt wirklich genau auf die Sekunde.

[[Bild:Tuxcal15.png|400px]]

==Akustische Signalisierung durch Sounddateien==
Für die akustische Signalisierung können noch spezielle benutzerdefinierte 12/24/48KHz PCM WAV-Dateien unter '''/var/tuxbox/config/tuxcal/'''

- '''tuxcal_birthday.wav''', für die akustische Benachrichtigung bei Geburtstagen.

- '''tuxcal_timer.wav''', für die akustische Benachrichtigung bei Terminen, die genau auf die Minute signalisiert werden sollen. Dazu ist es notwendig, eine Uhrzeit einzutragen.

- '''tuxcal_event.wav''', für die akustische Benachrichtigung bei den restlichen Ereignissen.

Fertige Sounddateien können im [http://www.jackthegrabber.de/viewtopic.php?t=8809| Jack the Grabber-Forum] heruntergeladen werden.

===Sounddateien verlinken um Platz zu sparen===
Da die Sounddateien relativ groß sind und der Speicherplatz auf der Box begrenzt ist, kann man auch nur eine Sounddatei auf der Box anlegen. Um trotzdem bei allen Ereignissen akustisch informiert zu werden, hat man die Möglichkeit, nur eine Datei z.B. '''tuxcal_event.wav''' nach '''/var/tuxbox/config/tuxcal/''' auf der Box zu speichern. Die anderen Dateien werden mit folgenden Befehlen verlinkt. Dazu per Telnet auf die Box einloggen.

Per Telnet kann man sich unter Windows auf der [[DBox2]] einloggen mit '''[Start]''' '''[Ausführen]''', dann eingeben '''telnet <DBOXIP>''' wobei <DBOXIP> durch die [[IP-Adresse]] der [[DBox2]] zu ersetzen ist, z.B.:
telnet 192.168.0.23
Dann sollte ein Fenster auftauchen, in dem '''login''' drinsteht. Bei
'''login:''' root
'''Password:''' dbox2
eingeben. Die Passworteingabe wird nicht angezeigt, ist also blind einzugeben. Bei YADI-Images ist standardmäßig kein Passwort vergeben.

Dann diese beiden Befehle ausführen:
ln -s /var/tuxbox/config/tuxcal/tuxcal_event.wav /var/tuxbox/config/tuxcal/tuxcal_timer.wav
ln -s /var/tuxbox/config/tuxcal/tuxcal_event.wav /var/tuxbox/config/tuxcal/tuxcal_birthday.wav
Dadurch wurden für die Dateien '''tuxcal_timer.wav''' und '''tuxcal_birthday.wav''' sogenannte Symlinks auf die Datei '''tuxcal_event.wav''' erstellt. Die 2 verlinkten Dateien '''tuxcal_timer.wav''' und '''tuxcal_birthday.wav''' existieren zwar nicht, aber bei ihrem Aufruf wird jetzt die Datei '''tuxcal_event.wav''' abgespielt.

Für zukünftige Versionen ist jedoch geplant, die Sounddateien zu packen, und beim Aufruf nach '''/tmp/''' zu entpacken und sie dann abzuspielen.

===Erstellung der Sounddateien===
Die [[DBox2]] spielt nur Sounddateien in einem speziellen Format ab. Die PCM WAV-Dateien solltet ihr mit dem Audiorecorder unter Windows in 8 oder 16 Bit Mono, 12, 24, oder 48 KHz umwandeln. Stereo geht auch, die Dateien werden dann aber entsprechend größer. Ich empfehle deswegen 8 Bit Mono, 12 KHz.

=Scripte um Tuxcal bei bestimmten Vorgängen auf der Box zu steuern=
Das TuxCal-Plugin lässt sich über verschiedene Scripte auf der [[DBox2]] steuern. Nachfolgend sind einige Beispiel aufgeführt. Alle Scripte müssen im UNIX-Format erstellt werden und benötigen Ausführrechte (755).

==Scriptbeispiel um tuxcald über das Startscript der Box automatisch zu starten==
Ohne einen aktiven [[Daemon]] '''tuxcald''' finden keine Abfragen statt und die Bildschirmuhr wird auch nicht angezeigt. Der [[Plugins:Kalender#Autostart festlegen|Autostart muss vom Nutzer also erst einmal aktiviert werden]], da er standardmäßig deaktiviert ist. Bei jedem Start der [[DBox2]] bzw. [[GUI]] wird er danach automatisch gestartet. Der folgende Code muss entweder in die '''start_neutrino''' oder in die '''rc.S''' bzw. '''rcS.local''' eingetragen werden. Bei [[Enigma]] kommt dieser Code in die '''start_enigma'''.

'''Normalerweise sollte jedoch die folgende Startsequenz mittlerweile in jedem aktuellen Image so eingetragen sein:'''
<nowiki>
if [ -e /var/etc/.tuxcald ]; then
if [ -e /var/bin/tuxcald ]; then
/var/bin/tuxcald &
else
/bin/tuxcald &
fi
fi</nowiki>

Bitte beachten, dass die Eintragung unbedingt mit einem UNIX-Editor (vi, Ultraedit, Crimson-Editor) gemacht werden muss, und dass die Datei auch im UNIX-Format abgespeichert wird. Sonst startet die [[DBox2]] nicht mehr.
Falls das doch einmal passiert, besteht jedoch kein Grund zur Panik. Man kann nämlich immer noch per [[FTP]] oder [[Telnet]] auf die [[DBox2]] zugreifen.
Per [[FTP]] einfach die betreffende Datei nochmal von der [[DBox2]] herunterladen und im UNIX-Format abspeichern. Dann wieder auf die [[DBox2]] laden und diese neu starten. Per Telnet kann man sich unter Windows auf der [[DBox2]] einloggen mit '''[Start]''' '''[Ausführen]''', dann eingeben '''telnet <DBOXIP>''' wobei <DBOXIP> durch die [[IP-Adresse]] der [[DBox2]] zu ersetzen ist, z.B.:
telnet 192.168.0.23
Dann sollte ein Fenster auftauchen, in dem '''login''' drinsteht. Bei
'''login:''' root
'''Password:''' dbox2
eingeben. Die Passworteingabe wird nicht angezeigt, ist also blind einzugeben. Bei YADI-Images ist standardmäßig kein Passwort vergeben.

Dann folgende Befehle eingeben (dies bezieht sich jetzt auf eine fehlerhafte '''start_neutrino''', die in '''/var/tuxbox/''' liegt wie beim [[Image#JtG-Image|Jack-the-Grabber-Image]]. Andere Speicherorte und Dateien im Pfad anpassen):
dos2unix /var/tuxbox/start_neutrino
chmod 755 /var/tuxbox/start_neutrino
reboot
Mit diesem Befehl wird die Datei vom DOS- ins UNIX-Format umgewandelt und Ihr werden Ausführechte vergeben, womit die [[DBox2]] auch wieder klarkommt. Dann wird die [[DBox2]] neu gestartet.

==Signalisierung nach Start aus dem Standby==
Um die Abfrage gleich nach dem Aufwachen aus dem Standby zu aktivieren, kann unter [[Enigma]] das Script '''/var/etc/enigma_leave_standby.sh''' sowie unter [[Neutrino]] das Script '''/var/tuxbox/config/standby.off''' mit dem Inhalt
if [ -e /tmp/tuxcald.pid ]; then kill -hup $(cat /tmp/tuxcald.pid); fi
angelegt werden.

==Signalisierung während Movieplayer und Audioplayer deaktivieren==
Um beim Abspielen von Filmen im [[Neutrino:Movieplayer|Movieplayer]] oder MP3s im [[Neutrino:Audioplayer|Audioplayer]] nicht gestört zu werden, besteht die Möglichkeit den [[Daemon]] während der Wiedergabe vorübergehend abzuschalten, und nach dem Beenden automatisch wieder zu aktivieren. Das Ausschalten von '''tuxcald''' erfolgt über die Scripte '''/var/tuxbox/config/movieplayer.start''' bzw. '''/var/tuxbox/config/audioplayer.start'''. Dort muss folgender Code eingefügt werden:
if [ -e /tmp/tuxcald.pid ]; then kill -usr2 $(cat /tmp/tuxcald.pid); fi
Um den [[Daemon]] '''tuxcald''' nach dem Beenden von Movie- bzw. Audioplayer wieder zu reaktivieren, ist in den Scripten '''/var/tuxbox/config/movieplayer.end''' bzw. '''/var/tuxbox/config/audioplayer.end''' folgender Code einzufügen:
if [ -e /tmp/tuxcald.pid ]; then kill -usr1 $(cat /tmp/tuxcald.pid); fi
Bitte beachten, dass dabei auch Termine, die uhrzeitgesteuert angezeigt werden sollen, erst nach dem Beenden von Movie- bzw. Audioplayer angezeigt werden. Somit besteht das Risiko, einen wichtigen Termin zu verpassen.

==Signalisierung während Aufnahme deaktivieren==
Um beim Aufnehmen von Filmen nicht gestört zu werden, besteht die Möglichkeit den [[Daemon]] während der Aufnahme vorübergehend abzuschalten, und nach dem Beenden automatisch wieder zu aktivieren. Das Ausschalten von '''tuxcald''' erfolgt über das Script '''/var/tuxbox/config/recording.start'''. Dort muss folgender Code eingefügt werden:
if [ -e /tmp/tuxcald.pid ]; then kill -usr2 $(cat /tmp/tuxcald.pid); fi
Um den [[Daemon]] '''tuxcald''' nach dem Beenden der Aufnahme wieder zu reaktivieren, ist im Script '''/var/tuxbox/config/recording.end''' folgender Code einzufügen:
if [ -e /tmp/tuxcald.pid ]; then kill -usr1 $(cat /tmp/tuxcald.pid); fi
Bitte beachten, dass dabei auch Termine, die uhrzeitgesteuert angezeigt werden sollen, erst nach dem Beenden der Aufnahme angezeigt werden. Somit besteht das Risiko, einen wichtigen Termin zu verpassen.

=Bedienung=
Zum Starten des [[Plugins]] '''[BLAU]''' drücken und dann den Eintrag "Kalender" wählen.

Das Plugin zeigt nun den Kalender an.

[[Bild:Tuxcal01.png|400px]]

Das Plugin kann sowohl mit der [[Fernbedienung]], als auch mit der [[IR-Tastatur]] bedient werden.

Die Zeile kann mit '''[HOCH]''' und '''[RUNTER]''' gewechselt werden, die Spalte '''[RECHTS]''' und '''[LINKS]'''. Mit '''[+]''' '''[-]''' bzw. '''[Bild Hoch]''' '''[Bild runter]''' kann der nächste bzw. vorhergehende Monat angezeigt werden. '''[0]''' springt auf das aktuelle Datum.

Durch Druck auf '''[OK]''' bzw. '''[Enter]''' werden die Einträge des aktuellen Tages angezeigt. Man kann hier ebenfalls mit den vorher beschriebenen Tasten navigieren.

[[Bild:TuxCal02.png|400px]]

Durch Betätigen von '''[Gelb]''' bzw. '''[F3]''' kann man einen neuen Termin einfügen, nach Bestätigung mit '''[OK]''' bzw. '''[Enter]''' wird dieser eingefügt, '''[Home]''' bzw. '''[Esc]''' oder '''[Pos1]''' verlässt das Fenster, ohne den Eintrag einzufügen. Wird ein Eintrag eingefügt, so springt der Cursor jetzt auf den eingefügten Termin unten im Fenster. Hier kann noch bei mehreren Einträgen mit '''[HOCH]''' und '''[RUNTER]''' der gewünschte Eintrag gewechselt werden.

[[Bild:TuxCal23.png|300px]]

Durch Betätigen von '''[Rot]''' bzw. '''[F1]''' kann man Einträge nach einer Bestätigung durch '''[OK]''' oder '''[Enter]''' löschen, '''[Home]''' bzw. '''[Esc]''' oder '''[Pos1]''' verlässt das Fenster ohne den Eintrag zu löschen.

[[Bild:TuxCal24.png|300px]]

Durch Betätigen von '''[Grün]''' bzw. '''[F2]''' gelangt man in den Markieren-Modus, wo bei mehreren Einträgen mit '''[HOCH]''' und '''[RUNTER]''' der gewünschte Eintrag gewechselt werden kann.

[[Bild:TuxCal03.png|400px]]

Durch Betätigen von '''[Blau]''' bzw. '''[F4]''' gelangt man in den Termin-Editor.

==Termin-Editor==
Der Termin-Editor kann sowohl mit der [[Fernbedienung]] als auch mit der [[IR-Tastatur]] bedient werden. Mit '''[Rot]''' bzw. '''[F1]''' kann zwischen den verschiedenen Terminarten '''Einträge''', '''Zeitraum''', '''Feiertag''' und '''Geburtstag''' umgeschaltet werden.

Mit '''[Grün]''' bzw. '''[F2]''' wird die Jahreszahl ein- und ausgeblendet.

'''[Gelb]''' bzw. '''[F3]''' blendet die Uhrzeit ein und aus.

Durch Betätigen von '''[Blau]''' bzw. '''[F4]''' wird das Enddatum ein- oder ausgeblendet, was gleichzeitig dem Editieren von Zeiträumen entspricht.

Jetzt können die Einträge gemacht werden. Die Belegung der Tasten für die [[Fernbedienung]] werden links unten im Fenster angezeigt. Mit '''[+]''' und '''[-]''' kann eine einzelne Ziffer oder ein Buchstabe solange durchgescrollt werden, bis er dem gewünschten Ergebnis entspricht.

Mit '''[HOCH]''', '''[RUNTER]''', '''[RECHTS]''' und '''[LINKS]''' kann man in den Eingabefenstern die Positionen wechseln.

Mit '''[OK]''' bzw. '''[Enter]''' wird die Eingabe abgeschlossen. Nochmaliges Betätigen der Tasten '''[OK]''' bzw. '''[Enter]''' speichert den Eintrag ab, wird hier '''[Home]''' bzw. '''[Esc]''' oder '''[Pos1]''' gedrückt, bleibt man im Termin-Editor.

[[Bild:TuxCal19.png|300px]]

Will man den Termin-Editor verlassen, ohne den Termin abzuspeichern, ist zuerst '''[Home]''' bzw. '''[Esc]''' oder '''[Pos1]''' zu betätigen. Dann im folgenden Fenster '''[OK]''' bzw. '''[Enter]''' drücken, um den Termin-Editor zu verlassen, mit '''[Home]''' bzw. '''[Esc]''' oder '''[Pos1]''' bleibt man im Termin-Editor.

[[Bild:TuxCal20.png|300px]]

Bitte beachten, dass die Uhrzeit nur bei den Terminarten '''Eintrag''' und '''Zeitraum''' wirksam ist. Nur in diesen Terminarten wird man also zeitgenau informiert. Bei Geburtstagen wird bei Eingabe einer Jahreszahl das Alter im Fenster angezeigt. Termine, die verjährt sind, werden nicht signalisiert, jedoch werden Termine ohne Angabe einer Jahreszahl jährlich zum eingetragenen Datum signalisiert.

[[Bild:TuxCal04.png|400px]]
[[Bild:TuxCal13.png|400px]]
[[Bild:TuxCal12.png|400px]]
[[Bild:TuxCal21.png|400px]]
[[Bild:TuxCal14.png|400px]]
[[Bild:TuxCal22.png|400px]]

==Versionsnummern anzeigen==
Zur Fehlereingrenzung ist die genutzte Version von [[Daemon]] und [[Plugins|Plugin]] wichtig. Diese kann durch Drücken von '''[?]''' bzw. '''[Pause]''' ermittelt werden.

[[Bild:TuxCal05.png|300px]]

==Autostart festlegen==
Über das [[Plugins|Plugin]] kann auch der Start des [[Daemon]] kontrolliert werden. Ein Druck auf '''[STANDBY]''' aktiviert den Autostart, ein weiterer deaktiviert diesen wieder, bei der [[IR-Tastatur]] liegt diese Funktion auf der '''[linken runden schwarzen Taste]''', links neben '''[Esc]'''.

[[Bild:TuxCal06.png|300px]]
[[Bild:TuxCal07.png|300px]]

Vom [[Plugins|Plugin]] wird dabei unter '''/var/etc/''' die Datei '''.tuxcald''' angelegt oder gelöscht. Eine vorhandene '''.tuxcald''' bedeutet, dass der Autostart aktiviert ist. Allerdings muss dies vom Initscript der [[DBox2]] oder dem [[Plugins:Kalender#Scriptbeispiel um tuxcald über das Startscript der Box automatisch zu starten|Startscript]] der jeweiligen [[GUI]] (start_enigma, start_neutrino, start_lcars) ausgewertet werden.

==Uhrzeitanzeige ein- oder ausblenden==
Mit '''[Dbox]''' bzw. '''[Num]''' wird die [[Plugins:Kalender#Bildschirmuhr|Bildschirmuhr]] ein- oder ausgeschaltet. Dies kann auch über das Script [[Plugins:Kalender#Scriptbeispiel um die Bildschirmuhr zu steuern|Bildschirmuhr steuern]] gemacht werden.

[[Bild:TuxCal18.png|300px]]

==Plugin verlassen==
Das [[Plugins|Plugin]] kann mittels '''[Home]''' bzw. '''[Esc]''' oder '''[Pos1]''' beendet werden. Die Einträge in der '''tuxcal.list''' werden beim Verlassen des [[Plugins]] bei aktivem [[Daemon]] '''tuxcald''' sofort geprüft und alle aktuellen Termine optisch und akustisch signalisiert.

==Abfrage steuern==
Normalerweise wird der [[Daemon]] beim Start der [[DBox2]] automatisch gestartet und überwacht die Termine. Die Abfrage kann auch mit '''[MUTE]''' gesteuert werden, z.B. wenn man eine Sendung ungestört ansehen oder eine manuelle Prüfung auslösen möchte. Ein Druck schaltet die Abfrage aus, ein weiterer wieder ein. Dabei wird auch die Bildschirmuhr aus- bzw. eingeschaltet.
Die Einträge werden beim Verlassen des Plugins sofort geprüft und alle aktuellen Termine bei aktiviertem [[Daemon]] optisch und akustisch signalisiert.

[[Bild:TuxCal08.png|300px]]
[[Bild:TuxCal09.png|300px]]

=Kommandozeile=
Der [[Daemon]] '''tuxcald''' kann auch von der Kommandozeile aus gestartet bzw. kontrolliert werden. Folgende Startparameter sind derzeit möglich:

*-nodelay : die Einträge in '''tuxcal.list''' werden sofort nach dem Start abgefragt und das festgelegte STARTDELAY übergangen.
*-syslog : die Informationen werden nicht auf die Konsole ausgegeben, sondern an einen Syslog-Server gesendet.
*-play <audio-Datei> : die angegebene Audio-Datei wird gespielt, der [[Daemon]] wird nicht gestartet.
*-v : die Versionsnummer von '''tuxcald''' wird angezeigt. Der [[Daemon]] wird nicht gestartet.

Um alle Ausgaben des Daemons auf seinen [[PC]] umzuleiten, muss auf der [[DBox2]] mittels
[[syslogd]] -R <[[IP-Adresse]]>
des [[PC]] das Logging aktiviert werden. Auf dem [[PC]] muss natürlich ein [[Syslogd|Syslog]]-Server installiert sein, welcher die Ausgaben entgegen nimmt. Zur lokalen Speicherung auf der [[DBox2]] genügt ein '''syslogd''' ohne Parameter. Die Ausgaben werden so unter '''/var/log/messages''' gespeichert. Alternativ kann durch '''syslogd -O <Pfad der Logdatei>''' auch ein anderer Pfad eingestellt werden.

Sobald der [[Daemon]] läuft kann er über Signale an seine [[PID]] gesteuert werden. Die [[PID]] kann auf 2 Arten ermittelt werden:

*verwenden des Befehls '''ps | grep tuxmcald''' oder '''pidof tuxcald''' und nutzen der kleinsten aufgelisteten [[PID]]
*auslesen aus der Datei '''/tmp/tuxcald.pid''' z.B. mit '''cat /tmp/tuxcald.pid'''

Damit kann nun die Konfiguration aktualisiert, die Kontenabfrage gesteuert oder der [[Daemon]] sauber beendet werden.

==Konfiguration aktualisieren==
Falls zur Laufzeit die Konfiguration geändert wurde, kann der [[Daemon]] die neue Konfiguration einlesen, ohne hierfür extra beendet und neu gestartet zu werden:

kill -HUP <PID> bzw. kill -1 <PID>

==Abfrage steuern==
Die Abfrage kann ebenfalls unterbrochen und wieder gestartet werden, ohne den [[Daemon]] zu beenden.

kill -USR1 <PID> bzw. kill -10 <PID> startet die Abfrage,
kill -USR2 <PID> stoppt die Abfrage,

==Daemon beenden==
Ein sauberes Beenden erfolgt mit diesem Befehl:

kill -TERM <PID> bzw. kill -15 <PID> oder einfach mit kill <PID>

==Scriptbeispiel zum Daemon beenden==
kill -term $(cat /tmp/tuxcald.pid)

==Scriptbeispiel um die Bildschirmuhr zu steuern==
Die [[Plugins:Kalender#Bildschirmuhr|Bildschirmuhr]] kann über dieses Script abwechselnd ein- oder ausgeschaltet werden:

if [ -e /tmp/tuxcald.pid ]; then kill -ALRM $(cat /tmp/tuxcald.pid); fi

Eine andere Möglichkeit die Bildschirmuhr gezielt ein- oder auszublenden, geht über die Schalterdatei '''/tmp/tuxcal.clk'''. Ist die Uhr eingeschaltet, so wird diese Datei angelegt. Will man die Uhr über ein Script ausschalten, so ist diese Datei mit dem Befehl
rm /tmp/tuxcal.clk
zu löschen.
Legt man die Datei mit dem Befehl
touch /tmp/tuxcal.clk
an, so wird die Bildschirmuhr wieder eingeblendet.

=Bildschirmuhr=
Ist der [[Daemon]] '''tuxcald''' aktiviert, und die Konfigurationsdatei '''tuxcal.conf''' wurde entsprechend konfiguriert, wird an der definierten Stelle eine Digitaluhr auf dem Bildschirm eingeblendet. Wenn der Parameter '''MAIL=Y''' eingestellt ist, werden bei neu eingegangenen Mails im [[Plugins:TuxMail|Email-Plugin]], links von der Uhrzeit abwechselnd die Zahl der eingegangenen Mails und ein Briefsymbol angezeigt. Diese Anzeige bleibt solange aktiviert, bis man das [[Plugins:TuxMail|Email-Plugin]] aufruft. Diese Information wird aus der Datei '''tuxmail.new''' in '''/tmp/''' ausgelesen. Die Uhr kann über '''[Dbox]''' bzw. '''[Num]''' im TuxCal-Plugin, wahlweise ein- oder ausgeblendet werden. Außerdem kann die Bildschirmuhr, wenn man sie beim Starten der Box nicht angezeigt haben will, über den Parameter '''SHOW=N''' ausgeblendet werden. Man kann sie dann trotzdem jederzeit im Plugin mit '''[Dbox]''' bzw. '''[Num]''' ein- und wieder ausschalten.

[[Bild:TuxCal10.png|150px]]
[[Bild:TuxCal11.png|150px]]

=Links=

Bitte beachten, dass dieses Wiki für die neueste Version von TuxCal gilt. Aktuell ist am (03.08.2008) Version Plugin 1.08 / Daemon 1.12.

[http://www.jackthegrabber.de/viewtopic.php?t=8637| Download TuxCal-Plugin:] Jedoch nur eine alte Version, da das Plugin im CVS ist, und eigentlich in jedem aktuellen Image eingebaut sein sollte 
[http://www.jackthegrabber.de/viewtopic.php?t=8809| Download Sounddateien:] 
[http://www.jackthegrabber.de/viewtopic.php?t=8637| Diskussion und Fragen:]

Bitte beachten, dass man sich im Jack-the-Grabber-Forum registrieren und einloggen muss, um die Downloadlinks zu sehen. 

[http://www.jackthegrabber.de/profile.php?mode=register&sid=3e1b875d9f1bd483692afa096939d5c9| Registrierung im JTG-Board:]

{{body}}

Datei:TuxCal07.png

2008-08-04T17:03:13Z

DrStoned: TuxCal - Autostart deaktivieren

TuxCal - Autostart deaktivieren

Datei:TuxCal06.png

2008-08-04T17:02:41Z

DrStoned: TuxCal - Autostart aktivieren

TuxCal - Autostart aktivieren

Datei:TuxCal05.png

2008-08-04T17:00:46Z

DrStoned: TuxCal - Versionsnummer anzeigen

TuxCal - Versionsnummer anzeigen

Plugins:Kalender

2008-08-04T16:45:45Z

DrStoned:

[[Category:Register]]
[[Category:Plugins]]
{{Plugins_sidebar}}
__TOC__

=Allgemeines=
TuxCal ist ein Kalender, mit dem es möglich ist Feiertage, Geburtstage, Termine und Zeiträume auf der [[DBox2]] und auf der [[Dreambox]] zu verwalten. Die wichtigsten Feiertage sind fest im Programm integriert, es können jedoch auch regionale Feiertage eingefügt werden, die nicht fest eingebaut wurden. Der integrierte [[Daemon]] '''tuxcald''' erinnert auf Wunsch optisch und akustisch an die eingetragenen Events (Ereignisse). Somit vergisst man keine wichtigen Termine und Geburtstage mehr. Außerdem kann auch noch eine [[Plugins:Kalender#Bildschirmuhr|Bildschirmuhr]] frei positionierbar auf dem Bildschirm angezeigt werden.

Das Programm besteht aus 2 Teilen:
*dem [[Daemon]] '''tuxcald''', welcher im Hintergrund läuft und die Uhr steuert und die Termine überwacht, und optisch und akustisch signalisiert.
*dem Plugin '''tuxcal.so + tuxcal.cfg''', das den Kalender anzeigt und in dem neue Events verwaltet werden können und das den [[Daemon]] steuert.

Außerdem wird noch eine Datendatei '''tuxcal.list''' verwendet. In ihr werden die Termine, Geburtstage, Zeiträume und frei definierbare Feiertage verwaltet.

Sobald der [[Daemon]] einen neuen Termin gefunden hat, wird eine optische und/oder akustische Benachrichtigung ausgelöst, um den Nutzer darüber zu informieren. Dies kann über ein Nachrichtenfenster erfolgen oder das Plugin kann gleich gestartet werden.

Um bei einer interessanten Sendung nicht gestört zu werden, kann die Abfrage über das [[Plugins|Plugin]] angehalten und auch wieder gestartet werden. Sofern der [[Daemon]] aktiviert ist, werden beim Verlassen des [[Plugins]] alle Feiertage, Geburtstage, Termine und Zeiträume innerhalb des konfigurierten Zeitraums signalisiert.

=Installation=
Folgende Dateien nach '''/var/tuxbox/plugins/''' kopieren:

- '''tuxcal.cfg'''

- '''tuxcal.so'''

und folgende nach '''/var/bin/''':

- '''tuxcald'''

Die Dateien '''tuxcal.so''' und '''tuxcald''' benötigen Ausführrechte (755).

Das Datenfile '''tuxcal.list''' kommt nach '''/var/tuxbox/config/tuxcal/'''.

==Plugin updaten, was ist dabei zu beachten==
Wenn man das Plugin updaten will, ist zu beachten, dass man dazu vorher den Daemon '''tuxcald''' beenden muss, um eine neue Version dieser Datei auf die Box kopieren zu können. Dazu per Telnet unter Windows auf der [[DBox2]] einloggen mit '''[Start]''' '''[Ausführen]''', dann eingeben '''telnet <DBOXIP>''' wobei <DBOXIP> durch die [[IP-Adresse]] der [[DBox2]] zu ersetzen ist, z.B.:
telnet 192.168.0.23
Dann sollte ein Fenster auftauchen, in dem '''login''' drinsteht. Bei
'''login:''' root
'''Password:''' dbox2
eingeben. Die Passworteingabe wird nicht angezeigt, ist also blind einzugeben. Bei YADI-Images ist standardmäßig kein Passwort vergeben.
Dann folgenden Befehl eingeben:
killall -9 tuxcald
Jetzt kann man die neuere Version des Daemons '''tuxcald''' per FTP nach '''/var/bin/''' auf die Box kopieren und die ältere Version überschreiben. War dort schon eine ältere Version drin, sollten die Ausführrechte (755) schon passen. Sonst per Telnet diesen Befehl ausführen:
chmod 755 /var/bin/tuxcald
Dann entweder die Box runterfahren und neu starten, oder per Telnet diesen Befehl ausführen:
/var/bin/tuxcald -nodelay
Bitte auch zu beachten, dass man beim Plugin-Update auch immer die passende Version des Plugins '''tuxcal.so''' und '''tuxcal.cfg''' nach '''/var/tuxbox/plugins/''' kopieren muss.
Sollte das Plugin noch nicht in diesem Verzeichnis installiert gewesen sein, per Telnet diesen Befehl ausführen:
chmod 755 /var/tuxbox/plugins/tuxcal.so
Damit wird das Plugin ausführbar gemacht. Jetzt entweder die Box neu starten oder auf der Fernbedienung '''Dbox-Taste - Service - Plugins neu einlesen - Dbox-Taste''' drücken, um das Plugin '''Kalender''' auf der blauen Taste angezeigt zu bekommen.

=Konfiguration=
Damit der [[Daemon]] die Termine überprüfen kann, erzeugt er beim ersten Start die Konfigurationsdatei '''tuxcal.conf''' im Verzeichnis '''/var/tuxbox/config/tuxcal/''', falls diese nicht existiert. Die Datei wird mit Standardwerten vorbelegt, die im Rahmen der Parametergrenzen geändert werden können. Hier können nun die gewünschen Angaben eingetragen, oder alternativ eine fertige Datei vom [[PC]] per [[FTP]] übertragen werden.
Damit diese Datei erzeugt wird, muss das [[Plugins|Plugin]] gestartet werden und der [[Plugins:Kalender#Autostart festlegen|Autostart]] aktiviert werden, danach die [[DBox2]] neu
starten.

Die Datei '''tuxcal.conf''' hat folgenden Aufbau:

{| border="1"
|Eintrag||Bedeutung||mögliche Werte||Standard
|-
|STARTDELAY||Wartezeit bis der [[Daemon]] mit der ersten Abfrage beginnt (die [[GUI]] benötigt einige Zeit zum Starten)||15...60||30
|-
|INTERVALL||Abstand zwischen den Abfragen, bzw. Aktualisierung der Uhr in Sekunden||0...60||1
|-
|LOGGING||loggen bestimmter Ausgaben des [[Daemon]] ||Y / N||Y
|-
|AUDIO||akustische Signalisierung: Benutzerdefinierte 12/24/48KHz PCM Wave-Dateien können unter '''/var/tuxbox/config/tuxcal/''' abgelegt werden. '''tuxcal_birthday.wav''' für Geburtstage '''tuxcal_event.wav''' für Termine, Feiertage, Zeiträume '''tuxcal_timer.wav''' für uhrzeitgenaue Termine||Y / N||Y
|-
|VIDEO||optische Signalisierung (Message: muss per [[Fernbedienung]] bestätigt werden) (Popup: wird nach einiger Zeit automatisch geschlossen)||1 = Plugin starten 2 = [[Enigma]] Popup 3 = [[Neutrino]] Message 4 = [[Neutrino]] Popup 5 = keine Signalisierung||1
|-
|SIGNAL||Signalisierung von Ereignissen, wie sie mit dem Parameter SIGMODE eingestellt wurden||1 = nur von heute 2 = von heute und morgen 3 = bis 2 Tage im voraus 4 = bis 3 Tage im voraus 5 = bis 4 Tage im voraus||1
|-
|SIGMODE||Signalisierung bestimmter Ereignisse||0 = nur Termine und Geburtstage 1 = auch Zeitspannen 2 = 0 + Feiertage 3 = alles||0
|-
|SIGTIME||Signalisierung zu festen Uhrzeiten, zu diesen Zeiten wird die Signalisierung täglich ausgeführt. Es können mehrere Zeiten, getrennt durch ein ; eingetragen werden (max. 5 Zeiten)||00:00 - 23:59||leer
|-
|OSD||TV-Ausgaben in Deutsch oder Englisch||G / E||G
|-
|SKIN||Farbpalette wählen (1=blau, 2=grau)||1...3||1
|-
|WEBPORT||Port des [[Webinterface]] der [[DBox2]] || 1 - 65535||80
|-
|WEBUSER||Benutzername für das [[Webinterface]] der [[DBox2]] ||Text ohne Leerzeichen von bis zu 32 Zeichen||leer
|-
|WEBPASS||Passwort für das [[Webinterface]] der [[DBox2]] ||Text ohne Leerzeichen von bis zu 32 Zeichen||leer
|-
|POS_X||Position für die Bildschirmuhr horizontal (sinnvoll ca. 40 - 550)||0 - 720||500
|-
|POS_Y||Position für die Bildschirmuhr vertikal (sinnvoll ca. 10 - 500)||0 - 540||30
|-
|SHOW||Bildschirmuhr beim Start anzeigen, kann dann nachher im Plugin mit Dbox-Taste ein- oder ausgeschaltet werden||Y / N||Y
|-
|DATE||Bildschirmuhr Anzeige Datum||Y / N||N
|-
|CLOCK||Bildschirmuhr Anzeige Uhrzeit||Y / N||Y
|-
|SEC||Bildschirmuhr Anzeige der Sekunden||Y / N||Y
|-
|SIZE||Bildschirmuhr Größe der Anzeige (S)mall, (N)ormal oder (B)ig||S / N / B||S
|-
|COLOR||Bildschirmuhr Schriftfarbe: 0 Transparent, 1: schwarz, 2: weiß die direkte Angabe (außer 0,1,2 funktioniert aber nur wenn DETECT = N)||0-255||1
|-
|BACK||Bildschirmuhr Hintergrundfarbe: 0 Transparent, 1: schwarz, 2: weiß die direkte Angabe (außer 0,1,2 funktioniert aber nur wenn DETECT = N)||0-255||1
|-
|DETECT||Bildschirmuhr Versuch der Erkennung der gewählten Farbe aus der bestehenden Palette||0 / 1||1
|-
|MAIL||Bildschirmuhr Anzeige von mit [[Plugins:E-Mail|Tuxmail]] empfangener, ungelesener Mails||Y / N||Y
|}

"WEBUSER" und "WEBPASS" können leer gelassen werden, wenn das [[Webinterface]] keine Authorisation erfordert.

==Konfigurationsbeispiel "tuxcal.conf"==
<nowiki>
STARTDELAY=40
INTERVALL=1
LOGGING=Y
AUDIO=Y
VIDEO=3
SIGNAL=3
SIGMODE=0
SIGTIME=12:00;20:15;

OSD=G
SKIN=1

WEBPORT=80
WEBUSER=#
WEBPASS=#

POS_X=75
POS_Y=20
SHOW=Y
DATE=N
CLOCK=Y
SEC=Y
SIZE=S
COLOR=2
BACK=0
DETECT=1
MAIL=Y
</nowiki>

==Datendatei tuxcal.list==
Die Datendatei '''tuxcal.list''' ist eigentlich selbsterklärend:

das Format ist wie folgt:
<Art>;<Datum bzw. Zeitraum>;<Text>
z.B.:

Beispiel für frei definierte Feiertage:

f;26.10.;Nationalfeiertag Österreich;

Beispiele für Zeiträume:

z;10.02.-21.02.;Winterferien;
z;18.04.-25.04.;Osterferien;
z;16.03.2006 07:00-20.03.2006 17:30;Geschäftsreise Italien;

Beispiele für Geburtstage:

g;29.05.;Freundin;
g;25.04.1911;Oma;

Beispiele für Termine:

t;23.05.;Hochzeitstag!!!;
t;03.12.2006;Freundin Blumen schenken!;
t;23.02.2006 14:45;Zahnarzt;

Abkürzungen:
{|
|f||=||Feiertag
|-
|z||=||Zeitraum
|-
|g||=||Geburtstag
|-
|t||=||Termin
|}

Die Datendatei '''tuxcal.list''' kann entweder mit einem Unix-Editor auf dem [[PC]] erstellt werden und dann per [[FTP]] auf die [[DBox2]] nach '''/var/tuxbox/config/tuxcal/''' kopiert werden.
Oder sie kann direkt mit dem integrierten [[Plugins:Kalender#Termin-Editor|Termin-Editor]] auf der [[DBox2]] erstellt und bearbeitet werden.

=Signalisierung=
Die Signalisierung von Terminen ohne Uhrzeit wird ohne weitere Maßnahmen [[Plugins:Kalender#Scriptbeispiel um tuxcald über das Startscript der DBox2 automatisch zu starten|automatisch nur beim Start der DBox2 aus dem Deep-Standby]] oder bei einem Datumswechsel ausgeführt. Außerdem kann über den Parameter '''SIGTIME=12:00;20:15;''' in der '''tuxcal.conf''' zu diesen Uhrzeiten eine automatische Signalisierung ausgeführt werden. Maximal sind 5 Zeiten möglich.
Außerdem besteht die Möglichkeit, durch Einfügen von Befehlen in die Datei '''standby.off''' die Signalisierung auch beim [[Plugins:Kalender#Signalisierung nach Start aus dem Standby|Starten der DBox2 aus dem Standby]] auszuführen. Des Weiteren gibt es noch Möglichkeiten die Signalisierung auch beim [[Plugins:Kalender#Signalisierung während Movieplayer und Audioplayer deaktivieren|Beenden des Movie- bzw. Audioplayers]] auszuführen. Auch das [[Plugins:Kalender#Signalisierung während Aufnahme deaktivieren|Abschalten der Signalisierung während einer Aufnahme]] über die Dateien '''recording.start''' und '''recording.end''' ist möglich, was vor allem für die Benutzer eines Videorecorders oder DVD-Recorders am Scart-Eingang wichtig ist.
Außerdem werden alle aktuellen Termine beim Verlassen des Tuxcal-Plugins optisch und/oder akustisch angezeigt.

==Optische Signalisierung==
Bei der optischen Signalisierung über Popup- oder Message-Fenster werden alle aktuellen Termine abhängig von den Einstellungen in der Datei '''tuxcal.list''' angezeigt. Passen die Termine nicht auf ein Fenster, so taucht rechts im Fenster ein Scrollbalken auf. Mit '''[Runter]''' bzw. '''[Hoch]''' kann dann das nächste bzw. vorherige Fenster anzeigen. '''[Home]''' bzw. '''[Ok]''' schließt dieses Fenster. 
Bei der [[IR-Tastatur]] kann ebenfalls mit '''[Runter]''' bzw. '''[Hoch]''' auf die nächste bzw. vorherige Seite geblättert werden, '''[Pos1]''' schließt das Fenster. 
Es wird empfohlen, in den Einstellungen für [[Neutrino]] beim Parameter '''VIDEO=3''' einzustellen, da bei einem Popup die Anzeige zu schnell wieder verschwindet, bevor man sie lesen kann.

[[Bild:TuxCal16.png|400px]]
[[Bild:TuxCal17.png|400px]]

Wird bei einem Termin die Uhrzeit mit eingetragen, so wird nur dieser Termin zur eingestellten Uhrzeit angezeigt. Man beachte die Bildschirmuhr und die Uhrzeit des Termins. Die Signalisierung erfolgt wirklich genau auf die Sekunde.

[[Bild:Tuxcal15.png|400px]]

==Akustische Signalisierung durch Sounddateien==
Für die akustische Signalisierung können noch spezielle benutzerdefinierte 12/24/48KHz PCM WAV-Dateien unter '''/var/tuxbox/config/tuxcal/'''

- '''tuxcal_birthday.wav''', für die akustische Benachrichtigung bei Geburtstagen.

- '''tuxcal_timer.wav''', für die akustische Benachrichtigung bei Terminen, die genau auf die Minute signalisiert werden sollen. Dazu ist es notwendig, eine Uhrzeit einzutragen.

- '''tuxcal_event.wav''', für die akustische Benachrichtigung bei den restlichen Ereignissen.

Fertige Sounddateien können im [http://www.jackthegrabber.de/viewtopic.php?t=8809| Jack the Grabber-Forum] heruntergeladen werden.

===Sounddateien verlinken um Platz zu sparen===
Da die Sounddateien relativ groß sind und der Speicherplatz auf der Box begrenzt ist, kann man auch nur eine Sounddatei auf der Box anlegen. Um trotzdem bei allen Ereignissen akustisch informiert zu werden, hat man die Möglichkeit, nur eine Datei z.B. '''tuxcal_event.wav''' nach '''/var/tuxbox/config/tuxcal/''' auf der Box zu speichern. Die anderen Dateien werden mit folgenden Befehlen verlinkt. Dazu per Telnet auf die Box einloggen.

Per Telnet kann man sich unter Windows auf der [[DBox2]] einloggen mit '''[Start]''' '''[Ausführen]''', dann eingeben '''telnet <DBOXIP>''' wobei <DBOXIP> durch die [[IP-Adresse]] der [[DBox2]] zu ersetzen ist, z.B.:
telnet 192.168.0.23
Dann sollte ein Fenster auftauchen, in dem '''login''' drinsteht. Bei
'''login:''' root
'''Password:''' dbox2
eingeben. Die Passworteingabe wird nicht angezeigt, ist also blind einzugeben. Bei YADI-Images ist standardmäßig kein Passwort vergeben.

Dann diese beiden Befehle ausführen:
ln -s /var/tuxbox/config/tuxcal/tuxcal_event.wav /var/tuxbox/config/tuxcal/tuxcal_timer.wav
ln -s /var/tuxbox/config/tuxcal/tuxcal_event.wav /var/tuxbox/config/tuxcal/tuxcal_birthday.wav
Dadurch wurden für die Dateien '''tuxcal_timer.wav''' und '''tuxcal_birthday.wav''' sogenannte Symlinks auf die Datei '''tuxcal_event.wav''' erstellt. Die 2 verlinkten Dateien '''tuxcal_timer.wav''' und '''tuxcal_birthday.wav''' existieren zwar nicht, aber bei ihrem Aufruf wird jetzt die Datei '''tuxcal_event.wav''' abgespielt.

Für zukünftige Versionen ist jedoch geplant, die Sounddateien zu packen, und beim Aufruf nach '''/tmp/''' zu entpacken und sie dann abzuspielen.

===Erstellung der Sounddateien===
Die [[DBox2]] spielt nur Sounddateien in einem speziellen Format ab. Die PCM WAV-Dateien solltet ihr mit dem Audiorecorder unter Windows in 8 oder 16 Bit Mono, 12, 24, oder 48 KHz umwandeln. Stereo geht auch, die Dateien werden dann aber entsprechend größer. Ich empfehle deswegen 8 Bit Mono, 12 KHz.

=Scripte um Tuxcal bei bestimmten Vorgängen auf der Box zu steuern=
Das TuxCal-Plugin lässt sich über verschiedene Scripte auf der [[DBox2]] steuern. Nachfolgend sind einige Beispiel aufgeführt. Alle Scripte müssen im UNIX-Format erstellt werden und benötigen Ausführrechte (755).

==Scriptbeispiel um tuxcald über das Startscript der Box automatisch zu starten==
Ohne einen aktiven [[Daemon]] '''tuxcald''' finden keine Abfragen statt und die Bildschirmuhr wird auch nicht angezeigt. Der [[Plugins:Kalender#Autostart festlegen|Autostart muss vom Nutzer also erst einmal aktiviert werden]], da er standardmäßig deaktiviert ist. Bei jedem Start der [[DBox2]] bzw. [[GUI]] wird er danach automatisch gestartet. Der folgende Code muss entweder in die '''start_neutrino''' oder in die '''rc.S''' bzw. '''rcS.local''' eingetragen werden. Bei [[Enigma]] kommt dieser Code in die '''start_enigma'''.
<nowiki>
if [ -e /var/etc/.tuxcald ]; then
if [ -e /var/bin/tuxcald ]; then
/var/bin/tuxcald &
else
/bin/tuxcald &
fi
fi</nowiki>

Bitte beachten, dass die Eintragung unbedingt mit einem UNIX-Editor (vi, Ultraedit, Crimson-Editor) gemacht werden muss, und dass die Datei auch im UNIX-Format abgespeichert wird. Sonst startet die [[DBox2]] nicht mehr.
Falls das doch einmal passiert, besteht jedoch kein Grund zur Panik. Man kann nämlich immer noch per [[FTP]] oder [[Telnet]] auf die [[DBox2]] zugreifen.
Per [[FTP]] einfach die betreffende Datei nochmal von der [[DBox2]] herunterladen und im UNIX-Format abspeichern. Dann wieder auf die [[DBox2]] laden und diese neu starten. Per Telnet kann man sich unter Windows auf der [[DBox2]] einloggen mit '''[Start]''' '''[Ausführen]''', dann eingeben '''telnet <DBOXIP>''' wobei <DBOXIP> durch die [[IP-Adresse]] der [[DBox2]] zu ersetzen ist, z.B.:
telnet 192.168.0.23
Dann sollte ein Fenster auftauchen, in dem '''login''' drinsteht. Bei
'''login:''' root
'''Password:''' dbox2
eingeben. Die Passworteingabe wird nicht angezeigt, ist also blind einzugeben. Bei YADI-Images ist standardmäßig kein Passwort vergeben.

Dann folgenden Befehl eingeben (dies bezieht sich jetzt auf eine fehlerhafte '''start_neutrino''', die in '''/var/tuxbox/''' liegt wie beim [[Image#JtG-Image|Jack-the-Grabber-Image]]. Andere Speicherorte und Dateien im Pfad anpassen):
dos2unix /var/tuxbox/start_neutrino
Mit diesem Befehl wird die Datei vom DOS- ins UNIX-Format umgewandelt, womit die [[DBox2]] auch wieder klarkommt. Dann die [[DBox2]] neu starten.

==Signalisierung nach Start aus dem Standby==
Um die Abfrage gleich nach dem Aufwachen aus dem Standby zu aktivieren, kann unter [[Enigma]] das Script '''/var/etc/enigma_leave_standby.sh''' sowie unter [[Neutrino]] das Script '''/var/tuxbox/config/standby.off''' mit dem Inhalt
if [ -e /tmp/tuxcald.pid ]; then kill -hup $(cat /tmp/tuxcald.pid); fi
angelegt werden.

==Signalisierung während Movieplayer und Audioplayer deaktivieren==
Um beim Abspielen von Filmen im [[Neutrino:Movieplayer|Movieplayer]] oder MP3s im [[Neutrino:Audioplayer|Audioplayer]] nicht gestört zu werden, besteht die Möglichkeit den [[Daemon]] während der Wiedergabe vorübergehend abzuschalten, und nach dem Beenden automatisch wieder zu aktivieren. Das Ausschalten von '''tuxcald''' erfolgt über die Scripte '''/var/tuxbox/config/movieplayer.start''' bzw. '''/var/tuxbox/config/audioplayer.start'''. Dort muss folgender Code eingefügt werden:
if [ -e /tmp/tuxcald.pid ]; then kill -usr2 $(cat /tmp/tuxcald.pid); fi
Um den [[Daemon]] '''tuxcald''' nach dem Beenden von Movie- bzw. Audioplayer wieder zu reaktivieren, ist in den Scripten '''/var/tuxbox/config/movieplayer.end''' bzw. '''/var/tuxbox/config/audioplayer.end''' folgender Code einzufügen:
if [ -e /tmp/tuxcald.pid ]; then kill -usr1 $(cat /tmp/tuxcald.pid); fi
Bitte beachten, dass dabei auch Termine, die uhrzeitgesteuert angezeigt werden sollen, erst nach dem Beenden von Movie- bzw. Audioplayer angezeigt werden. Somit besteht das Risiko, einen wichtigen Termin zu verpassen.

==Signalisierung während Aufnahme deaktivieren==
Um beim Aufnehmen von Filmen nicht gestört zu werden, besteht die Möglichkeit den [[Daemon]] während der Aufnahme vorübergehend abzuschalten, und nach dem Beenden automatisch wieder zu aktivieren. Das Ausschalten von '''tuxcald''' erfolgt über das Script '''/var/tuxbox/config/recording.start'''. Dort muss folgender Code eingefügt werden:
if [ -e /tmp/tuxcald.pid ]; then kill -usr2 $(cat /tmp/tuxcald.pid); fi
Um den [[Daemon]] '''tuxcald''' nach dem Beenden der Aufnahme wieder zu reaktivieren, ist im Script '''/var/tuxbox/config/recording.end''' folgender Code einzufügen:
if [ -e /tmp/tuxcald.pid ]; then kill -usr1 $(cat /tmp/tuxcald.pid); fi
Bitte beachten, dass dabei auch Termine, die uhrzeitgesteuert angezeigt werden sollen, erst nach dem Beenden der Aufnahme angezeigt werden. Somit besteht das Risiko, einen wichtigen Termin zu verpassen.

=Bedienung=
Zum Starten des [[Plugins]] '''[BLAU]''' drücken und dann den Eintrag "Kalender" wählen.

Das Plugin zeigt nun den Kalender an.

[[Bild:Tuxcal01.png|400px]]

Das Plugin kann sowohl mit der [[Fernbedienung]], als auch mit der [[IR-Tastatur]] bedient werden.

Die Zeile kann mit '''[HOCH]''' und '''[RUNTER]''' gewechselt werden, die Spalte '''[RECHTS]''' und '''[LINKS]'''. Mit '''[+]''' '''[-]''' bzw. '''[Bild Hoch]''' '''[Bild runter]''' kann der nächste bzw. vorhergehende Monat angezeigt werden. '''[0]''' springt auf das aktuelle Datum.

Durch Druck auf '''[OK]''' bzw. '''[Enter]''' werden die Einträge des aktuellen Tages angezeigt. Man kann hier ebenfalls mit den vorher beschriebenen Tasten navigieren.

[[Bild:TuxCal02.png|400px]]

Durch Betätigen von '''[Gelb]''' bzw. '''[F3]''' kann man einen neuen Termin einfügen, nach Bestätigung mit '''[OK]''' bzw. '''[Enter]''' wird dieser eingefügt, '''[Home]''' bzw. '''[Esc]''' oder '''[Pos1]''' verlässt das Fenster, ohne den Eintrag einzufügen. Wird ein Eintrag eingefügt, so springt der Cursor jetzt auf den eingefügten Termin unten im Fenster. Hier kann noch bei mehreren Einträgen mit '''[HOCH]''' und '''[RUNTER]''' der gewünschte Eintrag gewechselt werden.

[[Bild:TuxCal23.png|300px]]

Durch Betätigen von '''[Rot]''' bzw. '''[F1]''' kann man Einträge nach einer Bestätigung durch '''[OK]''' oder '''[Enter]''' löschen, '''[Home]''' bzw. '''[Esc]''' oder '''[Pos1]''' verlässt das Fenster ohne den Eintrag zu löschen.

[[Bild:TuxCal24.png|300px]]

Durch Betätigen von '''[Grün]''' bzw. '''[F2]''' gelangt man in den Markieren-Modus, wo bei mehreren Einträgen mit '''[HOCH]''' und '''[RUNTER]''' der gewünschte Eintrag gewechselt werden kann.

[[Bild:TuxCal03.png|400px]]

Durch Betätigen von '''[Blau]''' bzw. '''[F4]''' gelangt man in den Termin-Editor.

==Termin-Editor==
Der Termin-Editor kann sowohl mit der [[Fernbedienung]] als auch mit der [[IR-Tastatur]] bedient werden. Mit '''[Rot]''' bzw. '''[F1]''' kann zwischen den verschiedenen Terminarten '''Einträge''', '''Zeitraum''', '''Feiertag''' und '''Geburtstag''' umgeschaltet werden.

Mit '''[Grün]''' bzw. '''[F2]''' wird die Jahreszahl ein- und ausgeblendet.

'''[Gelb]''' bzw. '''[F3]''' blendet die Uhrzeit ein und aus.

Durch Betätigen von '''[Blau]''' bzw. '''[F4]''' wird das Enddatum ein- oder ausgeblendet, was gleichzeitig dem Editieren von Zeiträumen entspricht.

Jetzt können die Einträge gemacht werden. Die Belegung der Tasten für die [[Fernbedienung]] werden links unten im Fenster angezeigt. Mit '''[+]''' und '''[-]''' kann eine einzelne Ziffer oder ein Buchstabe solange durchgescrollt werden, bis er dem gewünschten Ergebnis entspricht.

Mit '''[HOCH]''', '''[RUNTER]''', '''[RECHTS]''' und '''[LINKS]''' kann man in den Eingabefenstern die Positionen wechseln.

Mit '''[OK]''' bzw. '''[Enter]''' wird die Eingabe abgeschlossen. Nochmaliges Betätigen der Tasten '''[OK]''' bzw. '''[Enter]''' speichert den Eintrag ab, wird hier '''[Home]''' bzw. '''[Esc]''' oder '''[Pos1]''' gedrückt, bleibt man im Termin-Editor.

[[Bild:TuxCal19.png|300px]]

Will man den Termin-Editor verlassen, ohne den Termin abzuspeichern, ist zuerst '''[Home]''' bzw. '''[Esc]''' oder '''[Pos1]''' zu betätigen. Dann im folgenden Fenster '''[OK]''' bzw. '''[Enter]''' drücken, um den Termin-Editor zu verlassen, mit '''[Home]''' bzw. '''[Esc]''' oder '''[Pos1]''' bleibt man im Termin-Editor.

[[Bild:TuxCal20.png|300px]]

Bitte beachten, dass die Uhrzeit nur bei den Terminarten '''Eintrag''' und '''Zeitraum''' wirksam ist. Nur in diesen Terminarten wird man also zeitgenau informiert. Bei Geburtstagen wird bei Eingabe einer Jahreszahl das Alter im Fenster angezeigt. Termine, die verjährt sind, werden nicht signalisiert, jedoch werden Termine ohne Angabe einer Jahreszahl jährlich zum eingetragenen Datum signalisiert.

[[Bild:TuxCal04.png|400px]]
[[Bild:TuxCal13.png|400px]]
[[Bild:TuxCal12.png|400px]]
[[Bild:TuxCal21.png|400px]]
[[Bild:TuxCal14.png|400px]]
[[Bild:TuxCal22.png|400px]]

==Versionsnummern anzeigen==
Zur Fehlereingrenzung ist die genutzte Version von [[Daemon]] und [[Plugins|Plugin]] wichtig. Diese kann durch Drücken von '''[?]''' bzw. '''[Pause]''' ermittelt werden.

[[Bild:TuxCal05.png|300px]]

==Autostart festlegen==
Über das [[Plugins|Plugin]] kann auch der Start des [[Daemon]] kontrolliert werden. Ein Druck auf '''[STANDBY]''' aktiviert den Autostart, ein weiterer deaktiviert diesen wieder, bei der [[IR-Tastatur]] liegt diese Funktion auf der '''[linken runden schwarzen Taste]''', links neben '''[Esc]'''.

[[Bild:TuxCal06.png|300px]]
[[Bild:TuxCal07.png|300px]]

Vom [[Plugins|Plugin]] wird dabei unter '''/var/etc/''' die Datei '''.tuxcald''' angelegt oder gelöscht. Eine vorhandene '''.tuxcald''' bedeutet, dass der Autostart aktiviert ist. Allerdings muss dies vom Initscript der [[DBox2]] oder dem [[Plugins:Kalender#Scriptbeispiel um tuxcald über das Startscript der Box automatisch zu starten|Startscript]] der jeweiligen [[GUI]] (start_enigma, start_neutrino, start_lcars) ausgewertet werden.

==Uhrzeitanzeige ein- oder ausblenden==
Mit '''[Dbox]''' bzw. '''[Num]''' wird die [[Plugins:Kalender#Bildschirmuhr|Bildschirmuhr]] ein- oder ausgeschaltet. Dies kann auch über das Script [[Plugins:Kalender#Scriptbeispiel um die Bildschirmuhr zu steuern|Bildschirmuhr steuern]] gemacht werden.

[[Bild:TuxCal18.png|300px]]

==Plugin verlassen==
Das [[Plugins|Plugin]] kann mittels '''[Home]''' bzw. '''[Esc]''' oder '''[Pos1]''' beendet werden. Die Einträge in der '''tuxcal.list''' werden beim Verlassen des [[Plugins]] bei aktivem [[Daemon]] '''tuxcald''' sofort geprüft und alle aktuellen Termine optisch und akustisch signalisiert.

==Abfrage steuern==
Normalerweise wird der [[Daemon]] beim Start der [[DBox2]] automatisch gestartet und überwacht die Termine. Die Abfrage kann auch mit '''[MUTE]''' gesteuert werden, z.B. wenn man eine Sendung ungestört ansehen oder eine manuelle Prüfung auslösen möchte. Ein Druck schaltet die Abfrage aus, ein weiterer wieder ein. Dabei wird auch die Bildschirmuhr aus- bzw. eingeschaltet.
Die Einträge werden beim Verlassen des Plugins sofort geprüft und alle aktuellen Termine bei aktiviertem [[Daemon]] optisch und akustisch signalisiert.

[[Bild:TuxCal08.png|300px]]
[[Bild:TuxCal09.png|300px]]

=Kommandozeile=
Der [[Daemon]] '''tuxcald''' kann auch von der Kommandozeile aus gestartet bzw. kontrolliert werden. Folgende Startparameter sind derzeit möglich:

*-nodelay : die Einträge in '''tuxcal.list''' werden sofort nach dem Start abgefragt und das festgelegte STARTDELAY übergangen.
*-syslog : die Informationen werden nicht auf die Konsole ausgegeben, sondern an einen Syslog-Server gesendet.
*-play <audio-Datei> : die angegebene Audio-Datei wird gespielt, der [[Daemon]] wird nicht gestartet.
*-v : die Versionsnummer von '''tuxcald''' wird angezeigt. Der [[Daemon]] wird nicht gestartet.

Um alle Ausgaben des Daemons auf seinen [[PC]] umzuleiten, muss auf der [[DBox2]] mittels
[[syslogd]] -R <[[IP-Adresse]]>
des [[PC]] das Logging aktiviert werden. Auf dem [[PC]] muss natürlich ein [[Syslogd|Syslog]]-Server installiert sein, welcher die Ausgaben entgegen nimmt. Zur lokalen Speicherung auf der [[DBox2]] genügt ein '''syslogd''' ohne Parameter. Die Ausgaben werden so unter '''/var/log/messages''' gespeichert. Alternativ kann durch '''syslogd -O <Pfad der Logdatei>''' auch ein anderer Pfad eingestellt werden.

Sobald der [[Daemon]] läuft kann er über Signale an seine [[PID]] gesteuert werden. Die [[PID]] kann auf 2 Arten ermittelt werden:

*verwenden des Befehls '''ps | grep tuxmcald''' oder '''pidof tuxcald''' und nutzen der kleinsten aufgelisteten [[PID]]
*auslesen aus der Datei '''/tmp/tuxcald.pid''' z.B. mit '''cat /tmp/tuxcald.pid'''

Damit kann nun die Konfiguration aktualisiert, die Kontenabfrage gesteuert oder der [[Daemon]] sauber beendet werden.

==Konfiguration aktualisieren==
Falls zur Laufzeit die Konfiguration geändert wurde, kann der [[Daemon]] die neue Konfiguration einlesen, ohne hierfür extra beendet und neu gestartet zu werden:

kill -HUP <PID> bzw. kill -1 <PID>

==Abfrage steuern==
Die Abfrage kann ebenfalls unterbrochen und wieder gestartet werden, ohne den [[Daemon]] zu beenden.

kill -USR1 <PID> bzw. kill -10 <PID> startet die Abfrage,
kill -USR2 <PID> stoppt die Abfrage,

==Daemon beenden==
Ein sauberes Beenden erfolgt mit diesem Befehl:

kill -TERM <PID> bzw. kill -15 <PID> oder einfach mit kill <PID>

==Scriptbeispiel zum Daemon beenden==
kill -term $(cat /tmp/tuxcald.pid)

==Scriptbeispiel um die Bildschirmuhr zu steuern==
Die [[Plugins:Kalender#Bildschirmuhr|Bildschirmuhr]] kann über dieses Script abwechselnd ein- oder ausgeschaltet werden:

if [ -e /tmp/tuxcald.pid ]; then kill -ALRM $(cat /tmp/tuxcald.pid); fi

Eine andere Möglichkeit die Bildschirmuhr gezielt ein- oder auszublenden, geht über die Schalterdatei '''/tmp/tuxcal.clk'''. Ist die Uhr eingeschaltet, so wird diese Datei angelegt. Will man die Uhr über ein Script ausschalten, so ist diese Datei mit dem Befehl
rm /tmp/tuxcal.clk
zu löschen.
Legt man die Datei mit dem Befehl
touch /tmp/tuxcal.clk
an, so wird die Bildschirmuhr wieder eingeblendet.

=Bildschirmuhr=
Ist der [[Daemon]] '''tuxcald''' aktiviert, und die Konfigurationsdatei '''tuxcal.conf''' wurde entsprechend konfiguriert, wird an der definierten Stelle eine Digitaluhr auf dem Bildschirm eingeblendet. Wenn der Parameter '''MAIL=Y''' eingestellt ist, werden bei neu eingegangenen Mails im [[Plugins:TuxMail|Email-Plugin]], links von der Uhrzeit abwechselnd die Zahl der eingegangenen Mails und ein Briefsymbol angezeigt. Diese Anzeige bleibt solange aktiviert, bis man das [[Plugins:TuxMail|Email-Plugin]] aufruft. Diese Information wird aus der Datei '''tuxmail.new''' in '''/tmp/''' ausgelesen. Die Uhr kann über '''[Dbox]''' bzw. '''[Num]''' im TuxCal-Plugin, wahlweise ein- oder ausgeblendet werden. Außerdem kann die Bildschirmuhr, wenn man sie beim Starten der Box nicht angezeigt haben will, über den Parameter '''SHOW=N''' ausgeblendet werden. Man kann sie dann trotzdem jederzeit im Plugin mit '''[Dbox]''' bzw. '''[Num]''' ein- und wieder ausschalten.

[[Bild:TuxCal10.png|150px]]
[[Bild:TuxCal11.png|150px]]

=Links=
Das neue TuxCal-Plugin befindet sich noch in der experimentellen Phase. Es wurde jedoch bereits ins [[CVS]] eingepflegt. Im aktuellen Jack-the-Grabber-Snapshot ist es bereits eingebaut worden, momentan jedoch nur eine ältere Version. Falls JtG-Image-User die neueste Version einbauen wollen, so müssen sie diese ebenfalls im JtG-Plugin-Forum herunterladen oder auf einen Snapshot warten, in dem Riker die neueste Version eingebaut hat.

Wer ein anderes [[Image]] benutzt, und nicht darauf warten will, kann es aktuell (24.02.2006) unter folgendem Link im Jack-The-Grabber-Forum herunterladen.
Bitte beachten, dass dieses Wiki für die neueste Version von TuxCal gilt. Aktuell ist Version Plugin 1.07 / Daemon 1.07.

[http://www.jackthegrabber.de/viewtopic.php?t=8637| Download TuxCal-Plugin:] 
[http://www.jackthegrabber.de/viewtopic.php?t=8809| Download Sounddateien:] 
[http://www.jackthegrabber.de/viewtopic.php?t=8637| Diskussion und Fragen:]

Bitte beachten, dass man sich im Jack-the-Grabber-Forum registrieren und einloggen muss, um die Downloadlinks zu sehen. 

[http://www.jackthegrabber.de/profile.php?mode=register&sid=3e1b875d9f1bd483692afa096939d5c9| Registrierung im JTG-Board:]

{{body}}

Datei:TuxCal20.png

2008-08-04T16:44:49Z

DrStoned: Tuxcal - Termineditor Änderungen verwerfen

Tuxcal - Termineditor Änderungen verwerfen

Datei:TuxCal19.png

2008-08-04T16:43:13Z

DrStoned: Tuxcal - Termineditor Änderungen übernehmen

Tuxcal - Termineditor Änderungen übernehmen

Datei:TuxCal23.png

2008-08-04T16:40:26Z

DrStoned: hat eine neue Version von „Bild:TuxCal23.png“ hochgeladen: Tuxcal - Eintrag hinzufügen

Tuxcal - Termin hinzufügen

Datei:TuxCal24.png

2008-08-04T16:27:01Z

DrStoned: Tuxcal - Eintrag löschen

Tuxcal - Eintrag löschen

Datei:TuxCal23.png

2008-08-04T16:25:21Z

DrStoned: Tuxcal - Termin hinzufügen

Tuxcal - Termin hinzufügen

Datei:TuxCal03.png

2008-08-04T15:58:52Z

DrStoned: Tuxcal markieren eines Termins zum bearbeiten oder löschen

Tuxcal markieren eines Termins zum bearbeiten oder löschen

Datei:TuxCal18.png

2008-08-04T15:46:17Z

DrStoned: Tuxcal Uhrzeitanzeige ein- oder ausblenden

Tuxcal Uhrzeitanzeige ein- oder ausblenden

Datei:TuxCal02.png

2008-08-04T15:33:22Z

DrStoned: hat eine neue Version von „Bild:TuxCal02.png“ hochgeladen: Tuxcal Termine aktueller Tag

Tuxcal Termine aktueller Tag

Datei:TuxCal02.png

2008-08-04T15:30:04Z

DrStoned: Tuxcal Termine aktueller Tag

Tuxcal Termine aktueller Tag

Plugins:Kalender

2008-08-04T15:00:32Z

DrStoned:

[[Category:Register]]
[[Category:Plugins]]
{{Plugins_sidebar}}
__TOC__

=Allgemeines=
TuxCal ist ein Kalender, mit dem es möglich ist Feiertage, Geburtstage, Termine und Zeiträume auf der [[DBox2]] und auf der [[Dreambox]] zu verwalten. Die wichtigsten Feiertage sind fest im Programm integriert, es können jedoch auch regionale Feiertage eingefügt werden, die nicht fest eingebaut wurden. Der integrierte [[Daemon]] '''tuxcald''' erinnert auf Wunsch optisch und akustisch an die eingetragenen Events (Ereignisse). Somit vergisst man keine wichtigen Termine und Geburtstage mehr. Außerdem kann auch noch eine [[Plugins:Kalender#Bildschirmuhr|Bildschirmuhr]] frei positionierbar auf dem Bildschirm angezeigt werden.

Das Programm besteht aus 2 Teilen:
*dem [[Daemon]] '''tuxcald''', welcher im Hintergrund läuft und die Uhr steuert und die Termine überwacht, und optisch und akustisch signalisiert.
*dem Plugin '''tuxcal.so + tuxcal.cfg''', das den Kalender anzeigt und in dem neue Events verwaltet werden können und das den [[Daemon]] steuert.

Außerdem wird noch eine Datendatei '''tuxcal.list''' verwendet. In ihr werden die Termine, Geburtstage, Zeiträume und frei definierbare Feiertage verwaltet.

Sobald der [[Daemon]] einen neuen Termin gefunden hat, wird eine optische und/oder akustische Benachrichtigung ausgelöst, um den Nutzer darüber zu informieren. Dies kann über ein Nachrichtenfenster erfolgen oder das Plugin kann gleich gestartet werden.

Um bei einer interessanten Sendung nicht gestört zu werden, kann die Abfrage über das [[Plugins|Plugin]] angehalten und auch wieder gestartet werden. Sofern der [[Daemon]] aktiviert ist, werden beim Verlassen des [[Plugins]] alle Feiertage, Geburtstage, Termine und Zeiträume innerhalb des konfigurierten Zeitraums signalisiert.

=Installation=
Folgende Dateien nach '''/var/tuxbox/plugins/''' kopieren:

- '''tuxcal.cfg'''

- '''tuxcal.so'''

und folgende nach '''/var/bin/''':

- '''tuxcald'''

Die Dateien '''tuxcal.so''' und '''tuxcald''' benötigen Ausführrechte (755).

Das Datenfile '''tuxcal.list''' kommt nach '''/var/tuxbox/config/tuxcal/'''.

==Plugin updaten, was ist dabei zu beachten==
Wenn man das Plugin updaten will, ist zu beachten, dass man dazu vorher den Daemon '''tuxcald''' beenden muss, um eine neue Version dieser Datei auf die Box kopieren zu können. Dazu per Telnet unter Windows auf der [[DBox2]] einloggen mit '''[Start]''' '''[Ausführen]''', dann eingeben '''telnet <DBOXIP>''' wobei <DBOXIP> durch die [[IP-Adresse]] der [[DBox2]] zu ersetzen ist, z.B.:
telnet 192.168.0.23
Dann sollte ein Fenster auftauchen, in dem '''login''' drinsteht. Bei
'''login:''' root
'''Password:''' dbox2
eingeben. Die Passworteingabe wird nicht angezeigt, ist also blind einzugeben. Bei YADI-Images ist standardmäßig kein Passwort vergeben.
Dann folgenden Befehl eingeben:
killall -9 tuxcald
Jetzt kann man die neuere Version des Daemons '''tuxcald''' per FTP nach '''/var/bin/''' auf die Box kopieren und die ältere Version überschreiben. War dort schon eine ältere Version drin, sollten die Ausführrechte (755) schon passen. Sonst per Telnet diesen Befehl ausführen:
chmod 755 /var/bin/tuxcald
Dann entweder die Box runterfahren und neu starten, oder per Telnet diesen Befehl ausführen:
/var/bin/tuxcald -nodelay
Bitte auch zu beachten, dass man beim Plugin-Update auch immer die passende Version des Plugins '''tuxcal.so''' und '''tuxcal.cfg''' nach '''/var/tuxbox/plugins/''' kopieren muss.
Sollte das Plugin noch nicht in diesem Verzeichnis installiert gewesen sein, per Telnet diesen Befehl ausführen:
chmod 755 /var/tuxbox/plugins/tuxcal.so
Damit wird das Plugin ausführbar gemacht. Jetzt entweder die Box neu starten oder auf der Fernbedienung '''Dbox-Taste - Service - Plugins neu einlesen - Dbox-Taste''' drücken, um das Plugin '''Kalender''' auf der blauen Taste angezeigt zu bekommen.

=Konfiguration=
Damit der [[Daemon]] die Termine überprüfen kann, erzeugt er beim ersten Start die Konfigurationsdatei '''tuxcal.conf''' im Verzeichnis '''/var/tuxbox/config/tuxcal/''', falls diese nicht existiert. Die Datei wird mit Standardwerten vorbelegt, die im Rahmen der Parametergrenzen geändert werden können. Hier können nun die gewünschen Angaben eingetragen, oder alternativ eine fertige Datei vom [[PC]] per [[FTP]] übertragen werden.
Damit diese Datei erzeugt wird, muss das [[Plugins|Plugin]] gestartet werden und der [[Plugins:Kalender#Autostart festlegen|Autostart]] aktiviert werden, danach die [[DBox2]] neu
starten.

Die Datei '''tuxcal.conf''' hat folgenden Aufbau:

{| border="1"
|Eintrag||Bedeutung||mögliche Werte||Standard
|-
|STARTDELAY||Wartezeit bis der [[Daemon]] mit der ersten Abfrage beginnt (die [[GUI]] benötigt einige Zeit zum Starten)||15...60||30
|-
|INTERVALL||Abstand zwischen den Abfragen, bzw. Aktualisierung der Uhr in Sekunden||0...60||1
|-
|LOGGING||loggen bestimmter Ausgaben des [[Daemon]] ||Y / N||Y
|-
|AUDIO||akustische Signalisierung: Benutzerdefinierte 12/24/48KHz PCM Wave-Dateien können unter '''/var/tuxbox/config/tuxcal/''' abgelegt werden. '''tuxcal_birthday.wav''' für Geburtstage '''tuxcal_event.wav''' für Termine, Feiertage, Zeiträume '''tuxcal_timer.wav''' für uhrzeitgenaue Termine||Y / N||Y
|-
|VIDEO||optische Signalisierung (Message: muss per [[Fernbedienung]] bestätigt werden) (Popup: wird nach einiger Zeit automatisch geschlossen)||1 = Plugin starten 2 = [[Enigma]] Popup 3 = [[Neutrino]] Message 4 = [[Neutrino]] Popup 5 = keine Signalisierung||1
|-
|SIGNAL||Signalisierung von Ereignissen, wie sie mit dem Parameter SIGMODE eingestellt wurden||1 = nur von heute 2 = von heute und morgen 3 = bis 2 Tage im voraus 4 = bis 3 Tage im voraus 5 = bis 4 Tage im voraus||1
|-
|SIGMODE||Signalisierung bestimmter Ereignisse||0 = nur Termine und Geburtstage 1 = auch Zeitspannen 2 = 0 + Feiertage 3 = alles||0
|-
|SIGTIME||Signalisierung zu festen Uhrzeiten, zu diesen Zeiten wird die Signalisierung täglich ausgeführt. Es können mehrere Zeiten, getrennt durch ein ; eingetragen werden (max. 5 Zeiten)||00:00 - 23:59||leer
|-
|OSD||TV-Ausgaben in Deutsch oder Englisch||G / E||G
|-
|SKIN||Farbpalette wählen (1=blau, 2=grau)||1...3||1
|-
|WEBPORT||Port des [[Webinterface]] der [[DBox2]] || 1 - 65535||80
|-
|WEBUSER||Benutzername für das [[Webinterface]] der [[DBox2]] ||Text ohne Leerzeichen von bis zu 32 Zeichen||leer
|-
|WEBPASS||Passwort für das [[Webinterface]] der [[DBox2]] ||Text ohne Leerzeichen von bis zu 32 Zeichen||leer
|-
|POS_X||Position für die Bildschirmuhr horizontal (sinnvoll ca. 40 - 550)||0 - 720||500
|-
|POS_Y||Position für die Bildschirmuhr vertikal (sinnvoll ca. 10 - 500)||0 - 540||30
|-
|SHOW||Bildschirmuhr beim Start anzeigen, kann dann nachher im Plugin mit Dbox-Taste ein- oder ausgeschaltet werden||Y / N||Y
|-
|DATE||Bildschirmuhr Anzeige Datum||Y / N||N
|-
|CLOCK||Bildschirmuhr Anzeige Uhrzeit||Y / N||Y
|-
|SEC||Bildschirmuhr Anzeige der Sekunden||Y / N||Y
|-
|SIZE||Bildschirmuhr Größe der Anzeige (S)mall, (N)ormal oder (B)ig||S / N / B||S
|-
|COLOR||Bildschirmuhr Schriftfarbe: 0 Transparent, 1: schwarz, 2: weiß die direkte Angabe (außer 0,1,2 funktioniert aber nur wenn DETECT = N)||0-255||1
|-
|BACK||Bildschirmuhr Hintergrundfarbe: 0 Transparent, 1: schwarz, 2: weiß die direkte Angabe (außer 0,1,2 funktioniert aber nur wenn DETECT = N)||0-255||1
|-
|DETECT||Bildschirmuhr Versuch der Erkennung der gewählten Farbe aus der bestehenden Palette||0 / 1||1
|-
|MAIL||Bildschirmuhr Anzeige von mit [[Plugins:E-Mail|Tuxmail]] empfangener, ungelesener Mails||Y / N||Y
|}

"WEBUSER" und "WEBPASS" können leer gelassen werden, wenn das [[Webinterface]] keine Authorisation erfordert.

==Konfigurationsbeispiel "tuxcal.conf"==
<nowiki>
STARTDELAY=40
INTERVALL=1
LOGGING=Y
AUDIO=Y
VIDEO=3
SIGNAL=3
SIGMODE=0
SIGTIME=12:00;20:15;

OSD=G
SKIN=1

WEBPORT=80
WEBUSER=#
WEBPASS=#

POS_X=75
POS_Y=20
SHOW=Y
DATE=N
CLOCK=Y
SEC=Y
SIZE=S
COLOR=2
BACK=0
DETECT=1
MAIL=Y
</nowiki>

==Datendatei tuxcal.list==
Die Datendatei '''tuxcal.list''' ist eigentlich selbsterklärend:

das Format ist wie folgt:
<Art>;<Datum bzw. Zeitraum>;<Text>
z.B.:

Beispiel für frei definierte Feiertage:

f;26.10.;Nationalfeiertag Österreich;

Beispiele für Zeiträume:

z;10.02.-21.02.;Winterferien;
z;18.04.-25.04.;Osterferien;
z;16.03.2006 07:00-20.03.2006 17:30;Geschäftsreise Italien;

Beispiele für Geburtstage:

g;29.05.;Freundin;
g;25.04.1911;Oma;

Beispiele für Termine:

t;23.05.;Hochzeitstag!!!;
t;03.12.2006;Freundin Blumen schenken!;
t;23.02.2006 14:45;Zahnarzt;

Abkürzungen:
{|
|f||=||Feiertag
|-
|z||=||Zeitraum
|-
|g||=||Geburtstag
|-
|t||=||Termin
|}

Die Datendatei '''tuxcal.list''' kann entweder mit einem Unix-Editor auf dem [[PC]] erstellt werden und dann per [[FTP]] auf die [[DBox2]] nach '''/var/tuxbox/config/tuxcal/''' kopiert werden.
Oder sie kann direkt mit dem integrierten [[Plugins:Kalender#Termin-Editor|Termin-Editor]] auf der [[DBox2]] erstellt und bearbeitet werden.

=Signalisierung=
Die Signalisierung von Terminen ohne Uhrzeit wird ohne weitere Maßnahmen [[Plugins:Kalender#Scriptbeispiel um tuxcald über das Startscript der DBox2 automatisch zu starten|automatisch nur beim Start der DBox2 aus dem Deep-Standby]] oder bei einem Datumswechsel ausgeführt. Außerdem kann über den Parameter '''SIGTIME=12:00;20:15;''' in der '''tuxcal.conf''' zu diesen Uhrzeiten eine automatische Signalisierung ausgeführt werden. Maximal sind 5 Zeiten möglich.
Außerdem besteht die Möglichkeit, durch Einfügen von Befehlen in die Datei '''standby.off''' die Signalisierung auch beim [[Plugins:Kalender#Signalisierung nach Start aus dem Standby|Starten der DBox2 aus dem Standby]] auszuführen. Des Weiteren gibt es noch Möglichkeiten die Signalisierung auch beim [[Plugins:Kalender#Signalisierung während Movieplayer und Audioplayer deaktivieren|Beenden des Movie- bzw. Audioplayers]] auszuführen. Auch das [[Plugins:Kalender#Signalisierung während Aufnahme deaktivieren|Abschalten der Signalisierung während einer Aufnahme]] über die Dateien '''recording.start''' und '''recording.end''' ist möglich, was vor allem für die Benutzer eines Videorecorders oder DVD-Recorders am Scart-Eingang wichtig ist.
Außerdem werden alle aktuellen Termine beim Verlassen des Tuxcal-Plugins optisch und/oder akustisch angezeigt.

==Optische Signalisierung==
Bei der optischen Signalisierung über Popup- oder Message-Fenster werden alle aktuellen Termine abhängig von den Einstellungen in der Datei '''tuxcal.list''' angezeigt. Passen die Termine nicht auf ein Fenster, so taucht rechts im Fenster ein Scrollbalken auf. Mit '''[Runter]''' bzw. '''[Hoch]''' kann dann das nächste bzw. vorherige Fenster anzeigen. '''[Home]''' bzw. '''[Ok]''' schließt dieses Fenster. 
Bei der [[IR-Tastatur]] kann ebenfalls mit '''[Runter]''' bzw. '''[Hoch]''' auf die nächste bzw. vorherige Seite geblättert werden, '''[Pos1]''' schließt das Fenster. 
Es wird empfohlen, in den Einstellungen für [[Neutrino]] beim Parameter '''VIDEO=3''' einzustellen, da bei einem Popup die Anzeige zu schnell wieder verschwindet, bevor man sie lesen kann.

[[Bild:TuxCal16.png|400px]]
[[Bild:TuxCal17.png|400px]]

Wird bei einem Termin die Uhrzeit mit eingetragen, so wird nur dieser Termin zur eingestellten Uhrzeit angezeigt. Man beachte die Bildschirmuhr und die Uhrzeit des Termins. Die Signalisierung erfolgt wirklich genau auf die Sekunde.

[[Bild:Tuxcal15.png|400px]]

==Akustische Signalisierung durch Sounddateien==
Für die akustische Signalisierung können noch spezielle benutzerdefinierte 12/24/48KHz PCM WAV-Dateien unter '''/var/tuxbox/config/tuxcal/'''

- '''tuxcal_birthday.wav''', für die akustische Benachrichtigung bei Geburtstagen.

- '''tuxcal_timer.wav''', für die akustische Benachrichtigung bei Terminen, die genau auf die Minute signalisiert werden sollen. Dazu ist es notwendig, eine Uhrzeit einzutragen.

- '''tuxcal_event.wav''', für die akustische Benachrichtigung bei den restlichen Ereignissen.

Fertige Sounddateien können im [http://www.jackthegrabber.de/viewtopic.php?t=8809| Jack the Grabber-Forum] heruntergeladen werden.

===Sounddateien verlinken um Platz zu sparen===
Da die Sounddateien relativ groß sind und der Speicherplatz auf der Box begrenzt ist, kann man auch nur eine Sounddatei auf der Box anlegen. Um trotzdem bei allen Ereignissen akustisch informiert zu werden, hat man die Möglichkeit, nur eine Datei z.B. '''tuxcal_event.wav''' nach '''/var/tuxbox/config/tuxcal/''' auf der Box zu speichern. Die anderen Dateien werden mit folgenden Befehlen verlinkt. Dazu per Telnet auf die Box einloggen.

Per Telnet kann man sich unter Windows auf der [[DBox2]] einloggen mit '''[Start]''' '''[Ausführen]''', dann eingeben '''telnet <DBOXIP>''' wobei <DBOXIP> durch die [[IP-Adresse]] der [[DBox2]] zu ersetzen ist, z.B.:
telnet 192.168.0.23
Dann sollte ein Fenster auftauchen, in dem '''login''' drinsteht. Bei
'''login:''' root
'''Password:''' dbox2
eingeben. Die Passworteingabe wird nicht angezeigt, ist also blind einzugeben. Bei YADI-Images ist standardmäßig kein Passwort vergeben.

Dann diese beiden Befehle ausführen:
ln -s /var/tuxbox/config/tuxcal/tuxcal_event.wav /var/tuxbox/config/tuxcal/tuxcal_timer.wav
ln -s /var/tuxbox/config/tuxcal/tuxcal_event.wav /var/tuxbox/config/tuxcal/tuxcal_birthday.wav
Dadurch wurden für die Dateien '''tuxcal_timer.wav''' und '''tuxcal_birthday.wav''' sogenannte Symlinks auf die Datei '''tuxcal_event.wav''' erstellt. Die 2 verlinkten Dateien '''tuxcal_timer.wav''' und '''tuxcal_birthday.wav''' existieren zwar nicht, aber bei ihrem Aufruf wird jetzt die Datei '''tuxcal_event.wav''' abgespielt.

Für zukünftige Versionen ist jedoch geplant, die Sounddateien zu packen, und beim Aufruf nach '''/tmp/''' zu entpacken und sie dann abzuspielen.

===Erstellung der Sounddateien===
Die [[DBox2]] spielt nur Sounddateien in einem speziellen Format ab. Die PCM WAV-Dateien solltet ihr mit dem Audiorecorder unter Windows in 8 oder 16 Bit Mono, 12, 24, oder 48 KHz umwandeln. Stereo geht auch, die Dateien werden dann aber entsprechend größer. Ich empfehle deswegen 8 Bit Mono, 12 KHz.

=Scripte um Tuxcal bei bestimmten Vorgängen auf der Box zu steuern=
Das TuxCal-Plugin lässt sich über verschiedene Scripte auf der [[DBox2]] steuern. Nachfolgend sind einige Beispiel aufgeführt. Alle Scripte müssen im UNIX-Format erstellt werden und benötigen Ausführrechte (755).

==Scriptbeispiel um tuxcald über das Startscript der Box automatisch zu starten==
Ohne einen aktiven [[Daemon]] '''tuxcald''' finden keine Abfragen statt und die Bildschirmuhr wird auch nicht angezeigt. Der [[Plugins:Kalender#Autostart festlegen|Autostart muss vom Nutzer also erst einmal aktiviert werden]], da er standardmäßig deaktiviert ist. Bei jedem Start der [[DBox2]] bzw. [[GUI]] wird er danach automatisch gestartet. Der folgende Code muss entweder in die '''start_neutrino''' oder in die '''rc.S''' bzw. '''rcS.local''' eingetragen werden. Bei [[Enigma]] kommt dieser Code in die '''start_enigma'''.
<nowiki>
if [ -e /var/etc/.tuxcald ]; then
if [ -e /var/bin/tuxcald ]; then
/var/bin/tuxcald &
else
/bin/tuxcald &
fi
fi</nowiki>

Bitte beachten, dass die Eintragung unbedingt mit einem UNIX-Editor (vi, Ultraedit, Crimson-Editor) gemacht werden muss, und dass die Datei auch im UNIX-Format abgespeichert wird. Sonst startet die [[DBox2]] nicht mehr.
Falls das doch einmal passiert, besteht jedoch kein Grund zur Panik. Man kann nämlich immer noch per [[FTP]] oder [[Telnet]] auf die [[DBox2]] zugreifen.
Per [[FTP]] einfach die betreffende Datei nochmal von der [[DBox2]] herunterladen und im UNIX-Format abspeichern. Dann wieder auf die [[DBox2]] laden und diese neu starten. Per Telnet kann man sich unter Windows auf der [[DBox2]] einloggen mit '''[Start]''' '''[Ausführen]''', dann eingeben '''telnet <DBOXIP>''' wobei <DBOXIP> durch die [[IP-Adresse]] der [[DBox2]] zu ersetzen ist, z.B.:
telnet 192.168.0.23
Dann sollte ein Fenster auftauchen, in dem '''login''' drinsteht. Bei
'''login:''' root
'''Password:''' dbox2
eingeben. Die Passworteingabe wird nicht angezeigt, ist also blind einzugeben. Bei YADI-Images ist standardmäßig kein Passwort vergeben.

Dann folgenden Befehl eingeben (dies bezieht sich jetzt auf eine fehlerhafte '''start_neutrino''', die in '''/var/tuxbox/''' liegt wie beim [[Image#JtG-Image|Jack-the-Grabber-Image]]. Andere Speicherorte und Dateien im Pfad anpassen):
dos2unix /var/tuxbox/start_neutrino
Mit diesem Befehl wird die Datei vom DOS- ins UNIX-Format umgewandelt, womit die [[DBox2]] auch wieder klarkommt. Dann die [[DBox2]] neu starten.

==Signalisierung nach Start aus dem Standby==
Um die Abfrage gleich nach dem Aufwachen aus dem Standby zu aktivieren, kann unter [[Enigma]] das Script '''/var/etc/enigma_leave_standby.sh''' sowie unter [[Neutrino]] das Script '''/var/tuxbox/config/standby.off''' mit dem Inhalt
if [ -e /tmp/tuxcald.pid ]; then kill -hup $(cat /tmp/tuxcald.pid); fi
angelegt werden.

==Signalisierung während Movieplayer und Audioplayer deaktivieren==
Um beim Abspielen von Filmen im [[Neutrino:Movieplayer|Movieplayer]] oder MP3s im [[Neutrino:Audioplayer|Audioplayer]] nicht gestört zu werden, besteht die Möglichkeit den [[Daemon]] während der Wiedergabe vorübergehend abzuschalten, und nach dem Beenden automatisch wieder zu aktivieren. Das Ausschalten von '''tuxcald''' erfolgt über die Scripte '''/var/tuxbox/config/movieplayer.start''' bzw. '''/var/tuxbox/config/audioplayer.start'''. Dort muss folgender Code eingefügt werden:
if [ -e /tmp/tuxcald.pid ]; then kill -usr2 $(cat /tmp/tuxcald.pid); fi
Um den [[Daemon]] '''tuxcald''' nach dem Beenden von Movie- bzw. Audioplayer wieder zu reaktivieren, ist in den Scripten '''/var/tuxbox/config/movieplayer.end''' bzw. '''/var/tuxbox/config/audioplayer.end''' folgender Code einzufügen:
if [ -e /tmp/tuxcald.pid ]; then kill -usr1 $(cat /tmp/tuxcald.pid); fi
Bitte beachten, dass dabei auch Termine, die uhrzeitgesteuert angezeigt werden sollen, erst nach dem Beenden von Movie- bzw. Audioplayer angezeigt werden. Somit besteht das Risiko, einen wichtigen Termin zu verpassen.

==Signalisierung während Aufnahme deaktivieren==
Um beim Aufnehmen von Filmen nicht gestört zu werden, besteht die Möglichkeit den [[Daemon]] während der Aufnahme vorübergehend abzuschalten, und nach dem Beenden automatisch wieder zu aktivieren. Das Ausschalten von '''tuxcald''' erfolgt über das Script '''/var/tuxbox/config/recording.start'''. Dort muss folgender Code eingefügt werden:
if [ -e /tmp/tuxcald.pid ]; then kill -usr2 $(cat /tmp/tuxcald.pid); fi
Um den [[Daemon]] '''tuxcald''' nach dem Beenden der Aufnahme wieder zu reaktivieren, ist im Script '''/var/tuxbox/config/recording.end''' folgender Code einzufügen:
if [ -e /tmp/tuxcald.pid ]; then kill -usr1 $(cat /tmp/tuxcald.pid); fi
Bitte beachten, dass dabei auch Termine, die uhrzeitgesteuert angezeigt werden sollen, erst nach dem Beenden der Aufnahme angezeigt werden. Somit besteht das Risiko, einen wichtigen Termin zu verpassen.

=Bedienung=
Zum Starten des [[Plugins]] '''[BLAU]''' drücken und dann den Eintrag "Kalender" wählen.

Das Plugin zeigt nun den Kalender an.

[[Bild:Tuxcal01.png|400px]]

Das Plugin kann sowohl mit der [[Fernbedienung]], als auch mit der [[IR-Tastatur]] bedient werden.

Die Zeile kann mit '''[HOCH]''' und '''[RUNTER]''' gewechselt werden, die Spalte '''[RECHTS]''' und '''[LINKS]'''. Mit '''[+]''' '''[-]''' bzw. '''[Bild Hoch]''' '''[Bild runter]''' kann der nächste bzw. vorhergehende Monat angezeigt werden. '''[0]''' springt auf das aktuelle Datum.

Durch Druck auf '''[OK]''' bzw. '''[Enter]''' werden die Einträge des aktuellen Tages angezeigt. Man kann hier ebenfalls mit den vorher beschriebenen Tasten navigieren.

[[Bild:TuxCal02.png|400px]]

Mit '''[Dbox]''' bzw. '''[Num]''' wird die [[Plugins:Kalender#Bildschirmuhr|Bildschirmuhr]] ein- oder ausgeschaltet. Dies kann auch über das Script [[Plugins:Kalender#Scriptbeispiel um die Bildschirmuhr zu steuern|Bildschirmuhr steuern]] gemacht werden.

[[Bild:TuxCal18.png|200px]]

Durch Betätigen von '''[Gelb]''' bzw. '''[F3]''' kann man einen neuen Termin einfügen, nach Bestätigung mit '''[OK]''' bzw. '''[Enter]''' wird dieser eingefügt, '''[Home]''' bzw. '''[Esc]''' oder '''[Pos1]''' verlässt das Fenster, ohne den Eintrag einzufügen. Wird ein Eintrag eingefügt, so springt der Cursor jetzt auf den eingefügten Termin unten im Fenster. Hier kann noch bei mehreren Einträgen mit '''[HOCH]''' und '''[RUNTER]''' der gewünschte Eintrag gewechselt werden.

Durch Betätigen von '''[Blau]''' bzw. '''[F4]''' gelangt man in den Termin-Editor.

Durch Betätigen von '''[Rot]''' bzw. '''[F1]''' kann man Einträge nach einer Bestätigung durch '''[OK]''' oder '''[Enter]''' löschen, '''[Home]''' bzw. '''[Esc]''' oder '''[Pos1]''' verlässt das Fenster ohne den Eintrag zu löschen.

Durch Betätigen von '''[Grün]''' bzw. '''[F2]''' gelangt man in den Markieren-Modus, wo bei mehreren Einträgen mit '''[HOCH]''' und '''[RUNTER]''' der gewünschte Eintrag gewechselt werden kann.

[[Bild:TuxCal03.png|400px]]

==Termin-Editor==
Der Termin-Editor kann sowohl mit der [[Fernbedienung]] als auch mit der [[IR-Tastatur]] bedient werden. Mit '''[Rot]''' bzw. '''[F1]''' kann zwischen den verschiedenen Terminarten '''Einträge''', '''Zeitraum''', '''Feiertag''' und '''Geburtstag''' umgeschaltet werden.

Mit '''[Grün]''' bzw. '''[F2]''' wird die Jahreszahl ein- und ausgeblendet.

'''[Gelb]''' bzw. '''[F3]''' blendet die Uhrzeit ein und aus.

Durch Betätigen von '''[Blau]''' bzw. '''[F4]''' wird das Enddatum ein- oder ausgeblendet, was gleichzeitig dem Editieren von Zeiträumen entspricht.

Jetzt können die Einträge gemacht werden. Die Belegung der Tasten für die [[Fernbedienung]] werden links unten im Fenster angezeigt. Mit '''[+]''' und '''[-]''' kann eine einzelne Ziffer oder ein Buchstabe solange durchgescrollt werden, bis er dem gewünschten Ergebnis entspricht.

Mit '''[HOCH]''', '''[RUNTER]''', '''[RECHTS]''' und '''[LINKS]''' kann man in den Eingabefenstern die Positionen wechseln.

Mit '''[OK]''' bzw. '''[Enter]''' wird die Eingabe abgeschlossen. Nochmaliges Betätigen der Tasten '''[OK]''' bzw. '''[Enter]''' speichert den Eintrag ab, wird hier '''[Home]''' bzw. '''[Esc]''' oder '''[Pos1]''' gedrückt, bleibt man im Termin-Editor.

[[Bild:TuxCal19.png|200px]]

Will man den Termin-Edior verlassen, ohne den Termin abzuspeichern, ist zuerst '''[Home]''' bzw. '''[Esc]''' oder '''[Pos1]''' zu betätigen. Dann im folgenden Fenster '''[OK]''' bzw. '''[Enter]''' drücken, um den Termin-Editor zu verlassen, mit '''[Home]''' bzw. '''[Esc]''' oder '''[Pos1]''' bleibt man im Termin-Editor.

[[Bild:TuxCal20.png|200px]]

Bitte beachten, dass die Uhrzeit nur bei den Terminarten '''Eintrag''' und '''Zeitraum''' wirksam ist. Nur in diesen Terminarten wird man also zeitgenau informiert. Bei Geburtstagen wird bei Eingabe einer Jahreszahl das Alter im Fenster angezeigt. Termine, die verjährt sind, werden nicht signalisiert, jedoch werden Termine ohne Angabe einer Jahreszahl jährlich zum eingetragenen Datum signalisiert.

[[Bild:TuxCal04.png|400px]]
[[Bild:TuxCal13.png|400px]]
[[Bild:TuxCal12.png|400px]]
[[Bild:TuxCal21.png|400px]]
[[Bild:TuxCal14.png|400px]]
[[Bild:TuxCal22.png|400px]]

==Versionsnummern anzeigen==
Zur Fehlereingrenzung ist die genutzte Version von [[Daemon]] und [[Plugins|Plugin]] wichtig. Diese kann durch Drücken von '''[?]''' bzw. '''[Pause]''' ermittelt werden.

[[Bild:TuxCal05.png|200px]]

==Autostart festlegen==
Über das [[Plugins|Plugin]] kann auch der Start des [[Daemon]] kontrolliert werden. Ein Druck auf '''[STANDBY]''' aktiviert den Autostart, ein weiterer deaktiviert diesen wieder, bei der [[IR-Tastatur]] liegt diese Funktion auf der '''[linken runden schwarzen Taste]''', links neben '''[Esc]'''.

[[Bild:TuxCal06.png|200px]]
[[Bild:TuxCal07.png|200px]]

Vom [[Plugins|Plugin]] wird dabei unter '''/var/etc/''' die Datei '''.tuxcald''' angelegt oder gelöscht. Eine vorhandene '''.tuxcald''' bedeutet, dass der Autostart aktiviert ist. Allerdings muss dies vom Initscript der [[DBox2]] oder dem [[Plugins:Kalender#Scriptbeispiel um tuxcald über das Startscript der Box automatisch zu starten|Startscript]] der jeweiligen [[GUI]] (start_enigma, start_neutrino, start_lcars) ausgewertet werden.

==Plugin verlassen==
Das [[Plugins|Plugin]] kann mittels '''[Home]''' bzw. '''[Esc]''' oder '''[Pos1]''' beendet werden. Die Einträge in der '''tuxcal.list''' werden beim Verlassen des [[Plugins]] bei aktivem [[Daemon]] '''tuxcald''' sofort geprüft und alle aktuellen Termine optisch und akustisch signalisiert.

==Abfrage steuern==
Normalerweise wird der [[Daemon]] beim Start der [[DBox2]] automatisch gestartet und überwacht die Termine. Die Abfrage kann auch mit '''[MUTE]''' gesteuert werden, z.B. wenn man eine Sendung ungestört ansehen oder eine manuelle Prüfung auslösen möchte. Ein Druck schaltet die Abfrage aus, ein weiterer wieder ein. Dabei wird auch die Bildschirmuhr aus- bzw. eingeschaltet.
Die Einträge werden beim Verlassen des Plugins sofort geprüft und alle aktuellen Termine bei aktiviertem [[Daemon]] optisch und akustisch signalisiert.

[[Bild:TuxCal08.png|300px]]
[[Bild:TuxCal09.png|300px]]

=Kommandozeile=
Der [[Daemon]] '''tuxcald''' kann auch von der Kommandozeile aus gestartet bzw. kontrolliert werden. Folgende Startparameter sind derzeit möglich:

*-nodelay : die Einträge in '''tuxcal.list''' werden sofort nach dem Start abgefragt und das festgelegte STARTDELAY übergangen.
*-syslog : die Informationen werden nicht auf die Konsole ausgegeben, sondern an einen Syslog-Server gesendet.
*-play <audio-Datei> : die angegebene Audio-Datei wird gespielt, der [[Daemon]] wird nicht gestartet.
*-v : die Versionsnummer von '''tuxcald''' wird angezeigt. Der [[Daemon]] wird nicht gestartet.

Um alle Ausgaben des Daemons auf seinen [[PC]] umzuleiten, muss auf der [[DBox2]] mittels
[[syslogd]] -R <[[IP-Adresse]]>
des [[PC]] das Logging aktiviert werden. Auf dem [[PC]] muss natürlich ein [[Syslogd|Syslog]]-Server installiert sein, welcher die Ausgaben entgegen nimmt. Zur lokalen Speicherung auf der [[DBox2]] genügt ein '''syslogd''' ohne Parameter. Die Ausgaben werden so unter '''/var/log/messages''' gespeichert. Alternativ kann durch '''syslogd -O <Pfad der Logdatei>''' auch ein anderer Pfad eingestellt werden.

Sobald der [[Daemon]] läuft kann er über Signale an seine [[PID]] gesteuert werden. Die [[PID]] kann auf 2 Arten ermittelt werden:

*verwenden des Befehls '''ps | grep tuxmcald''' oder '''pidof tuxcald''' und nutzen der kleinsten aufgelisteten [[PID]]
*auslesen aus der Datei '''/tmp/tuxcald.pid''' z.B. mit '''cat /tmp/tuxcald.pid'''

Damit kann nun die Konfiguration aktualisiert, die Kontenabfrage gesteuert oder der [[Daemon]] sauber beendet werden.

==Konfiguration aktualisieren==
Falls zur Laufzeit die Konfiguration geändert wurde, kann der [[Daemon]] die neue Konfiguration einlesen, ohne hierfür extra beendet und neu gestartet zu werden:

kill -HUP <PID> bzw. kill -1 <PID>

==Abfrage steuern==
Die Abfrage kann ebenfalls unterbrochen und wieder gestartet werden, ohne den [[Daemon]] zu beenden.

kill -USR1 <PID> bzw. kill -10 <PID> startet die Abfrage,
kill -USR2 <PID> stoppt die Abfrage,

==Daemon beenden==
Ein sauberes Beenden erfolgt mit diesem Befehl:

kill -TERM <PID> bzw. kill -15 <PID> oder einfach mit kill <PID>

==Scriptbeispiel zum Daemon beenden==
kill -term $(cat /tmp/tuxcald.pid)

==Scriptbeispiel um die Bildschirmuhr zu steuern==
Die [[Plugins:Kalender#Bildschirmuhr|Bildschirmuhr]] kann über dieses Script abwechselnd ein- oder ausgeschaltet werden:

if [ -e /tmp/tuxcald.pid ]; then kill -ALRM $(cat /tmp/tuxcald.pid); fi

Eine andere Möglichkeit die Bildschirmuhr gezielt ein- oder auszublenden, geht über die Schalterdatei '''/tmp/tuxcal.clk'''. Ist die Uhr eingeschaltet, so wird diese Datei angelegt. Will man die Uhr über ein Script ausschalten, so ist diese Datei mit dem Befehl
rm /tmp/tuxcal.clk
zu löschen.
Legt man die Datei mit dem Befehl
touch /tmp/tuxcal.clk
an, so wird die Bildschirmuhr wieder eingeblendet.

=Bildschirmuhr=
Ist der [[Daemon]] '''tuxcald''' aktiviert, und die Konfigurationsdatei '''tuxcal.conf''' wurde entsprechend konfiguriert, wird an der definierten Stelle eine Digitaluhr auf dem Bildschirm eingeblendet. Wenn der Parameter '''MAIL=Y''' eingestellt ist, werden bei neu eingegangenen Mails im [[Plugins:TuxMail|Email-Plugin]], links von der Uhrzeit abwechselnd die Zahl der eingegangenen Mails und ein Briefsymbol angezeigt. Diese Anzeige bleibt solange aktiviert, bis man das [[Plugins:TuxMail|Email-Plugin]] aufruft. Diese Information wird aus der Datei '''tuxmail.new''' in '''/tmp/''' ausgelesen. Die Uhr kann über '''[Dbox]''' bzw. '''[Num]''' im TuxCal-Plugin, wahlweise ein- oder ausgeblendet werden. Außerdem kann die Bildschirmuhr, wenn man sie beim Starten der Box nicht angezeigt haben will, über den Parameter '''SHOW=N''' ausgeblendet werden. Man kann sie dann trotzdem jederzeit im Plugin mit '''[Dbox]''' bzw. '''[Num]''' ein- und wieder ausschalten.

[[Bild:TuxCal10.png|100px]]
[[Bild:TuxCal11.png|100px]]

=Links=
Das neue TuxCal-Plugin befindet sich noch in der experimentellen Phase. Es wurde jedoch bereits ins [[CVS]] eingepflegt. Im aktuellen Jack-the-Grabber-Snapshot ist es bereits eingebaut worden, momentan jedoch nur eine ältere Version. Falls JtG-Image-User die neueste Version einbauen wollen, so müssen sie diese ebenfalls im JtG-Plugin-Forum herunterladen oder auf einen Snapshot warten, in dem Riker die neueste Version eingebaut hat.

Wer ein anderes [[Image]] benutzt, und nicht darauf warten will, kann es aktuell (24.02.2006) unter folgendem Link im Jack-The-Grabber-Forum herunterladen.
Bitte beachten, dass dieses Wiki für die neueste Version von TuxCal gilt. Aktuell ist Version Plugin 1.07 / Daemon 1.07.

[http://www.jackthegrabber.de/viewtopic.php?t=8637| Download TuxCal-Plugin:] 
[http://www.jackthegrabber.de/viewtopic.php?t=8809| Download Sounddateien:] 
[http://www.jackthegrabber.de/viewtopic.php?t=8637| Diskussion und Fragen:]

Bitte beachten, dass man sich im Jack-the-Grabber-Forum registrieren und einloggen muss, um die Downloadlinks zu sehen. 

[http://www.jackthegrabber.de/profile.php?mode=register&sid=3e1b875d9f1bd483692afa096939d5c9| Registrierung im JTG-Board:]

{{body}}

Datei:TuxCal09.png

2008-08-04T14:59:51Z

DrStoned: Tuxcal Abfrage starten

Tuxcal Abfrage starten

Datei:TuxCal08.png

2008-08-04T14:58:42Z

DrStoned: Tuxcal Abfrage stoppen

Tuxcal Abfrage stoppen

Datei:TuxCal11.png

2008-08-04T14:45:05Z

DrStoned: hat eine neue Version von „Bild:TuxCal11.png“ hochgeladen: Tuxcal Anzeige der Emails von Tuxmail

Tuxcal Anzeige der Emails

Datei:TuxCal10.png

2008-08-04T14:40:24Z

DrStoned: hat eine neue Version von „Bild:TuxCal10.png“ hochgeladen: Tuxcal Anzeige der Emails von Tuxmail

Tuxcal Anzeige der Emails

Datei:TuxCal11.png

2008-08-04T14:25:54Z

DrStoned: Tuxcal Anzeige der Emails

Tuxcal Anzeige der Emails

Datei:TuxCal10.png

2008-08-04T14:24:37Z

DrStoned: Tuxcal Anzeige der Emails

Tuxcal Anzeige der Emails

Datei:Tuxcal15.png

2008-08-04T14:06:28Z

DrStoned: hat eine neue Version von „Bild:Tuxcal15.png“ hochgeladen

Tuxcal Bild optische Signalisierung von Termin

Datei:Tuxcal15.png

2008-08-04T14:00:51Z

DrStoned: Tuxcal Bild optische Signalisierung von Termin

Tuxcal Bild optische Signalisierung von Termin

Datei:TuxCal15.png

2008-08-04T13:55:55Z

DrStoned: Tuxcal Terminsignalisierung

Tuxcal Terminsignalisierung

Datei:TuxCal16.png

2008-08-04T13:24:16Z

DrStoned:

Datei:TuxCal16.jpg

2008-08-04T13:11:38Z

DrStoned: