Installation
============

Bevor man neutrinoTV nutzen kann mss man sicherstellen dass folgende Komponenten auf dem System installiert sind: 

1.) Microsoft .NET Framework 2.0 
3.) VLC Player mit installiertem ActiveX plugin (v0.8.4a oder v0.85). ACHTUNG: Das ActiveXPlugin ist nicht das Gleiche wie das Mozilla-Plugin. 

Wenn neutrinoTV startet und es einfach nur abstrzt fehlt einer der obigen Komponenten oder ist in der falschen Version vorhanden. 

Auf http://neutrinotv.homeip.net/ und http://www.neutrinotv.defindet man folgendes
(Mirror gibts auch von jmittelst unter: http://jmittelst.no-ip.com/ntv/ - hier sind auch die wichtigsten Informationen hinterlegt und desweiteren gibts hier links fr alternative downloads der bentigten Komponenten. Vielen Dank dafr an jmittelst!) 

A.) files/neutrinoTV-1.1Bxxxx.zip: ein Archiv mit den ntigen Dateien - einfach irgendwohin kopieren und starten (der Installer ist nicht notwending und es reicht wenn man die aktuellste Version nimmt).

B.) files/neutrinoTV-1.1Bxxxx-Setup.exe: Das Gleiche als installer (falls ein Installer fr die Version erstellt wurde)


C.) test/neutrinoTV-1.1Bxxxx-Test.zip: Vorabversion zum testen.





Kurzanleitung (v0.9 B2282)
==========================

Nach dem ersten erfolgreichen Start von neutrinoTV muss zunchst die IP Adresse der dbox eingetragen werden. Dies macht man in den Einstellungen (Settings) unter dem Reiter Netzwerk (Network) im Feld "Dbox IP or Hostname". Bei erfolgreichem setzen der IP erscheint darber auch eine Meldung im Log. Die Einstellungen knnen danch geschlossen werden.

Ein Klick auf "Get Channels" ladet alle Kanle von der dbox. Nachdem alle Kanle geladen wurden, ndert der Button "Get Channels" sein Bedeutung in "Refresh EPG" - damit kann man die aktuellen EPG Daten erneut abfragen und bei Bedarf lokal aktualisieren.

Mit "Go Live" kann man nun den aktuellen Kanal streamen. Man kann mit Pfeil Runter/Rauf whlen welchen EPG man rechts sehen mchte. Pfeil links/rechts wechselt den selektierten EPG Eintrag unterhalb des Bildes. Mit "Bild Auf" bzw. "Bild Ab" schaltet man einen Kanal vor bzw. zurck. Doppelklick auf einen Kanal in der Kannalliste schaltete auch auf diesem um - egal ob man gerade live ist oder nicht. 

Ein Doppelklick ins Bild bzw. drcken der Taste F8 schaltet in den Fullscreen Modus um (und von da wieder zurck). Die Hotkeys Bild auf/ab funktionieren auch im Fullscreen modus.
Im Fullscreen Modus wird durch Drcken der ENTER Taste eine Kanalliste, hnlich wie bei neutrino, aufgerufen. Pfeil Auf/Ab whlt innerhalb des Bouquets, Pfeil rechts/links wechselt das Bouquet. Durch erneutes drcken von ENTER wechselt man auf den selektierten Kanal. Mit ESC schliesst man diese Liste. 

Ein Klick in das Beschreibungfenster (rechts neben dem Bild) schliesst dieses. Durch Doppelklick auf die aktuelle Vorschau (unter dem Bild) bekommt man das Detail Fenster wieder. 
Wenn man auf "Go Live" geht, so wird automatisch das Beschreibungsfenster ausgeblendet. 

Timeshift wird (noch?) nicht untersttzt.


Einstellungsmglichkeiten (Meneintrag Einstellungen "Settings"):
=================================================================

Default Einstellungen sind in der Datei neutrinoTV.config zu finden. Sofern man in der GUI Werte ndert werden diese in der Datei "\Dokumente und Einstellungen\<username>\Lokale Einstellungen\Anwendungsdaten\neutrinoTV\neutrinoTV.exe_<Hashwert>\<version>\user.config" gespeichert. Wenn es mal Probleme mit den Einstellungen gibt kann man die user.config (oder das gesamte Verzeichnis) lschen.

Das Einstellungen sind unterteilt in folgende Kategorien (Reiter):

General:
--------
- "Load services automatically on start": Damit wird der "Get Channels" Button automatisch direkt beim Programmstart gedrckt. Dies bedeutet, dass abhngig von der nchsten Einstellung, die Kanle und er EPG zu Beginn entweder aus einer Datei oder direkt von der Box gelesen werden.
- "Load/Save services from/to file": Wenn diese Auswahl gesetzt ist, werden bei Programmende die gesamte Kanalliste und der zugehrige EPG in eine lokale Datei gespeichert - und knnen von dort bei nchsten Start sofort wieder ausgelesen werden. Die Kananlliste wird binr in der Datei "\Dokumente und Einstellungen\<username>\Anwendungsdaten\neutrinoTV\neutrinoTV\<neutrinoTV Version>\services.ntv" gespeichert. Wenn es mal Probleme gibt, einfach die Datei lschen, beim nchsten Start ld neutrinoTV die services neu von der Box.
- Einstellungen unter welchen Bedingungen die InfoBar angezeigt werden soll

Netzwerk:
---------
- "Dbox IP or hostname": Hier muss man den Namen (DNS) oder direkt die IP der dbox eintragen.

Audio:
------
- "Use preffered audio when going live": Wenn diese Auswahlbox gesetzt ist, wird beim Starten und beim Zappen gesucht ob es eine Audiobeschreibung gibt, welche den Text unter "Preffered audio" enthlt (substring matching). Wenn eine bereinstimmung gefunden wird, wird dieser Audiokanal vorgewhlt.
- "Preferred Audio": Das ist der string nach dem gesucht wird fr die Audiokanal Vorwahl. Der string ist case-insensitive, und es reicht wenn er irgndwo in der Beschreibung des Audiostroms vorkommt. Z.B. "engli" wrde sowohl "Englisch", "englisch" als auch "english" finden. Oder "Dolby" wrde alle Varianten von Dolby Digital  finden.

Video:
------
Noch keine Eintrge - hier kommt demnchst z.B. dwie Wahl des deinterlace moduses, evtl weitere Bildfilter die Sinn machen.

EPG:
----
 - "EPG aead: renew EPG only if local database ends earlier (in h)": Der detailierte EPG eines Kanals wird nur abgefragt wenn die lokale Datenbank weniger als die eingetragenen Stunden in die Zukunft reicht. Kleine Werte fhren somit zu recht seltenen Updates - hohe Werte fhren zu eine grossen Datenbank (macht erst richtig Sinn wenn EPG Plus ala neutrino fertig ist). Nur um keine Missverstndnisse aufkommen zu lassen: Diese Zahl (in Stunden) regelt NICHT wieweit in die Zukunft der EPG updated wird - es wird immer alles geladen was die box hergibt. Dieser Wert regelt nur WANN gefragt wird.
- "Automatically update EPG on every zapping": Bei jedem Umschalten mit neutrinoTV wird der EPG angefragt und bei Bedarf die lokale Datenbank updated. Bedarf bedeutet dass sowohl die lokale Datenbank frher "endet" als jetzt + EPG Ahead-Zeit udn es nicht in der letzeten Minute schon mal updated wurde.

Record:
-------
Hier kann man das Verzeichnis angeben wohin aufgenommen Datein gespeichert werden. Wenn der Eintrag leer ist, so werden die aufgezeichneten Datein in "Eigenen Dateien" gespeichert.

Advanced VLC:
-------------
In MRL Template kann der string eingetragen werden, welcher verwendet wird um auf den live stream der box zuzugreifen.
Folgenden Variablen knnen dabei vrwendet werden:
<IP> - IP adresse der dbox
<PORT> - Streamingport der dbox (normalerweise 31339)
<PIDString> - Der string um auf einen bestimmten kanal zuzugreifen, also 0,PMT,vpid,apids..
Mit dem Button default kann man den funktioniereden default wiederherstellen. Diese Einstellung ist im wesetnlichen zum experimentieren gedacht und sollte im Normalfall nicht gendert werden.

Das VLC-Plugin unterstzt fast alle Kommandos die der "grosse" VLC auch kann. In der "Options Control" knnen VLC Optionen in der Form ":<befehl>" eingetragen werden. z.B. ":novideo" schaltet das video ab, oder ":fullscreen" schaltet in fullscreen. Die optionen werden NICHT "on the fly" gesetzt - man muss dafr den Live Stream stoppen und neu starten oder einfach den aktuellen kanal wechseln. Weitere Beispiel fr Optionen sind in der Datei VLCOptions.txt zu finden.

Mit dem Button "Clear" lscht man die VLC Optionen. Mit "Save" kann man die derzeitigen Optionen in einer neutrinoTV VLC Options (*.nvo) Datei speicher und mit "Load" wieder laden. 


Advanced:
---------
- "Waiting time before zapping (in ms)": Dies ist eine Experteneinstellung. Falsche Werte fhren dazu, dass die Box hngen bleibt, bzw. kein pids mehr zurckliefert. Die Zeit in ms gibt an, wie lange gewartet wird, nachdem das streaming beendet wurde bevor das zapping eingeleitet wird. Niedrige Werte beschleunigen das zapping, erhhen aber das Risiko, dass man die Box rebooten muss...
- "Waiting time after zapping (in ms)": Dies ist eine Experteneinstellung. Falsche Werte fhren dazu, dass die Box hngen bleibt, bzw. kein pids mehr zurckliefert. Die Zeit in ms gibt an, wie lange gewartet wird, nachdem umgeschaltet (ge-zapped) wurde bevor man den stream erneut anfragt, also das live streaming wieder startet. Niedrige Werte beschleunigen das zapping, erhhen aber das Risiko, dass man die Box rebooten muss...



Known Bugs
==========
Zu viele um aufzuzhlen... 