FindNewServices
===============

FindNewServices analysiert nach einem Satellitensuchlauf die
Suchergebnisse und stellt neue Services (Sender fr TV und Radio)
in getrennten Userbouquets zur Verfgung.

FindNewServices besteht aus einem Plugin und einem Shell-Script. 
Das Plugin dient lediglich zur Steuerung. Die Analyse der Suchergebnisse
und das Erzeugen der Userbouquets wird vom Shell-Script bernommen.

Das Plugin steht unter der GNU General Public License und ist somit
Open-Source. Es darf frei kopiert, gendert und weitergegeben werden!



Installation
------------
   - FindNewServices.sh nach /var/bin kopieren und die Zugriffsrechte
     auf 0744 setzen.
     
   - falls die Referenzdatei /var/tuxbox/config/enigma/refold.dat.gz
     existiert, sollte diese gelscht werden!

   - findnewservices.cfg und findnewservices.so nach /var/tuxbox/plugins
     kopieren und die Zugriffsrechte auf 0644 setzen.
     
   - das Plugin starten, [Analyse starten] auswhlen und auf die
     Ausgabe des Ausfhrungsprotokolls warten. Plugin dann mit
     [schliessen] beenden. In diesem Schritt wird nur eine 
     Referenzdatei erzeugt, die fr die sptere Analyse wichtig ist.

   - wer mchte kann nun einen Satellitensuchlauf starten ;-)



Bedienung
---------
Das Plugin wird aus dem Plugin-Men heraus aufgerufen. Nach dem Start
stehen folgende Optionen zur Verfgung: 

   [schliessen]
      Das Plugin wird geschlossen.


   [Analyse starten]
      Die Analyse wird gestartet. Dieser Vorgang kann einige
      Minuten in Anspruch nehmen. Es ist jederzeit mglich
      den Vorgang abzubrechen. Hierbei kann es aber zur 
      Beschdigung der Userbouquets kommen. Es wird deshalb
      dringend empfohlen vorher eine Sicherung durchzufhren!
   
      Am Ende der Analyse wird ein Ausfhrungsprotokoll angezeigt.


   [ber...]
      ffnet eine Messagebox mit der Versionsnummer und der
      eMail-Adresse unter der ich zu erreichen bin.



Localisation (L10n)
-------------------
Beim Plugin-Start wird geprft, ob sich im Verzeichnis /var/etc/ eine
Sprachdatei mit Namen FindNewServices.l10n befindet. Sollte diese Datei
existieren, so wird sie verwendet. 

Der Aufbau dieser Datei ist recht simpel:

z.B.

i "schliessen"
o "close"

i "ber..."
o "about..."

i "konnte nicht gefunden werden!"
o "could not be found!"

Die i-Zeile enthlt den Originaltext des Plugins und in der o-Zeile 
befindet sich die bersetzung. Sollte zum Originaltext keine 
bersetzung existieren, so wird er unverndert im Plugin angezeigt.

Um eine Lokalisierung des Shell-Scripts durchzufhren, reicht es aus,
alle Zeilen die mit einem #L10n markiert sind, zu bersetzen. 

Um das Shell-Script zu Lokalisieren, mssen alle Zeilen die mit
einem #L10n markiert sind, bersetzt werden.



Anmerkung
---------
Von mir wurde nur Astra 19.2 getestet. Weitere Satelliten sollten
funktionieren, knnen aber Fehler produzieren. Ich bitte um Nachsicht
und werde mich bemhen diesen Mistand in zuknftigen Versionen zu
beheben.



Bekannte Probleme
-----------------
   - In neueren Enigma-Versionen findet man die Option "Satpositionen 
     ausblenden". Sobald diese aktiviert wird, werden keine Userbouquets
     angelegt.

   - Nachtrglich eingespielte Settings aus dem Internet knnen
     ebenfalls merkwrdige Phnomene erzeugen. Wenn pltzlich
     alle Services als neu erkannt werden, deutet dies auf ein
     Problem mit der Gro-/Kleinschreibung der Datei services hin.
     Ein weiter Grund knnte eine nicht gelschte refold.dat.gz
     sein (siehe Installation).



08.01.2005
LivingOn <LivingOn@x-mail.net>
