README voor Shoenix Subtitle Download script:
---------------------------------------------

Dit is de Enigma1 plugin versie van de eerder uitgebrachte
Flexmenu versie voor Shoenix Subtitle Download. De plugin
is eenvoudig te installeren door de zipfile uit te pakken
en de bestanden 'subtitle.so' en 'subtitle.cfg' in de
directory /etc/tuxbox/plugins (of /var/tuxbox/plugins) op
de dreambox te kopieren.

Afhankelijk van de Drtic installatie moet de subtitle directory
worden aangepast. Dit kan door het bestand 'subtitle.cfg' te
openen en de 'drticdir' variabele aan te passen. 

Let Op: Zorg dat je een kopie maakt van dit bestand als alles
werkt. Bij een normale plugin installatie zal dit bestand
namelijk worden overschreven. De bedoeling is dat dit bestand
juist geconfigureerd wordt door de betreffende image bouwers
die deze plugin ter download aanbieden (PLi, Gemini, etc.) zodat
deze kan worden afgestemd om de Drtic installatie in dezelfde
Images.

Gebruik:
--------
- Start de plugin vanuit het plugin menu

Er zijn 2 manieren om ondertitels te zoeken:
	1. Dmv de titel, of deel van de titel, in te voeren
	2. Vanuit de EPG

- Kies in het hoofdmenu de zoekvorm.

Bij handmatig zoeken:
	- Voer in het volgende scherm de titel, of deel van de titel in
	- Druk op de groene knop om te zoeken
	- Kiest de te downloaden ondertitel en druk op 'OK'
	- Indien er niets wordt gevonden, pas dan de zoek term aan door
	  op de gele knop te drukken.

Bij EPG zoeken:
	- Zorg dat er EPG data voor het kanaal aanwezig is
	- Kies de optie 'Search from EPG'
	- De plugin zal nu de EPG data ophalen en laten zien
	- Kies de betreffende EPG regel en druk 'OK'
	- Je komt nu in het zoek scherm en het zoeken wordt automatisch
	  gestart. 
	- Zie verder 'Handmatig zoeken'

Hoe werkt het:
--------------
De plugin maakt verbinding met mijn server. Deze zal de betreffende ondertitels
downloaden en converteren naar Drtic formaat. De geconverteerde ondertitels 
worden op mijn server bewaart. Het kan daarom zijn dat de ene keer het downloaden
sneller gaat dan de andere keer. Het converteren kost namelijk nogal wat tijd.

Problemen:
----------
Controlleer het volgende wanneer je problemen hebt:

- Is er een internet verbinding vanaf de dreambox ?
- Is het goede pad naar de Drtic ondertitel directory geconfigureerd ?
- Kan je een verbinding maken naar http://flexmenu.shoenix.nl ?

Indien al deze zaken zijn gechecked, en het werkt nog niet, doe dan het volgende:

- Log in op de dreambox
- Open het bestand 'subtitle.cfg'
- Verander 'debug=0' naar 'debug=4'
- Sla het bewerkte bestand op

Nu zal bij het starten van de plugin debug informatie worden geschreven naar het
bestand /tmp/pluginlog. Voer nu de acties uit die je eerst ook deed en zet hierna
weer de debug op '0'.

Stuur mij een mailtje (subtitles <at> shoenix.nl) en voeg het pluginlog bestand
toe als attachment/bijlage.

Bugs/Onvolledigheden:
---------------------
Het is momenteel alleen mogelijk om EPG zoek acties te doen wanneer HTTP Authenticatie
in de image is uitgeschakelt. Misschien dat dit in de toekomst wel kan, maar momenteel
is er vanuit enigma geen ondersteuning voor webserver connecties met userid/passwords.

Bedankjes:
----------
Dank aan het DBF4ALL team (met name Satstarter) voor het testen. Dank aan dAF2000
van het PLi team voor generieke input over plugin zaken. En last but not least,
dank aan www.nlondertitels.com voor hun diensten!!!
