<?
/*
* 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>Estat de les descàrregues</H2>
<P>Ens presenta una llista amb les feines de descàrrega.<br>
Amb una barra de progrés observem gràficament la ocupació del disc que conté
el directori de descàrregues, i amb una altre barra de progrés la ocupació del disc
que conté el directori cau.<br>
Observem l'estat de cada feina, si ha començat, si està en procés,
el seu percentatge de progrés, la velocitat de descàrrega i de pujada,
número de Bytes compartits, si ha acabat satisfactòriament, ...<br>
Les feines es gestionen amb botons que representen gràficament les accions que executen
amb icones. Amb els que es pot parar, reiniciar o cancel·lar una feina.<br>
Disposem dels botons següents:<br>
<ul>
<li>Informació.
<li>Obrir.
<ul>
<li>Descarregar en Local.
<li>Eliminar fitxers.
</ul>
<li>Aturar/Reiniciar.
<li>Cancel·lar feina.
<li>Veure Log.
</ul>
</P>
<H2>Afegir una feina de descàrrega</H2>
<P><CODE>Libretto</CODE> pot executar diferents tipus de descàrregues; són:
<OL>
<LI><P><B>Un <CODE>fitxer</CODE> únic.</B><br>
<CODE>Libretto</CODE> descarrega el fitxer amb un dels protocols següents:
<CODE>HTTP, HTTPS, FTP</CODE>.<br>Hem d'escriure la <CODE>URL</CODE> òn es troba
el fitxer.
</P>
<LI><P><B>Tots els fitxers d'un <CODE>directori</CODE>.</B><br>
<CODE>Libretto</CODE> descarrega tots els fitxers del
directori especificat en la <CODE>URL</CODE>, en aquest cas podem seleccionar l'extensió dels
fitxers a descarregar.<br>
Suporta els protocols següents: <CODE>HTTP, HTTPS, FTP</CODE>.
</P>
<LI><P><B>Crear un <CODE>mirall</CODE> d'un lloc d'Internet.</B><br>
<CODE>Libretto</CODE> descarrega tots els fitxers de
la ubicació especificada en la <CODE>URL</CODE>, per crear una imatge mirall.<br>
Soporta els protocols: <CODE>HTTP, HTTPS, FTP</CODE>.
</P>
<LI><P><B>Protocol <CODE>BitTorrent</CODE>.</B><br>
<CODE>Libretto</CODE> necessita el fitxer <CODE>.torrent</CODE>
que conté la informació sobre la descàrrega; podem escriure
la <CODE>URL</CODE> que apunta al fitxer, o pujar-lo
des de l'ordinador client amb la
entrada <CODE>Fitxer Local</CODE>.
</P>
<LI><P><B>Protocol <CODE>MetaLink</CODE>.</B><br>
<CODE>Libretto</CODE> necessita el fitxer <CODE>.metalink</CODE>
que conté la informació sobre la descàrrega; podem escriure
la <CODE>URL</CODE> que apunta al fitxer, o pujar-lo
des de l'ordinador client amb la
entrada <CODE>Fitxer Local</CODE>
</P>
<LI><P><B>Protocol <CODE>Jigsaw Download</CODE>.</B><br>
<CODE>Libretto</CODE> necessita dos fitxers, un de tipus <CODE>.jigdo</CODE>
que conté la informació sobre la descàrrega, i un altre fitxer
de tipus <CODE>.template</CODE>;
podem pujar-los des de l'ordinador client amb les entrades
<CODE>Fitxer Local</CODE> i <CODE>Fitxer Local auxiliar</CODE>, respectivament.<br>
Moltes vegades una descàrrega no necessita el fitxer auxiliar i comença
satisfactòriament tant sols amb el fitxer <CODE>.jigdo</CODE>; podem escriure
la <CODE>URL</CODE> que apunta al fitxer.
</P>
</OL>
</P>
<H2>Instal·lació</H2>
<P>Com instal·lar <CODE>Libretto</CODE> fàcilment
en un ordinador amb <CODE>GNU/Linux</CODE>, <CODE>MS Windows</CODE>, o qualsevol
Servidor Web que disposi de <CODE>PHP</CODE>, d'un sistema de autorització d'usuaris,
i les utilitats <CODE>Wget</CODE>, <CODE>Aria2</CODE>,
<CODE>Enhanced Ctorrent</CODE> o <CODE>Jigsaw Download</CODE>.
</P>
<OL>
<LI><P><CODE>Libretto</CODE> corre en
qualsevol servidor Web equipat amb un entorn d'execució
<CODE>PHP</CODE>. Ha de tenir espai de disc per emmagatzemar les descàrregues.<br>
El client és un navegador Web amb interfase gràfic.
</P>
<LI><P>La seguretat a nivell d'usuari es gestiona amb el Servidor Web. <CODE>Libretto</CODE>
pot funcionar amb servidors <CODE>HTTP</CODE> compatibles amb autentificació
<CODE>PHP</CODE> com <CODE>Apache</CODE> o <CODE>IIS</CODE>.<br>
La configuració s'escriu en el fitxer <CODE>includes/settings.php</CODE>.<br>
Per cada usuari posarem el seu nom en el sistema, el seu nom complert i
també el directori destí de les descàrregues,
en el que <CODE>Apache</CODE> (<CODE>www-data</CODE>) ha de tenir permís per
<CODE>lectura/escritura</CODE>.<br>
Definint un usuari <CODE>Administrador</CODE> podrem gestionar les feines de tots els usuaris
amb l'interfase de <CODE>Libretto</CODE>.<br>
No obstant, vostè també pot arrancar l'aplicació sense configurar la seguretat
ni definir usuaris, en aquest cas tots ells fan servir el mateix directori per guardar les
descàrregues.</P>
</OL>
<P>Suposem un sistema <CODE>Debian GNU/Linux</CODE>
</P>
<P>
Desempaquetem <CODE>Libretto</CODE> en un directori, per exemple <CODE>/home/www/libretto</CODE>
</P>
<P>Crearem un enllaç a aquest directori</P>
<PRE>ln -s /home/www/libretto /var/www/libretto</PRE>
<P>En el fitxer <CODE>includes/settings.php</CODE> definim els directoris temporal
i de descàrrega, si volem seguretat a nivell d'usuari crearem una llista dels usuaris i,
només en el cas de que no es trobin en el <CODE>PATH</CODE> del sistema, les ubicacions de les
utilitats <CODE>Wget</CODE>, <CODE>Aria2</CODE>,
<CODE>Enhanced Ctorrent</CODE> o <CODE>Jigsaw Download</CODE>.</P>
<P>Per provar el funcionamient definirem
<PRE>$authrequire = <B>false</B>;</PRE>
i escriurem en el navegador Web:</P>
<PRE>http://localhost/libretto</PRE>
<H2>Servidor Web</H2>
<P><CODE>Libretto</CODE> és compatible amb qualsevol tipus d'autorització
disponible en el servidor Web.
</P>
<P>Per exemple, en un sistema <CODE>Debian GNU/Linux</CODE> i el servidor
de pàgines Web <CODE>Apache v2</CODE> podem fer que cada usuari del sistema
<CODE>Debian GNU/Linux</CODE>
sigui usuari de <CODE>Libretto</CODE>, i s'identifiqui amb el seu propi nom d'usuari i paraula de pas.</P>
<P>Soposem que el sistema <CODE>Debian GNU/Linux</CODE> s'ha configurat amb <CODE>shadow passwords</CODE>.
Hem de tenir instal·lats el Servidor Apache v2, els mòduls php5 (o php4) i auth-pam</P>
<P>Editem el fitxer <CODE>/etc/apache2/httpd.conf</CODE></P>
<PRE><Directory "/var/www/libretto/">
AllowOverride AuthConfig
AuthBasicProvider file
AuthUserFile /etc/shadow
AuthPAM_Enabled on
AuthName "Libretto Web Download Manager"
AuthType Basic
require valid-user
</Directory></PRE>
<H2>Automatitzar les feines de descàrrega</H2>
<P>En un procés batch podem afegir feines per <CODE>Libretto</CODE> seguint aquestes instruccions.<br>
Per exemple per iniciar la descàrrega del fitxer <CODE>Jigsaw Download</CODE> que es troba en
<CODE>http://inter.net/file.jigdo</CODE>.<br>
Soposem que el nostre servidor es troba protegit per usuari i paraula de pas <CODE>myuser:mypass</CODE>;
enviarem al nostre Servidor Web la <CODE>URL</CODE> amb el codi que segueix:
</P>
<PRE>http://myuser:hide@address.com/libretto/index.php?batch=true&url=http://inter.net/file.jigdo
</PRE>
<P>Els paràmetres disponibles son:
</P>
<P>
<UL>
<LI><B>url</B> és la <CODE>URL</CODE> d'un fitxer de Internet o la
<CODE>direcció absoluta</CODE>
d'un fitxer que es troba en el disc del nostre servidor Web. Es l'únic paràmetre requerit;
els altres son opcionals.
<LI><B>downloadtype</B> és el tipus de fitxer a descarregar.<br>
Si escrivim <CODE>auto</CODE> o no el posem, <CODE>Libretto</CODE> deduïrà aquest valor;
els valors possibles 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> Quan <CODE>Libretto</CODE> descarrega els fitxers d'un directori podem triar
l'extensió descarregada. Ex: <CODE>.jpg</CODE><br>
Veure <CODE>man wget</CODE> per més informació.
<LI><B>httpuser</B> és el nom d'usuari per accedir a un fitxer que es troba en una URL protegida.
<LI><B>httppasswd</B> és la paraula de pas per accedir a un fitxer
que es troba en una URL protegida.
<LI><B>urltype</B> és el tipus de la ubicació on es troba el fitxer.<br>
Si escrivim <CODE>auto</CODE> o no el posem, <CODE>Libretto</CODE> deduïrà aquest valor;
els valors possibles son:
<UL>
<LI><b>auto</b> (default)
<LI><b>url</b>
<LI><b>fileserver</b>
<LI><b>filelocal</b> (només es pot fer servir en Interactiu)
</UL>
<LI><B>subdircheck</B> és un indicador de que <CODE>Libretto</CODE> ha de generar un nom
per el subdirectori de descàrrega.
<UL>
<LI><b>true</b> (default)
<LI><b>false</b>
</UL>
<LI><B>subdirname</B> és el nom que nosaltres volem per el subdirectori de descàrrega.
</UL>
</P>
<P>Per exemple, iniciarem la descàrrega següent amb el protocol <CODE>Bittorrent</CODE>,
amb un fitxer de descripcció
que es troba en la <CODE>URL</CODE> de Internet <CODE>http://inter.net/path/file.torrent</CODE>;
y guardarem els fitxers en el subdirectori <CODE>mytorrents</CODE>
</P>
<PRE>http://myuser:hide@address.com/libretto/index.php?batch=true&url=http://inter.net/path/file.torrent&subdirname=mytorrents
</PRE>