{{tag>p2p}}

----

====== qBittorrent ======

{{http://www.qbittorrent.org/img/qb_newbanner.png}}

qBittorrent est un client [[p2p|bittorrent]] très léger développé en C++ avec la bibliothèque Qt4.

Ses principales fonctionnalités résident dans son [[#moteur_de_recherche_integre|moteur de recherche intégré]] (Permettant de faire des recherches sur plusieurs annuaires de torrent simultanément), le téléchargement séquentiel, la gestion de l'UPnP et du NAT-PMP, le brouillage de protocole (Compatible Azureus), l'échange de sources (Compatible avec µTorrent), le filtrage d'adresses IP (Compatible avec "ipfilter.dat" de type eMule et filtres PeerGuardian), la gestion des priorités des torrents ainsi que des fichiers qu'ils contiennent, le contrôle à distance via une interface Web sécurisée. 

===== Installation =====

==== Via les dépôts officiels===
=== Méthode graphique ===
Pour installer ce logiciel, il suffit d'[[:tutoriel:comment_installer_un_paquet|installer le paquet]] **[[apt>qbittorrent|qbittorrent]]**.

=== Méthode en ligne de commande ===
Ouvrez un [[:terminal]] et entrez la commande suivante:<code>sudo apt-get install qbittorrent </code>

==== Via un PPA ===

Ce dépôt PPA maintenu par les développeurs de qbittorrent permet d'obtenir une version stable relativement récente par rapport à celle des dépôts.

=== Méthode graphique ===

Si vous souhaitez la version stable (recommandée) :
  * [[ppa|ajoutez à vos sources de logiciels le PPA]] **ppa:qbittorrent-team/qbittorrent-stable**((https://launchpad.net/~qbittorrent-team/+archive/ubuntu/qbittorrent-stable))
  * [[:tutoriel:comment_modifier_sources_maj#recharger_la_liste_des_paquets|rechargez la liste des paquets]]
  * [[:tutoriel:comment_installer_un_paquet|installez le paquet]] **[[apt>qbittorrent|qbittorrent]]**. 

Pour la version de développement : 
  * [[ppa|ajoutez à vos sources de logiciels le PPA]] **ppa:qbittorrent-team/qbittorrent-unstable**((https://launchpad.net/~qbittorrent-team/+archive/ubuntu/qbittorrent-unstable))
  * [[:tutoriel:comment_modifier_sources_maj#recharger_la_liste_des_paquets|rechargez la liste des paquets]]
  * [[:tutoriel:comment_installer_un_paquet|installez le paquet]] **[[apt>qbittorrent|qbittorrent]]**.

=== Méthode en ligne de commande ===
Ouvrez un [[:terminal]] et entrez les commandes suivantes

Pour la version stable (recommandée):
<code>sudo add-apt-repository ppa:qbittorrent-team/qbittorrent-stable</code>

Pour la version développement :
<code>sudo add-apt-repository ppa:qbittorrent-team/qbittorrent-unstable</code>

Puis dans les 2 cas : 
<code>sudo apt-get update && sudo apt-get install qbittorrent</code>
===== Configuration du pare-feu =====
Ouvrez qBittorrent et Allez dans //Options/Préférences/Connexion// pour voir quels ports sont utilisés. Par défaut, le programme utilise le port **6881/TCP** pour Bittorrent et le port **6881/UDP** pour le DHT. (Apparemment 8999 aujourd'hui). Veuillez reporter ces informations dans les politiques du [[:pare-feu]]. \\
Ubuntu possède un puissant pare-feu nommé “netfilter” désactivé par défaut et qu'il est possible de configurer avec des outils en ligne de commande tels que “[[:iptables]]” ou [[:ufw|Uncomplicated FireWall (ufw)]] ou encore avec l'interface graphique simple, pratique et intuitive de ce dernier:[[:Gufw]].

==== Autoriser le service ====

  * Lancer [[:Gufw]]
  * Activer le pare-feu
  * Cliquez sur "Ajouter"
  * Dans l'onglet Pré-configurée" : "Allow - Entrée - Programme - qBittorrent"
  * Valider en cliquant sur "Ajouter"
  * Quitter Gufw
Plus d'informations sur Gufw [[gufw|ici]]. 

===== Moteur de recherche intégré =====

qBittorrent possède un **moteur de recherche intégré** très pratique d'utilisation. Il permet de **rechercher** des torrents sur différents //trackers//, y compris des //trackers// privés (pour lesquels vous possédez un couple d'identifiant/mot de passe), de **télécharger** les torrents désirés directement dans qBittorrent, et de **visiter** leurs pages de présentation (dans Firefox).

Des [[http://sourceforge.net/apps/mediawiki/qbittorrent/index.php?title=List_of_unofficial_search_engine_plugins|plugins]] vous permettent d'étendre cette liste de //trackers//.

==== Installation des plugins francophones ====

Des plugins pour des sites francophones sont développés et maintenus à jour sur [[https://github.com/davy39/qbfrench|ce dépôt github]].
Les sites suivants sont supportés : Cpasbien, TorrentFrançais, Omgtorrent, Smartorrent et T411
 Le développeur met un disposition un script d'installation / configuration automatique pour les utilisateurs d'Ubuntu.

-  Télécharger le script et le lancer avec votre utilisateur courant (attention, pas en root !):
<code bash>wget https://github.com/davy39/qbfrench/raw/master/qbfrench-install.sh
bash qbfrench-install.sh</code>
- Suivre pas à pas les étapes d'installation, et redémarrer qBittorrent si ce dernier était en marche.

==== Installation d'autres plugins ====

Téléchargez un plugin sur le [[http://plugins.qbittorrent.org|Wiki de qBittorrent]].

=== Si le plugin concerne un tracker privé ===

   - Ouvrez le script (.py) dans un éditeur de textes (par exemple **gedit**).
   - Renseignez les champs //username// et //password//.
   - Enregistrez le script **sans modifier son nom**. 

=== Dans tous les cas ===

   - Ouvrez qBittorrent (menu Applications / Internet) et cliquez sur l'onglet Recherche.
   - Ensuite cliquez sur le bouton "Moteurs de recherche..." situé en bas à droite de l'onglet.
   - Choisissez "Installer un nouveau", puis "Fichier local" et sélectionnez le script (.py) désiré.

=== Icône du tracker ===

Normalement, qBittorent ira chercher automatiquement les icones des //trackers// sur internet pour l'afficher dans la liste des moteurs de recherche.
Si ce n'est pas le cas en raison de protections du //tracker//, ou si vous souhaitez afficher des icones personnalisées, enregistrez-la dans le dossier ''~/.local/share/data/qBittorrent/nova/engines''

==== Activation / désactivation d'un plugin de recherche ====

Ouvrez la liste des moteurs de recherche, puis double-cliquez sur les moteurs dont vous voulez changer l'état (activé/désactivé).

==== Désinstallation d'un plugin de recherche ====

  * Ouvrez qBittorrent (menu Applications / Internet) et cliquez sur l'onglet Recherche.
  * Ensuite cliquez sur le bouton "Moteurs de recherche..." situé en bas à droite de l'onglet.
  * Sélectionnez le moteur de recherche à désinstaller par un clic droit, puis choisissez Désinstaller.

===== Voir aussi =====

  * [[http://www.qbittorrent.org/|Site Officiel]]
  * [[https://github.com/qbittorrent/qBittorrent/wiki|Wiki officiel de qBittorrent]]
  * [[https://github.com/davy39/qbfrench/wiki|Wiki des plugins francophones qbfrench]]
  * [[http://forum.ubuntu-fr.org/viewtopic.php?id=1591131|Discussion du forum ubuntu-fr sur les plugins qbfrench]]
----