# TRANSMISSION BITTORRENT y aMule para WebTV (v7.0) #

Este paquete contiene un cliente BitTorrent (Transmission) para el WebTV de
BluSens, además de un servidor de FTP y el cliente aMule.

Son varias partes: por un lado, el Transmission en sí, el demonio aMule,
el servidor aMuleweb, telnetd y FTPd, un programa para buscar automáticamente
subtítulos de series, otro para reparar aquellos que tienen temporizaciones
incorrectas, y por último una microaplicación web para poder ver desde el
menú del WebTV como van las descargas y gestionarlo todo.

IMPORTANTE: por defecto, todos estos servicios están desactivados, incluso
el de telnetd. Es preciso entrar en la aplicación "Zona de descargas" y
seleccionar la opción "Gestionar servicios" para activar los que se deseen.
Para más información, ver la sección SELECCIONAR QUE SERVICIOS SE QUIEREN
LANZAR, en este mismo archivo de instrucciones.

Las maneras de interactuar con el programa son las siguientes:

 * Desde el propio WebTV: requiere de la última versión del firmware
para poder abrir la página de BitTorrent o aMule desde una ventana de
navegador. La clave de aMule es "amulepass" (sin comillas).

 * Desde el navegador de un PC, acceder al puerto 9090 del WebTV para
BitTorrent, o al puerto 4711 para aMule. Ejemplo: si la IP del WebTV
es la 192.168.1.102, habría que poner en el navegador:

	http://192.168.1.102:9090

para acceder a Transmission, o bien:

	http://192.168.1.102:4711

para acceder a aMule.

Este método permite, además, configurar varias opciones del programa, como
por ejemplo las tasas de bajada y subida (fijadas por defecto a 500KB y
40KB).

Además, en el puerto 3335 estará un servidor telnet, y en el puerto 2121
un servidor de FTP. Ninguno tiene clave, por lo que se recomienda no permitir
el acceso desde el exterior.

 * Usar el plugin "Add to transmission" para Firefox, desde el navegador de
un PC. Este plugin añade una opción en el menú del botón derecho del ratón,
("Add to transmission") que, cuando se selecciona sobre un enlace a un fichero
.torrent, lo envía automáticamente al cliente Transmission que esté
configurado. Así, si configuramos nuestro WebTV en el plugin, podremos enviar
fácilmente cualquier torrent que encontremos desde nuestro PC. El plugin se
puede descargar desde

	https://addons.mozilla.org/en-us/firefox/addon/add-to-transmission/

Es necesario configurar el plugin con la dirección adecuada del WebTV. Para
ello, ir a Herramientas->Add-ons, pulsar el botón de Configurar del plugin,
y poner como dirección:

	http://XXX.YYY.ZZZ.PPP:9090/transmission/rpc

Siendo XXX.YYY.ZZZ.PPP la dirección IP del WebTV. Así, si ésta fuese
192.168.1.102, la línea quedaría

	http://192.168.1.102:9090/transmission/rpc

* Si se copia un fichero .torrent en la carpeta /bg_apps/BITTORRENT/autostart
éste comenzará a bajarse automáticamente.

* Abriendo, desde el navegador de internet del propio WebTV, la dirección

	http://127.0.0.1:9090

o bien

	http://127.0.0.1:4711

Los ficheros descargados por el cliente, tanto de Bittorrent como de aMule,
se almacenan en /bg_apps/BITTORRENT.


## COMO INSTALARLO ##

Necesitais un pincho USB o (mejor) un disco duro USB. Ojo con los discos duros
que se alimentan desde el USB: el WebTV no es capaz de dar mucha corriente,
por lo que no suelen funcionar. Es mejor usar un disco con alimentador externo,
o bien meter en medio un HUB USB con alimentación externa.

El disco tiene que estar formateado en EXT3 (solo se puede hacer desde Linux),
o en NTFS (que se puede hacer desde Windows).

Simplemente hay que copiar, tal cual, las dos carpetas que contiene este
paquete (*applications* y *bg_apps*) al disco duro, y luego enchufarlo al WebTV.
Si no funciona, reiniciar el WebTV.

IMPORTANTE: el contenido del fichero ZIP debe descomprimirse en el raiz del
disco duro, nunca dentro de ninguna otra carpeta. Si ya había una carpeta
"applications" en dicho disco, la carpeta "bg_apps" de transmission debe
quedar junto a ésta, y el contenido de "applications" de transmission debe
mezclarse con el "applications" que había en el disco.


## ACTUALIZAR DESDE UNA VERSION ANTERIOR ##

Las instrucciones para ello estan en el fichero ACTUALIZAR.txt.


## SERVIDOR FTP ##

El servidor FTP permite acceder a la carpeta de BitTorrent mediante este
protocolo. No es posible acceder al disco entero por culpa de las limitaciones
de las aplicaciones en segundo plano, sólo al contenido de /bg_apps.

Para conectarse al FTP del WebTV, usar la IP de éste y el puerto 2121.


## SERVIDOR TELNET ##

El servidor Telnet está en el puerto 3335, para así no interferir con el telnet
de cualquier otro disco con servicios en segundo plano.


## BUSCAR/REPARAR SUBTITULOS ##

Es posible buscar subtítulos de manera automática gracias a la integración de
la herramienta Submarine. Tras escoger esta opción aparece una lista de los
ficheros bajados en el directorio /bg_apps/BITTORRENT. Tras escoger uno con
las flechas arriba y abajo, y pulsar OK, se nos preguntará la lengua en la que
queremos buscar los subtítulos. Dicha lengua se especifica mediante códigos
de dos letras ISO 639-1: 'es' para castellano, 'en' para ingles, 'pt' para
portugues... el resto de códigos se pueden consultar en

    http://en.wikipedia.org/wiki/List_of_ISO_639-1_codes

La aplicación recuerda la lengua especificada, por lo que no será necesario
introducirla de nuevo salvo que cambie.

Una vez escogida la lengua, se pulsa OK y automáticamente se buscarán en
diversas páginas subtítulos para el fichero indicado, basándose en el nombre,
tamaño, duración, e incluso HASH. Si se encuentra alguno, se bajará y
renombrará automáticamente, de manera que su nombre coincida con el del fichero
y así poder ser usado directamente.

Si en lugar de escoger un fichero de video, se selecciona uno de subtitulos
en formato SRT, la aplicación procedera a comprobar si alguna frase comienza
justo en el mismo instante en que termina la anterior, y lo corregira (esto es
necesario, porque en algunos de esos casos, el WebTV se salta esa frase). Esta
operacion no hace falta realizarla si se han buscado subtitulos de manera
automatica, porque ya la realiza la aplicacion al finalizar, automaticamente.

Submarine es una nueva aplicacion de subtitulos, y algunas opciones de busqueda
todavia estan en fase alfa. Si da problemas a la hora de encontrar subtitulos,
por favor, ponte en contacto conmigo para intentar corregirlos.

Ademas, no es la version oficial, sino un branch creado por mi con mas
servidores que el original. Puedes encontrar el codigo fuente en

    https://github.com/rastersoft/submarine

No olvidar que es necesario activar manualmente los subtítulos en el WebTV.


## DESCOMPRIMIR FICHEROS ##

Es posible descomprimir ficheros comprimidos en formato ZIP y RAR. Para ello,
basta con escoger esta opción, y se listarán todos los ficheros .zip y .rar
del directorio BITTORRENT. Pulsando sobre el deseado, se procederá a
descomprimirlo en el mismo directorio.

Es importante resaltar que en este modo sólo se listan los ficheros acabados
en .zip y .rar, por lo que no aparecerán los ficheros que se hayan
descomprimido.

También es importante saber que se sobreescribirá cualquier fichero si, al
descomprimir algo, contiene otro fichero con el mismo nombre.


## GUARDAR CONFIGURACION DE BITTORRENT ##

Debido a como está hechos el demonio bittorrent, los cambios que se hacen a
la configuración desde la interfaz no se guardan al apagar el WebTV. Por eso,
si se modifican éstos, hay que usar esta opción, para asegurarse de
que queden correctamente guardados y se utilicen al reiniciar el aparato.

Debe tenerse en cuenta que esta opción lo que hace realmente es matar el
cliente BitTorrent, y lanzarlo de nuevo.


## SELECCIONAR QUE SERVICIOS SE QUIEREN LANZAR ##

Para hacer esto, basta con ir a la opción "Gestionar servicios". Al hacerlo,
aparecerá una lista de todos los servicios, y su estado (Activo o Inactivo).
Si se pulsa OK sobre un servicio inactivo, el servicio se lanzará. Si se
pulsa OK sobre un servicio ya activo, se detendrá y se volverá a lanzar (esto
es útil para reiniciarlo si, por la razón que sea, deja de responder). Si se
pulsa el botón amarillo sobre un servicio activo, se detendrá completamente.

El estado de los servicios se mantiene aunque se apague el WebTV; así, si
tenemos activos el telnet y el transmission, y apagamos el sistema, al
encenderlo sólo se lanzarán esos dos servicios, permaneciendo el resto
inactivos.


## ABRIR PUERTOS ##

En general, tanto Transmission como aMule incluyen soporte de uPNP; sin
embargo, en algunos casos éste falla, lo que significa que puede ser
necesario abrir manualmente en el router los puertos utilizados por estos.

Si se desea añadir una clave a BitTorrent Transmission, debe hacerse de
la siguiente manera:

  * desactivar el servicio desde la opcion "Gestionar servicios"

  * entrar por telnet en el WebTV (puerto 3335)

  * editar la configuracion de bittorrent con el comando

        busybox vi /etc/settings.json

    y añadir el nombre de usuario y la clave


Hay mas detalles de como configurar la clave de Bittorrent en la documentacion
oficial, en:

    http://www.transmissionbt.com/

Cualquier duda o propuesta, mejor en el foro de BluSens:

  http://developers.blusens.com/forum/

Las nuevas versiones se pueden encontrar en la página del autor:

  http://www.rastersoft.com

