Location: PHPKode > projects > Libretto: Web download manager > libretto/content/help_es.php
<?
/*
 * Libretto - Web download manager.
 * Copyright (C) 2007 Jordi Pujol (jordi_pujolATtelefonicaDOTnet).
 * 
 * This program is free software; you can redistribute it and/or modify it under
 * the terms of the GNU General Public License as published by the Free Software
 * Foundation; either version 2 of the License, or (at your option) any later
 * version.
 * 
 * This program is distributed in the hope that it will be useful, but WITHOUT
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
 * FOR A PARTICULAR PURPOSE. See the GNU General Public License for more
 * details.
 * 
 * You should have received a copy of the GNU General Public License along with
 * this program; if not, write to the Free Software Foundation, Inc., 59 Temple
 * Place, Suite 330, Boston, MA 02111-1307 USA
 */

?>

<H1><?echo t('help'); ?></H1>
<H2>Estado de las descargas</H2>
<P>Nos presenta una lista de los trabajos de descarga.<br>
	Con una barra de progreso observamos gr&aacute;ficamente la ocupaci&oacute;n
	del disco que contiene el directorio de descargas, y con otra barra de progreso
	la ocupaci&oacute;n del disco que contiene el directorio cach&eacute;.<br>
	Observamos el estado de cada trabajo, si ha empezado, si est&aacute; en proceso,
	su porcentaje de progreso, si ha acabado satisfactoriamente, la velocidad de descarga
	y de subida, n&uacute;mero de Bytes compartidos, ...<br>
	Los trabajos se gestionan con botones que representan gr&aacute;ficamente las acciones
	que ejecutan mediante iconos. Con ellos se puede parar, reiniciar o cancelar un trabajo.<br>
	Disponemos de los botones siguientes:<br>
	<ul>
	<li>Informaci&oacute;n.
	<li>Abrir.
		<ul>
		<li>Descargar en Local.
		<li>Eliminar ficheros.
		</ul>
	<li>Parar/Reiniciar.
	<li>Cancelar trabajo.
	<li>Ver Log.
	</ul>
</P>
<H2>A&ntilde;adir un trabajo de descarga</H2>
<P><CODE>Libretto</CODE> puede ejecutar distintos tipos de descargas:
<OL>
	<LI><P><B>Un <CODE>fichero</CODE> &uacute;nico.</B><br>
		<CODE>Libretto</CODE> descarga el archivo con uno de los protocolos siguientes:
		<CODE>HTTP, HTTPS, FTP</CODE>.<br>
		Tenemos que escribir la <CODE>URL</CODE> donde se encuentra el fichero.
	</P>
	<LI><P><B>Todos los ficheros de un <CODE>directorio</CODE>.</B><br>
		<CODE>Libretto</CODE> descargar&aacute; todos los ficheros del
		directorio especificado en la <CODE>URL</CODE>, en este caso podemos seleccionar la extensión de
		los ficheros a descargar.<br>
		Soporta los protocolos siguientes: <CODE>HTTP, HTTPS, FTP</CODE>.
	</P>
	<LI><P><B>Crear un <CODE>espejo</CODE> de un lugar Internet.</B><br>
		<CODE>Libretto</CODE> descarga todos los ficheros de
		la ubicaci&oacute;n especificada en la <CODE>URL</CODE>, para crear una imagen espejo.<br>
		Soporta los protocolos: <CODE>HTTP, HTTPS, FTP</CODE>.
	</P>
	<LI><P><B>Protocolo <CODE>BitTorrent</CODE>.</B><br>
		<CODE>Libretto</CODE> necesita el archivo <CODE>.torrent</CODE>
		que contiene la informaci&oacute;n sobre la descarga; podemos especificarlo anotando
		la <CODE>URL</CODE> que apunta al archivo, o subirlo
		desde el ordenador cliente con la
		entrada <CODE>Archivo Local</CODE>.
	</P>
	<LI><P><B>Protocolo <CODE>MetaLink</CODE>.</B><br>
		<CODE>Libretto</CODE> necesita el archivo <CODE>.metalink</CODE>
		que contiene la informaci&oacute;n sobre la descarga; podemos especificarlo anotando
		la <CODE>URL</CODE> que apunta al archivo, o subirlo desde el ordenador cliente con la
		entrada <CODE>Archivo Local</CODE>.
	</P>
	<LI><P><B>Protocolo <CODE>Jigsaw Download</CODE>.</B><br>
		<CODE>Libretto</CODE> necesita dos archivos, uno de tipo <CODE>.jigdo</CODE>
		que contiene la informaci&oacute;n sobre la descarga, y otro archivo de tipo <CODE>.template</CODE>;
		podemos especificarlos subi&eacute;ndolos desde el ordenador cliente con las entradas
		<CODE>Archivo Local</CODE> y <CODE>Archivo Local auxiliar</CODE>, respectivamente.<br>
		Muchas veces una descarga se puede iniciar
		satisfactoriamente solamente con el archivo <CODE>.jigdo</CODE>; podemos especificarlo anotando
		la <CODE>URL</CODE> que apunta al archivo.
	</P>
</OL>
</P>
<H2>Instalaci&oacute;n</H2>
<P>C&oacute;mo instalar f&aacute;cilmente
	<CODE>Libretto</CODE> en un ordenador con <CODE>GNU/Linux</CODE>, <CODE>MS Windows</CODE>, o cualquier
	Servidor Web que disponga de <CODE>PHP</CODE>, un sistema de autorizaci&oacute;n de usuarios,
	y las utilidades <CODE>Wget</CODE>, <CODE>Aria2</CODE>,
	<CODE>Enhanced Ctorrent</CODE> o <CODE>Jigsaw Download</CODE>.
</P>
<OL>
	<LI><P><CODE>Libretto</CODE> correr&aacute; en
		cualquier servidor Web equipado con un entorno de ejecuci&oacute;n
		<CODE>PHP</CODE>. Debe tener espacio de disco para almacenar las descargas.<br>
		El cliente es un navegador Web con interfase gr&aacute;fico.
	</P>
	<LI><P>La seguridad a nivel de usuario es gestionada por el Servidor Web. <CODE>Libretto</CODE>
		puede funcionar con servidores <CODE>HTTP</CODE> compatibles con autentificaci&oacute;n
		<CODE>PHP</CODE> como <CODE>Apache</CODE> o <CODE>IIS</CODE>.<br>
		La configuraci&oacute;n se anota en el archivo <CODE>includes/settings.php</CODE>.<br>
		Para cada usuario especificaremos su nombre en el sistema, su nombre completo y
		tambi&eacute;n el directorio destino de sus descargas,
		en el que <CODE>Apache</CODE> (<CODE>www-data</CODE>) debe tener permiso para
		<CODE>lectura/escritura</CODE>.<br>
		Definiendo un usuario <CODE>Administrador</CODE> podremos gestionar los trabajos de todos los usuarios
		con el interfase de <CODE>Libretto</CODE>.<br>
		Sin embargo, usted puede arrancar la aplicaci&oacute;n sin configurar la seguridad
		ni definir usuarios, en este caso todos ellos usan el mismo directorio para almacenar las descargas.</P>
</OL>
<P>Suponemos un sistema <CODE>Debian GNU/Linux</CODE>
</P>
<P>Desempaquetamos <CODE>Libretto</CODE> en un directorio, por ejemplo <CODE>/home/www/libretto</CODE>
</P>
<P>Creamos un enlace a este directorio</P>
<PRE>ln -s /home/www/libretto /var/www/libretto</PRE>
<P>En el archivo <CODE>includes/settings.php</CODE> definimos los directorios temporal
	y de descarga, si queremos seguridad a nivel de usuario crearemos una lista de los usuarios y,
	s&oacute;lo en el caso de que no se encuentren en el <CODE>PATH</CODE> del sistema, las ubicaciones de las
	utilidades <CODE>Wget</CODE>, <CODE>Aria2</CODE>,
	<CODE>Enhanced Ctorrent</CODE> o <CODE>Jigsaw Download</CODE>.</P>
<P>Para probar el funcionamiento definiremos
<PRE>$authrequire = <B>false</B>;</PRE>
Escribiremos en el navegador Web:</P>
<PRE>http://localhost/libretto</PRE>
<H2>Servidor Web</H2>
<P><CODE>Libretto</CODE> es compatible con cualquier tipo de autorizaci&oacute;n
	disponible en el servidor Web.
</P>
<P>Por ejemplo, en un sistema <CODE>Debian GNU/Linux</CODE> y el servidor
	de p&aacute;ginas Web <CODE>Apache v2</CODE> podemos hacer que cada usuario del
	sistema <CODE>Debian GNU/Linux</CODE> sea usuario de <CODE>Libretto</CODE>,
	y se identifique con su propio usuario y contrase&ntilde;a.</P>
<P>Suponemos que el sistema <CODE>Debian GNU/Linux</CODE> ha sido configurado con <CODE>shadow
passwords</CODE>. Ha de estar instalado el Servidor Apache2, los m&ograve;dulos php5 (o php4) y auth-pam</P>
<P>Editamos el fichero <CODE>/etc/apache2/httpd.conf</CODE></P>
<PRE>&lt;Directory &quot;/var/www/libretto/&quot;&gt;
	AllowOverride AuthConfig
	AuthBasicProvider file
	AuthUserFile /etc/shadow
	AuthPAM_Enabled on
	AuthName &quot;Libretto Web Download Manager&quot;
	AuthType Basic
	require valid-user
&lt;/Directory&gt;</PRE>
<H2>Automatizar los trabajos de descarga</H2>
<P>En un proceso Batch podemos a&ntilde;adir trabajos para <CODE>Libretto</CODE> siguiendo estas instrucciones.<br>
Por ejemplo para iniciar la descarga del archivo <CODE>Jigsaw Download</CODE> que se encuentra en <CODE>http://inter.net/file.jigdo</CODE><br>
Suponemos que nuestro servidor se encuentra protegido pos usuario y contrase&ntilde;a  <CODE>myuser:mypass</CODE>;
enviaremos a nuestro servidor Web la <CODE>URL</CODE> con el c&oacute;digo siguiente:
</P>
<PRE>http://myuser:hide@address.com/libretto/index.php?batch=true&amp;url=http://inter.net/file.jigdo
</PRE>
<P>Los par&aacute;metros disponibles son:
</P>
<P>
<UL>
	<LI><B>url</B> es la <CODE>URL</CODE> de un archivo de Internet o la <CODE>dirección absoluta</CODE>
	de un archivo que se encuentra en el disco de nuestro servidor Web.
	Es el &uacute;nico par&aacute;metro requerido, los dem&aacute;s son opcionales.
	<LI><B>downloadtype</B> Si escribimos <CODE>auto</CODE> o no lo incluimos, <CODE>Libretto</CODE> deducir&aacute; este valor; los valores posibles son:
	<UL>
		<LI><b>auto</b> (default)
		<LI><b>file</b>
		<LI><b>directory</b>
		<LI><b>mirror</b>
		<LI><b>torrent</b>
		<LI><b>metalink</b>
		<LI><b>jigdo</b>
	</UL>
	<LI><B>mask</B> Cuando <CODE>Libretto</CODE> descarga los archivos de un directorio podemos escoger la extensi&oacute;n a descargar. Ej: <CODE>.jpg</CODE><br>
	Ver <CODE>man wget</CODE> para m&aacute;s informaci&oacute;n.
	<LI><B>httpuser</B> Es el nombre de usuario para acceder a un archivo que se encuentra en una URL protegida.
	<LI><B>httppasswd</B> Es la contrase&ntilde;a para acceder a un archivo que se encuentra en una URL protegida.
	<LI><B>urltype</B> Es el tipo de la ubicaci&oacute;n donde se encuentra el archivo.<br>
	Si escribimos <CODE>auto</CODE> o no lo especificamos, <CODE>Libretto</CODE> deducir&aacute; este valor; los valores posibles son:
	<UL>
		<LI><b>auto</b> (default)
		<LI><b>url</b>
		<LI><b>fileserver</b>
		<LI><b>filelocal</b> (s&oacute;lo se puede usar en Interactivo)
	</UL>
	<LI><B>subdircheck</B> Es un indicador de que <CODE>Libretto</CODE> ha de generar un nombre para el subdirectorio de descarga.
	<UL>
		<LI><b>true</b> (default)
		<LI><b>false</b>
	</UL>
	<LI><B>subdirname</B> Es el nombre que nosotros queremos para el subdirectorio de descarga.
</UL>
</P>
<P>Por ejemplo, iniciaremos la descarga seguiente con el protocolo <CODE>Bittorrent</CODE> con el archivo de descripción
que se encuentra en la <CODE>URL</CODE> de Internet <CODE>http://inter.net/path/file.torrent</CODE>;
y guardaremos los archivos en el subdirectorio <CODE>mytorrents</CODE>
</P>
<PRE>http://myuser:hide@address.com/libretto/index.php?batch=true&amp;url=http://inter.net/path/file.torrent&amp;subdirname=mytorrents
</PRE>
Return current item: Libretto: Web download manager