Ceci est une ancienne révision du document !



Transmission

 Logo de Transmission

Transmission est le client BitTorrent installé par défaut sur Ubuntu. Il se veut intuitif, fonctionnel et très léger. Il dispose de fonctionnalités comme le chiffrement des échanges de données, l'échange de pairs, le support des blocklists, la limitation des débits en émission et en réception, etc. Il possède une interface graphique très épurée en GTK et d'une seconde en QT. Il est disponible sous licence GPLv2 ou X11.

L'interface de Transmission sous Ubuntu 12.04

Par les dépôts officiels

Transmission est le client BitTorrent par défaut d'Ubuntu. Vous le trouverez dans le menu Applications → Internet, ou en tapant transmission dans le dash d'Unity.

Sinon, pour l'installer il suffit d'installer le paquet transmission.

Par un des dépôts PPA

Les versions bêta et expérimentales sont à utiliser à vos risques et périls.

Ajouter à vos sources de logiciels l'un des PPA suivants :

  • Version stable : ppa:transmissionbt/ppa1)
  • Version bêta : ppa:transmissionbt/beta2)
  • Version expérimentale : ppa:transmissionbt/nightly3)

Puis recharger la liste des paquets et installer le paquet transmission.

En attendant, la version 2.74 est installable manuellement en téléchargeant soi-même les paquets et en les installant avec 'sudo dpkg -i <paquet>'. Téléchargez et installez dans cet ordre : transmission-common, transmission-gtk et enfin transmission.

Pour la version 32bits pas de soucis, elle est complète en 2.76.</note>

Veillez à ce que le port TCP sélectionné dans Édition → Préférences → Réseaux soit ouvert ; vous pouvez vous servir de gufw pour configurer vos ports (le port de base est le 51413).

Vous pouvez aussi configurer transmission en modifiant le fichier ~/.config/transmission(-daemon)/settings.json.

Documentation des options paramétrables dans settings.json

Intégration de Transmission au launcher Unity

Basé sur ce tutoriel, réalisé avec succès sous Ubuntu 13.10 (« The Saucy Salamander »)

Il est possible d'ajouter une fonctionnalité à Transmission afin d'afficher une petite barre de progression et le nombre de téléchargements en cours sur sa tuile du launcher Unity, comme sur l'image ci-dessous.

Pour obtenir ce résultat, voici comment procéder :

  1. Ouvrez un terminal, et installer les paquets python-transmissionrpc et git-core :
    sudo apt-get install python-gobject python-transmissionrpc git-core
  2. Retournez sur votre dossier HOME si vous n'y êtes pas (avec la commande cd), puis clonez le dépôt Git du projet :
    git clone https://github.com/kriomant/transmission-unity-launcher.git
  3. Copiez le script Python dans le dossier /urs/local/bin, puis donnez-lui les droits d'exécution :
    sudo cp transmission-unity-launcher/transmission-unity-launcher.py /usr/local/bin/
    sudo chmod +x /usr/local/bin/transmission-unity-launcher.py
  4. Créez les dossiers manquants dans votre HOME (FIXME ne sont-ils pas déjà présents dès l'installation d'Ubuntu ?) :
    mkdir -p ~/.local/share/applications
  5. Copiez le fichier icône de Transmission dans ce nouveau dossier :
    cp /usr/share/applications/transmission-gtk.desktop ~/.local/share/applications/
  6. Modifiez le contenu de ce fichier pour qu'il exécute automatiquement le script Python précédemment installé :
    sed -i 's/^Exec=transmission-gtk/Exec=\/usr\/local\/bin\/transmission-unity-launcher.py transmission-gtk/' ~/.local/share/applications/transmission-gtk.desktop
  7. Donnez-lui les droits d'exécution :
    chmod +x ~/.local/share/applications/transmission-gtk.desktop

Une fois ces étapes complétées, vous pouvez fermer le terminal. Il ne reste plus qu'à activer le plugin que nous venons d'installer. Pour cela, rendez-vous dans les préférences de Transmission (Édition → Préférences), onglet Remote, et cochez la case Allow remote access.
Vérifiez que l'authentification est désactivée, et que l'adresse IP 127.0.0.1 est bien indiquée dans la zone Only allow these IP addresses (la case correspondante doit être cochée) :

Transmission est une application complète comprenant service de téléchargement + interface de téléchargement + web UI depuis la version 1.30. Cela signifie que si vous installez aussi transmission-daemon, alors vous aurez 2 services de téléchargement et 2 web UI sur le même port ce qui cause des problèmes. Les deux applications ne se parlent pas ; donc, si vous ne comprenez pas un mot de ce charabia, installez uniquement Transmission.

transmission-gtk

Pour lancer Transmission, allez dans Applications → Internet et cliquez sur Transmission BitTorrent Client. Vous pouvez aussi saisir dans un terminal :

transmission-gtk

ou

transmission

selon votre version (vous pouvez essayer les deux).

Pour lancer Transmission dans la barre des tâches (la fenêtre ne s'affiche pas), tapez dans un terminal :
transmission-gtk -m

ou

transmission -m

transmission-cli

Transmission-cli est une version ligne de commande. Pour l'utiliser, installez-le (si besoin) :

 sudo apt-get install transmission-cli

Puis, tapez dans un terminal :

transmission-cli /le/chemin/de/votre/fichier.torrent

Plusieurs options sont disponibles, afin de les connaître, tapez :

man transmission-cli

À noter que transmission-cli sauvegarde ses téléchargements dans le dossier où il a été lancé, par défaut votre répertoire personnel.

transmission-create

transmission-create est fourni avec transmission-cli et s'utilise en ligne de commande, il permet de créer un torrent. S'il n'est pas installé (transmission-create -V retourne une erreur), installez le paquet :

 sudo apt-get install transmission-cli

Pour créer un torrent, tapez dans un terminal :

transmission-create -o ~/le_torrent_cree.torrent -t http://le-tracker.fr/ -p -c "Mon commentaire" ~/Le_contenu_du_torrent

Voici les options que vous devez changer :

  -o "destination" — Mettez le fichier .torrent désiré
  -t "tracker" — L'adresse du tracker
  -p — Défini si le torrent est privé (enlever dans la majorité des cas)
  -c "commentaire" — Un commentaire associé (entièrement facultatif)

La destination peut-être un dossier ou un fichier, comme désiré

transmission-daemon

Transmission-daemon est un service en fond pour gérer les téléchargements. Installez-le (si besoin), et pour le lancer, tapez dans un terminal (ou en appuyant sur les touches Alt+F2) :

transmission-daemon

Transmission-daemon permet aussi d'avoir une interface Web pour gérer ses téléchargements lorsque transmission-gtk n'est pas installé comme sur une machine sans serveur graphique. Notez que Transmission-daemon a sa propre instance indépendante de toute autre installation de Transmission.

Pour connaître les différentes options, tapez :

transmission-daemon --help

Pour lancer et arrêter le daemon, tapez :

sudo service transmission-daemon start|stop

Le fichier de conf se trouve dans « /var/lib/transmission-daemon/info/settings.json », ne pas oublier de couper le daemon pendant son édition si vous ne voulez pas que les modifications soient écrasées !

transmission-remote

transmission-remote permet de gérer transmission-daemon. Vous pouvez voir un exemple de son utilisation

Pour connaître les différentes options, tapez :

transmission-remote --help
  • Pour avoir le listing des torrents, tapez :
    transmission-remote -l 
  • Pour avoir les infos d'un torrent plus les peers connectés, tapez :
    transmission-remote -t (ID) -i -pi 
(ID) = numéro du torrent (1ere colonne du listing)

"-t (ID)" peut être écrit de plusieurs manière:

  • un seul torrent: -t 1
  • une liste: -t 1,3,5
  • une plage: -t 5-10

Le tout peut être mélangé exemple: -t 1,3,5-10.

Voici un petit script pour faciliter l'utilisation des 2 dernières commandes ;)

#!/bin/bash
 
## "ctrl + c" pour quitter le script 
 
while true
do 
# affichage du listing
clear && transmission-remote -l
read -p N° choi
if [[ "$choi" = "" ]]
then
# retour en debut de boucle 
continue
else
# affichage des infos et peers
transmission-remote -t $choi -i -pi | less
## tapez "q" pour sortir de la commande "less"
fi
done
Si vous obtenez une erreur "Unauthorized User", transmission est peut-être configuré pour demander un login. Il faudra, par exemple pour lister les torrent utiliser la syntaxe suivante :
transmission-remote -n nom:motdepasse -l

Où nom et username sont à mettre dans les variables rpc-username et rpc-password dans le settings.json de transmission ou transmission-daemon selon le cas.

  • Pour supprimer un ou plusieurs torrent, tapez :
    transmission-remote -t (ID) -r
  • Pour stopper un ou plusieurs torrent, tapez :
    transmission-remote -t (ID) -S
  • Pour relancer un ou plusieurs torrent, tapez :
    transmission-remote -t (ID) -s
  • Pour ajouter un fichier torrent, tapez :
    transmission-remote -a /le/chemin/fichier.torrent

Web-UI Clutch

webui sous Precise webui sous Trusty

Une interface Web permet de contrôler Transmission. Depuis la version 1.30, elle est intégrée ainsi qu'un mini serveur web dans l'application transmission. Cela signifie qu'il vous suffit de l'activer dans les préférences et de vous rendre à l'adresse <http://localhost:9091/transmission/web/>.

Purge

Il est possible, si vous êtes un grand téléchargeur, que transmission stocke plusieurs Go de fichiers pour rien sur votre disque dur ! En effet, certains téléchargements se passent mal et des fichiers viennent encrasser le répertoire où sont stockés les téléchargements incomplets. Il peut être intéressant de soulager votre disque dur en vidant ce dossier de temps en temps.

N'exécutez cette commande que si vous êtes certains de n'avoir aucun téléchargement en cours ! Sinon ils serons tous remis à zéro !

Commencez par aller dans le répertoire local de Transmission avant de purger le dossier des téléchargements incomplets :

cd $HOME/.config/transmission/
rm -rf Incomplete/*

Il suffit de supprimer le paquet transmission, transmission-cli ou transmission-gtk selon la version que vous avez installée. Selon la méthode choisie, la configuration globale de l'application est conservée ou supprimée. Les journaux du système, et les fichiers de préférence des utilisateurs dans leurs dossiers personnels sont toujours conservés.


  • transmission.1405506807.txt.gz
  • Dernière modification: Le 16/07/2014, 12:33
  • par utilisateursys