Ceci est une ancienne révision du document !
HellaNZB + Zussaweb
I. Introduction
J'ai décidé, pour ceux qui n'ont jamais installé hellanzb sur leur machine de faire un petit tuto en Français.
Vous allez me dire : « Mais c'est quoi Hellanzb ? A quoi çà sert ? »
Hellanzb est un petit programme (sous linux bien entendu) qui permet de télécharger sur les serveurs Usenet binaires, plus connus sous le nom de Newsgroup. A partir d'un fichier NZB, que vous aurez au préalable téléchargé sur un site de référencement, il vous permettra d'importer le contenu de ce dernier pour le télécharger.
Mais ce n'est pas tout : Hellanzb ne fait pas que télécharger les fichiers, il les répare (si nécessaire) et les extrait pour vous. Vous n'avez rien à faire, hormis le graver. (ben oui, vous voulez pas non plus qu'il le regarde pour vous!!)
Bon, après cette brève introduction, passons aux choses sérieuses : l'Installation.
II. Installation
Pour Feisty Fawn et versions supérieures
Maintenant Hellanzb se trouve dans les dépôts, donc vous pouvez faire :
sudo apt-get install hellanzb
Pour les versions antérieures à Feisty Fawn
Il existe des paquets .deb pour Ubuntu à cette adresse :
http://mirror.linux.org.mt/mirror/ubuntu/pool/universe/h/hellanzb/
III. Configuration
Éditer le fichier :
sudo gedit /etc/hellanzb.conf
à moins que le fichier se trouve là :
sudo cp /usr/etc/hellanzb.conf.sample /usr/etc/hellanzb.conf sudo gedit /usr/etc/hellanzb.conf
- Aller à cette ligne pour modifier le prefix_dir :
# Important locations Hellanzb.PREFIX_DIR = os.path.expanduser('~') + '/.hellanzb/'
Cette ligne veut dire que le dossier utilisé par hellanzb sera : /home/votre_identifiant_ubuntu/.hellanzb
Remplacez /.hellanzb/ par le chemin vers lequel vous voulez que hellanzb copie ses dossiers.
1. Chez un fournisseur payant de newsgroups :
Il vous faut vous procurer vos identifiants de connexion que vous avez reçu par votre fournisseur de newsgroups :
- Aller à la ligne : defineServer. On trouve ceci :
(id = 'votre_identifiant', hosts = [ 'votre_nom_de_serveur:119' ], #hosts = [ 'votre_nom_de_serveur', 'morenews.changeme.com:8000' ],
username = 'votre_identifiant', password = 'votre_mot_de_passe', #username = None, # no auth #password = None,
2. Chez le FAI FREE :
(id = 'votre_identifiant', hosts = [ 'news.free.fr:119' ], #hosts = [ 'votre_nom_de_serveur', 'morenews.changeme.com:8000' ],
#username = 'votre_identifiant', #password = 'votre_mot_de_passe', username = None, # no auth password = None,
Par défaut, Hellanzb répare automatiquement les fichiers .rar gràce aux fichiers .par2. Mais si vous souhaitez qu'il vous décompresse automatiquement les fichiers .rar il faudra encore configurer le fichier hellanzb.conf comme ceci :
# Supply a path to the (un)rar command Hellanzb.UNRAR_CMD = '/usr/bin/unrar' # Supply a path to the par2 command Hellanzb.PAR2_CMD = '/usr/bin/par2' # Skip unraring during post processing #Hellanzb.SKIP_UNRAR = True
Vous pouvez maintenant exécuter le programme :
hellanzb
ou
hellanzb -D
pour le lancer en tant que daemon.
IV. Utilisation
Télécharger un fichier NZB, et le plaçer ici :
/home/votre_identifiant_ubuntu/dossier_hellanzb/nzb/daemon.queue/
- Si vous voulez utilisez une interface web (hellahella ou zussaweb) pour gérer vos téléchargements, il se peut que vous n'ayez pas les droits pour copier un fichier dans ce dossier, alors faites un :
sudo chmod 775 /home/votre_identifiant_ubuntu/dossier_hellanzb/nzb/daemon.queue
et un:
sudo chown votre_identifiant_ubuntu:www-data /home/votre_identifiant_ubuntu/dossier_hellanzb/nzb/daemon.queue
Une fois vos fichiers téléchargés et réparés, ils seront extrait ici :
/home/votre_identifiant_ubuntu/dossier_hellanzb/done/
Il ne vous reste plus qu'à graver le tout avec votre logiciel de gravure préféré.
V. Compléments
Si vous désirez que Hellanzb se lance automatiquement en démon au démarrage de votre machine, il va falloir créer un fichier "hellanzb" dans /etc/init.d/ avec les droits 755.
Voici ce que doit contenir ce fichier :
#!/bin/bash case "$1" in start) su -c 'hellanzb -D' votre_identifiant_ubuntu ;; stop) su -c 'hellanzb shutdown' votre_identifiant_ubuntu ;; status) su -c 'hellanzb status' votre_identifiant_ubuntu ;; esac
ensuite dans un terminal tapez :
sudo update-rc.d hellanzb defaults 99
et voilà, le service Hellanzb se lancera en démon au démarrage de votre machine !
Vous pouvez donc par la suite démarrer, arrêter ou vérifier le status de votre service Hellanzb avec les commandes :
sudo /etc/init.d/hellanzb start ou sudo /etc/init.d/hellanzb stop ou sudo /etc/init.d/hellanzb status
Si jamais vous voulez enlever Hellanzb du démarrage de votre machine, il suffit de taper la commande suivante :
sudo update-rc.d -f hellanzb remove
Le script sera toujours présent dans /etc/init.d/ mais ne sera plus exécuté au redémarrage. Pour le réactiver il faudra refaire la commande sudo update-rc.d hellanzb defaults 99
Les interfaces web
A quoi cela sert-il ?
Zussaweb et Hellahella sont des interfaces web pour Hellanzb. En effet, il peut apparaître fastidieux d'aller à chaque fois déposer les fichiers .nzb dans votre dossier nzb/daemon.queue/
Zussaweb et Hellahella sont là pour vous simplifier la vie et donner en prime un aspect un peu moins austère à Hellanzb.
Le point fort de ces interfaces web est de vous permettre de lancer un fichier .nzb de n'importe où dans le monde simplement avec un navigateur web.
Configuration requise
Il faut bien entendu avoir déjà Apache et PHP installé sur sa machine. http://doc.ubuntu-fr.org/lamp
Zussaweb
Pour télécharger Zussaweb : http://sourceforge.net/projects/zussaweb
Ensuite il faudra juste modifier dans le fichier settings.php de Zussaweb:
$disk = '/home/votre_identifiant_ubuntu/dossier_hellanzb'; $download_nzb_path = '/home/votre_identifiant_ubuntu/dossier_hellanzb/nzb/daemon.queue';
1 - A la ligne 4 remplacez la variable $disk par ce que vous avez écrit plus haut
2 - A la ligne 77 remplacez : "/" par de simples guillemets : '/'
Pour la mise en place de l'interface, je pars du principe que si vous utilisez Apache vous saurez mettre en place Zussaweb.
Autre méthode d'automatisation
Une autre méthode, plus simple à envisager, est la création d'un alias. Par exemple:
alias nzb='cd ~/Desktop/ && mv ./*.nzb /chemin_vers_hellanzb/nzb/daemon.queue && hellanzb'
Au redémarrage du bash, et à condition que le fichier nzb soit sur votre bureau, tout devrait se faire tout seul.
Site officiel : www.hellanzb.com/trac/
Tuto réalisé par Dedel, Ezteban, Placisfos.
Une interface graphique
LottaNZB peut fonctionner comme une interface graphique pour HellaNZB