# &app; Manuel (&manrevision;)

2008
Sander Tuit
Équipe de développement LottaNZB

            avirulence@lottanzb.org

&legal;

Sander
Tuit
Équipe de développement LottaNZB

                avirulence@lottanzb.org

Manuel d'utilisateur de LottaNZB V&manrevision;
&date;

Sander Tuit avirulence@lottanzb.org

Équipe de développement LottaNZB

Ce manuel décrit la version &appversion; de LottaNZB.

## Retour d'expérience

Pour rapporter un bogue ou émettre une suggestion à propos de &app; ou de ce manuel, suivez les instructions sur la page Launchpad de suivi des bogues.

## Introduction

&app; est une application pour le bureau GNOME qui permet le téléchargement de nouvelles binaires sur Usenet.

Le Usenet est un réseau dédié à la discussion mondialement étendu, présent bien avant les premiers sites Internet. Au delà des normaux messages textuels, l'utilisateur peut aussi poster des fichiers, souvent découpé en plusieurs messages. Pour simplifier le téléchargement de ces messages, le format de fichier NZB fut développé par les créateurs de l'Index Usenet de Newzbin.com. Ces fichiers contiennent l'information concernant ce qui doit être précisément téléchargé et sont généralement crées par les moteurs de recherche d'Usenet comme celui mentionné ici.

&app; utilise HellaNZB comme processus d'arrière plan pour procéder au traitement des fichiers NZB et au téléchargement des fichiers auxquels ils renvoient, et finalement valider et extraire ces téléchargements si nécessaire. Mais &app; peut faire encore plus et vous permet:

- De l'utiliser comme un client autonome NZB Usenet ou comme une plate-forme pour un client HellaNZN lancé sur votre ordinateur.

- D'ajouter plusieurs fichiers NZB directement depuis votre gestionnaire de fichiers et votre navigateur Internet immédiatement

- D'arranger la file de téléchargement et d'ajouter des fichiers NZB en utilisant le glissé-déposé

- Définir plusieurs serveurs Usenet

- De limiter la bande passante utilisée pour le téléchargement

- De configurer facilement HellaNZB et &app; sans avoir à éditer manuellement les fichiers de configuration

Grâce au travail des utilisateurs de &app; de différents pays, &app; est disponible en Danois, Néerlandais, Français, Allemand et Espagnol.

## Démarrage

### Comment démarrer &app;

Vous pouvez démarrez &app; de différentes façons:

Menu Applications

  Choisissez Internet Client Usenet Automatisé LottaNZB.

Ligne de commande

  Pour démarrer &app; depuis la ligne de commande, tapez la commande suivante, puis appuyez sur Entrée:

  `lottanzb`

### Premier démarrage de &app;

Quand vous démarrer &app; la première fois, vous devez le configurer. Il vous sera demandé de sélectionner le mode d'utilisation qui vous convient le mieux.

&app; essaye de déterminer quel est le mode approprié pour vous et affiche une information au bas de la fenêtre pour vous aider à décider. &app; a trois modes d'utilisation, décrits ci dessous.

#### Mode autonome

Si vous ne voulez pas qu'un démon HellaNZB soit lancé en arrière plan tout le temps, ou si vous ne voulez pas définir les paramètres du démon vous même, c'est probablement le mode le mieux adapté pour vous. Quand &app; démarre, le démon HellaNZB est automatiquement lancé, puis automatiquement arrêté lorsque &app; s'arrête. Si vous n'avez aucune idée de ce qu'est le démon HellaNZB, ce sera aussi le meilleur choix pour vous.

SI vous voulez utiliser le mode autonome, vous devrez remplir l'adresse et le port fournis par votre serveur Usenet. Notez que le port par défaut est 119. Quand le serveur nécessite une authentification, vous aurez à remplir votre nom d'utilisateur et mot de passe. En bas de la fenêtre de sélection du mode d'usage, vous pouvez renseigner l'emplacement du démon HellaNZB. Cependant, il devrait être détecté automatiquement.

Cette information est nécessaire pour démarrer immédiatement le téléchargement. Premièrement, cette fenêtre est seulement destiné à être utilisée au premier démarrage de &app;. Plus tard, vous pouvez éditer ces paramètres dans la fenêtre de préférences, ou vous pouvez même ajouter plusieurs serveurs, activer l'encryption SSL, etc.

##### Dialogue de la sélection du mode d'usage

Montre le dialogue qui permet de définir le mode autonome.

#### Plate-forme locale

Si vous avez déjà configuré le démon HellaNZB et souhaitez l'avoir lancé tout le temps en arrière plan, vous devriez sélectionner le mode plate-forme locale.

Si vous voulez utiliser le mode plate-forme locale, vous devez juste sélectionner le fichier de configuration qu'utilise HellaNZB. Il se nomme hellanzb.conf, et se trouve habituellement dans /etc, /usr/etc ou ~/.hellanzb.

Vous ne pourrez pas changez les paramètres de HellaNZB dans &app; si vous choisissez ce mode.

##### Dialogue de sélection du mode d'usage pour plate-forme locale

Montre le dialogue qui permet de définir le mode plate-forme locale.

#### Mode plate-forme à distance

Si vous voulez vous connecter à un démon HellaNZB lancé sur un autre ordinateur, vous devriez sélectionner ce mode. Il ne sera pas possible de changer les paramètres ou d'ajouter des fichiers NZB dans ce mode, mais vous pouvez surveiller l'avancement de vos téléchargements.

Si vous voulez utiliser le mode plate-forme à distance, vous devriez remplir l'adresse IP et le port de l'ordinateur sur lequel est lancé le démon HellaNZB et le mot de passe XML RPC pour le démon HellaNZB.

##### Dialogue de sélection du mode d'usage pour plate-forme à distance

Montre le dialogue qui permet de définir le mode plate-forme à distance.

### Fenêtre principale

Quand &app; a été configuré correctement, la fenêtre principale de &app; est affichée.

#### Fenêtre principale

Montre la fenêtre principale de &app;. Contient la barre de titre, de menu, d'outils, l'espace de téléchargement et la barre d'informations. La barre de menu contient les menus Fichier, Édition et Aide.

La fenêtre de &app; contient les éléments suivants:

Barre de menu.

  Les menus contenus dans la barre de menu contiennent des commandes qui peuvent être utilisés pour travailler avec &app;.

Barre d'outils.

  La barre d'outils contient des commandes qui peuvent se révéler utiles.

Barre d'informations.

  La barre d'informations affiche des informations à propos des items en court de téléchargement.

Espace de téléchargement.

  L'espace de téléchargement montre les items en cours de téléchargement, en cours de traitement, qui sont dans la file d'attente ou terminés.

## Utilisation

Vous pouvez utilisez &app; pour effectuer les tâches décrites dans les sections suivantes:

### Télécharger un item

Il y a plusieurs façons d'ajouter un item à la file de téléchargement:

#### Depuis votre gestionnaire de fichiers et votre navigateur Internet

Quand vous installez &app;, il est enregistré comme une application pour traiter les fichiers NZB. Ceci vous permet d'ajouter des fichiers NZB en cliquant simplement dessus dans votre gestionnaire de fichiers. Quand vous téléchargez un fichier NZB, votre navigateur Internet devrez vous permettre de le transmettre directement à &app;

Vous pouvez même sélectionner plusieurs fichiers NZB dans votre gestionnaire de fichiers et les ajouter d'un coup.

#### En utilisant le menu Fichier

Premièrement, choisissez Fichier Ajouter des fichiers NZB. La boîte de dialogue d' Ajouter des fichiers NZB (voir capture d'écran ci dessous) est affichée. Sélectionnez le fichier que vous voulez ajouter (il est possible d'en sélectionner plusieurs), puis éditez le nom et la catégorie en bas de la fenêtre et cliquez sur Ajouter.

##### Boîte de dialogue d'ajout de fichiers

Affiche le Ajout de fichiers menu.

#### En utilisant le bouton Ajouter de la barre d'outils

La troisième façon d'ajouter des fichiers NZB à la file et d'utiliser le bouton Ajouter dans la barre d'outils. Ce bouton ouvre la même boîte de dialogue d' Ajouter des fichiers décrite ci dessus.

#### En utilisant le glissé-déposé

Une autre façon d'ajouter des fichiers NZB à la file d'attente et de les glisser depuis le gestionnaire de fichiers ou du bureau dans la file de téléchargement. La boîte de dialogue d'Ajouter des fichiers NZB sera ouverte avec le fichier glissé sélectionné. Il est aussi possible de glisser-déposer plusieurs fichiers d'un coup dans la file de téléchargement. Les fichiers seront automatiquement ajouté à la file.

#### En utilisant Newzbin.com

La dernière façon d'ajouter des fichiers NZB est seulement accessible quand un compte Newzbin.com a été configuré dans la fenêtre des Préférences. Si un compte Newzbin.com a été configuré, il est possible d'ajouter un téléchargement à la file en entrant l'ID Newzbin.com. Pour cela, utilisez Fichier Ajouter des fichiers depuis Newzbin.com. Maintenant, le dialogue Ajouter un fichier. Renseignez l'ID Newzbin.com, cliquez sur Ajouter et le téléchargement démarrera automatiquement.

Après avoir cliqué sur Ajouter, il peut s'écouler quelques secondes avant que le téléchargement n'apparaisse dans la file de téléchargement. Ceci est dû au fichier NZB que &app; doit d'abord télécharger depuis Newzbin.com. Entraînez votre patience.

##### Ajouter un téléchargement depuis Newzbin.com

Montre la boîte de dialogue Ajouter un téléchargement.

### Visualisez l'avancement du téléchargement

Quand &app; est lancé et que vous avez ajouté des fichiers à la file de téléchargement, les fichiers sont affichés dans l'espace de téléchargement. Dans l'espace de téléchargement, vous trouvez quatre colonnes:

- Nom: Cette colonne affiche le nom du fichier.

- Catégorie: Cette colonne affiche à quelle catégorie appartient l'item. Quand l'item est téléchargé et procédé, il sera affiché dans le répertoire de téléchargement avec la catégorie préfixée à son nom. Si le fichier a été ajouté par glissé-déposé, il apparaîtra dans la catégorie "Autre".

- Taille: Cette colonne montre la taille de l'item.

- Progression: Cette colonne affiche la progression d'un fichier dans la file. Il y a cinq états possibles pour un item:

  - Téléchargement: Quand un item est en cours de téléchargement, le pourcentage téléchargé est affiché dans cette colonne. Sur la capture d'écran ci dessous, vous pouvez voir un item en cours de téléchargement.

    #### Téléchargement

    Montre un fichier en train d'être téléchargé.

  - En attente: Quand un item est mis en attente, il attend que le téléchargement courant soit terminé ainsi que celui des items au dessus de lui. En cliquant sur Déplacer vers le haut/bas, vous pouvez changer l'ordre de la file. Vous pouvez aussi glisser-déposer les items dans l'ordre voulu. Dans la capture d'écran ci dessus, vous pouvez voir deux téléchargements en attente.

  - Traitement: Quand un item est terminé, son intégrité est vérifiée et une fois complet, il est extrait et déplacé dans le répertoire de téléchargement. Sur la capture d'écran ci dessous, vous pouvez voir un item en cours de traitement.

    #### Traitement

    Montre un fichier en cours de traitement.

  - Réparation: Quand un item est réparé, cela signifie qu'il y a des problèmes d'intégrité dans le téléchargement. Notez que la réparation peut prendre du temps.

  - Terminé: Quand un item est terminé, il peut être enlever depuis l'espace de téléchargement en cliquand sur le bouton Effacer terminés.

### Ré-arranger la file de téléchargement

Il y a des situations dans lesquelles vous voulez obtenir certains items plus tôt que d'autres. Il y a deux façon d'accomplir ça:

- The first way to rearrange queued items is to use the Move up and Move down buttons. First, select the item you want to move up or down and then click the corresponding button in the toolbar.

- La seconde façon de réarranger les items et le glissé-déposé. Sélectionnez d'abord l'item que vous voulez déplacer, puis glissez le dans la position de la file désirée. La capture d'écran ci dessous montre un item (Ubuntu 7.10 DVD) déplacé dans une position plus basse dans la file de téléchargement.

  #### Ré-arrangement par glissé-déposé

  Montre le déplacement d'un item de la file.

## Paramètrage

Pour configurer &app;, choisissez Édition Préférences. La boîte de dialogue Préférences contient, regroupées en onglets, les sections suivantes:

### Paramètres généraux

Ci dessous vous pouvez voir une capture d'écran de l'onglet Paramètres généraux.

#### Onglet paramètres généraux

Onglet paramètres généraux.

Paramètres de téléchargement

  - Répertoire de téléchargement

    Quand les items sont terminés et traités, ils sont déplacés dans ce répertoire. Assurez vous qu'il y a assez d'espace libre dans la destination sélectionnée. Pour changer la destination du répertoire de téléchargement, cliquez sur le bouton du répertoire et sélectionnez une des destinations dans la liste, ou choisissez Autre....

  - Vitesse maximale de téléchargement

    Certaines personnes désirent garder de la bande passante pour vérifier leur e-mails ou naviguer sur des sites Internet. Quand vous n'avez pas assez de bande passante disponible, vous pouvez limitez celle de HellaNZB.

    Le démon HellaNZB ne limite pas vraiment la vitesse de téléchargement, mais ajuste sa vitesse en arrêtant de télécharger pendant quelques secondes, pour moyenner sa vitesse sur la valeur que vous avez entrée ici.

  - Ne télécharger les fichiers PAR que si nécessaire

    Quand les items téléchargés sont abîmés, ils peuvent être réparés en utilisant des fichiers PAR si disponibles. Si cette option est activée, &app; ne télécharge les fichiers PAR que si l'item est abîmé. Cela peut grandement diminuer la taille des fichiers à télécharger.

Autres paramètres

  - Démarrer dans la barre de tâches

    Quand cette option est activée, &app; n'affichera pas la fenêtre principale au démarrage, mais seulement l'icône dans la barre des tâches. En faisant un clique droit sur cette icône, puis en cliquant Montrer la fenêtre principale, vous pouvez afficher la fenêtre principale. Cette option devient pratique lorsque vous désirez lancer &app; à chaque session et ne pas avoir la fenêtre principale affichée à chaque connexion.

  - Utiliser les notifications libnotify

    Quand cette option est sélectionnée, les notifications libnotify, qui se fondent dans votre bureau Gnome, sont affichées par exemple lorsque vous terminez un téléchargement.

### Paramètres du serveur

Vous pouvez trouvez ci dessous une capture d'écran de l'onglet des paramètres du serveur.

#### Onglet des paramètres du serveur

Onglet des paramètres du serveur

Comme le montre la capture d'écran ci dessus, il y a trois boutons utilisables:

- Édition des paramètres du serveur sélectionnée

- Suppression du serveur sélectionné

#### Ajout d'un nouveau serveur Usenet

Quand vous cliquez sur le bouton Ajouter dans l'onglet des paramètres du serveur, on obtient la boîte de dialogue d'Ajouter un serveur comme le montre la capture d'écran ci dessous. Cette fenêtre est la même que celle de la boîte de dialogue d'Édition du serveur.

##### Boite de dialogue d'ajout/édition de serveur

Boite de dialogue d'ajout/édition de serveur.

Général

  Il y a besoin des options suivantes quand on ajoute un nouveau serveur Usenet:

  - Nom du serveur

    Contient le nom du serveur actuel. Ce nom n'est pas très important. Il fournit juste un label pour la liste des serveurs. Cependant, notez qu'il doit être unique.

  - Adresse

    L'adresse du serveur Usenet. Notez que vous pouvez ne pas inclure le numéro du port.

  - Port

    Le port du serveur Usenet. Le port par défaut pour la majorité des serveurs est le 119.

Authentification

  - Le serveur nécessite une authentification

    Activez cette option lorsque votre serveur Usenet nécessite une authentification.

  - Nom d'utilisateur

    Si votre serveur Usenet nécessite une authentification, vous devriez remplir par le nom d'utilisateur qui vous a été fourni.

  - Mot de passe

    Si votre serveur Usenet nécessite une authentification, vous devriez remplir par le mot de passe qui vous a été fourni.

Paramètres de connexion

  - Activer l'encryptage SSL

    Activez cette option si votre serveur Usenet fournit un encryptage SSL. La plupart des serveurs Usenet le propose en tant que service premium. Si le téléchargement depuis ce serveur ne fonctionne pas, essayez de désactiver cette option, auquel cas votre serveur ne supporte pas à priori l'encryptage SSL.

  - Nombre maximum de connexions

    La plupart des serveurs Usenet ont une limite de connexions utilisables par leurs clients. Vous devriez remplir ici le nombre maximum de connexions qui vous sont permises.

    Si vous avez une connexion Internet lente, vous devriez baisser le nombre de connexions d'autant plus que vous obtiendrez une vitesse de téléchargement optimale.

### Paramètres Newzbin

Le site Newzbin.com offre des fichiers NZB classés qui peuvent être utilisé dans &app;. &app; permet maintenant d'ajouter un téléchargement en entrant simplement l'ID que Newzbin.com fournit.

Newzbin.com a un système d'enregistrement fermé pour le moment, ce qui signifie que vous devez connaître quelqu'un possédant déjà un compte pour pouvoir utiliser ce service. Ensuite, il est important que vous sachiez que vous avez besoin de crédits Premium afin d'utiliser Newzbin.com.

Si vous cherchez une source gratuite de fichiers NZB, allez voir sur binsearch.info. Ce site permet de rechercher et de créer des fichiers NZB.

#### Paramètres Newzbin.com

Paramètres Newzbin.com

Authentification

  Quand vous activez le support Newzbin.com, vous devez remplir les paramètres suivants:

  - Nom d'utilisateur

    Le nom d'utilisateur Newzbin.com qui vous a été fourni.

  - Mot de passe

    Le mot de passe Newzbin.com qui vous a été fourni.

## À propos de &app;

Les premières versions de &app; furent écrites par Sander (aVirulence). Début 2008, Severin (Lantash) rejoint l'équipe de développement, modifiant la majorité du code pour faire de &app; la superbe application qu'elle est devenue. Peu après, Stéphane rejoint aussi l'équipe en tant que testeur et traducteur de &app;. Après le lancement de &app; 0.2, Andrew rejoint l'équipe, fixe des bugs et implémente de nouvelles fonctions. Pour en savoir plus à propos de &app;, rendez vous sur le site de &app;.

Pour rapporter un bogue ou faire une suggestion concernant cette application ou ce manuel, rendez vous sur la page Launchpad de &app;.

Ce programme est distribué sous les termes de la licence GNU General Public telle que publiée par la Free Software Foundation; version 3 de la Licence. Une copie de la licence peut être trouvée sur ce lien, ou dans le fichier LICENSE inclus dans le code source du programme.