# Démarrer avec Torrent Search

## Installation

La manière d'installer &app; dépend de votre système d'exploitation :

Sous Debian/Ubuntu

- Téléchargez le paquet debian (.deb) et double-cliquez sur le fichier téléchargé : le gestionnaire de paquets va être lancé et l'installation commencera lorsque vous cliquerez sur Installer ce paquet.

  Vous pouvez aussi utiliser la ligne de commande : `gdebi `/chemin/vers/le/fichier``.

Autres distributions Linux

- Téléchargez l'archive source (.tar.gz) et extrayez son contenu. Puis, depuis la ligne de commande, saisissez les commandes suivantes :

  `cd `/chemin/vers/les/fichiers/extraits``

  `python `setup.py` install`

## Lancer l'application

### Démarrage rapide

Vous pouvez lancer &app; des manières suivantes:

Menu Applications

- Choisissez Internet Torrent Search

Ligne de commande

- Tapez `torrent-search`, puis Entrée.

### Arguments de la ligne de commande

Vous trouverez ici la description des arguments qui peuvent être utilisés en lançant &app; par la ligne de commande.

#### Options basiques

-h, --help

- Afficher le message d'aide et quitter

-v, --version

- Afficher le numéro de version et quitter

-s, --search

- Lancer une recherche au démarrage

--no-plugins-check

- Ne pas chercher les mises à jour de plugins au démarrage

#### Options avancées

Ces options ne devarient être utilisées que par des développeurs.

--share-dir

- Spécifier le chemin vers le répertoire `share`

--add-plugin

- Charger un plugin à partir d'un répertoire spécifique

## La fenêtre principale

### Fenêtre de Torrent Search

### Menu principal

#### Menu Fichier

Quitter

- Quitte l'application

#### Menu Édition

Préférences

- Montre le dialogue de préférences

#### Menu Aide

Aide

- Affiche cette documentation

À propos

- Affiche le dialogue "À propos"

### Barre de recherche

Pour commencer à chercher des torrents, tappez simplement votre recherche dans la fenêtre de saisie de la barre de recherche et appuyez sur Entrée ou cliquez sur Rechercher. Les résultats de votre recherche apparaîtrons dans la liste de résultats.

### Options de recherche

Pour modifier les options de recherche, cliquez sur l'expanseur Options de recherche en-dessous de la barre de recherche. Vous verrez la boîte suivante apparaître:

#### Boîte d'options de recherche

Vous pouvez mettre en place un certains nombre de filtres pour ne voir apparaître que les résultats qui vous intéressent. Vous n'avez pas besoin de recommencer la recherche puisque les filtres sont appliqués immédiatement.

Certains plugins peuvent ne pas gérer le filtre Filtrer les doublons.

### Liste des résultats

Quand vous lancez une recherche, les torrents correspondant à vos critères apparaîtrons dans la liste de résultats. Le nombre de résultats indiqué dans le titre de la boîte de résultats est le nombre total de résultats : si vous avez sélectionné des filtres dans les Options de recherche, vous ne verrez pas apparaître autant d'éléments qu'indiqué dans le titre.

Pour télécharger un fichier torrent, double-cliquez sur la ligne correspondante ou faites un clic droit sur la ligne et sélectionnez Télécharger dans le menu. La progression du téléchargement apparaîtra dans la barre latérale de téléchargements.

### Barre latérale de téléchargements

La liste des téléchargements indiquera la progression des différents téléchargements que vous avez demandés. Lorsqu'un téléchargement se termine, la ligne correspondante est supprimée de la liste.

Les téléchargements actifs apparaîssent avec un fond vert, ceux qui ont échoué avec un font rouge.

Tant qu'un téléchargement est en attente, vous pouvez l'annuler en sélectionnant Annuler dans le menu accessible par le clic droit de la souris. Une fois qu'il a commencé, un téléchargement ne peut plus être annulé.

Lorsque le téléchargement d'un fichier échoue, vous pouvez choisir de réessayer ou d'annuler en faisant un clic droit sur la ligne.