✎ mldonkey [Wiki ubuntu-fr]

Vous affichez une ancienne révision du document ! Si vous l'enregistrez, vous créerez une nouvelle version avec ce contenu.

----

====== mldonkey ======

**Attention : Nous vous rappelons qu'il est interdit d'utiliser ce logiciel à des fins illégales (piratage, contrefaçon ou toute autre activité étant considérée hors-la-loi par les lois en vigueur dans votre pays de résidence).**

===== Qu'est-ce que mldonkey ? =====

**mldonkey** est un client P2P multi-plateforme, pour le réseau edonkey2000 mais aussi bittorent, fasttrack et bien d'autres.

Mldonkey est pour moi le meilleur client donkey sous linux.
Bien moins gourmand que amule, il ne nécessite pas d'interface graphique pour continuer à télécharger, et il existe de très beaux clients graphique notamment sancho (voir plus bas).

==== Objectif du tutoriel ====

Ce tutoriel a pour objectif de vous permettre d'installer mldonkey sur votre Ubuntu, il décrit également brièvement les paramétrages à effectuer, ainsi que quelques points délicats.

Ce tutoriel décrit également comment installer un client graphique afin de piloter la bête.

===== Installer mldonkey =====

==== Installation en deux minutes sur Hoary ====

L'installation peut-être réalisée très facilement en [[console:ligne_de_commande|ligne de commande]] par la commande :

<code>
    bash:~$ sudo apt-get install mldonkey-server
</code>
Ou bien via [[:Synaptic]].

Lors de l'installation une série de questions vous sera posée.
Répondez tout simplement aux questions en utilisant les choix par défauts.
Nous configurerons par la suite le démon de façon manuelle.

**NB:**
En effet lorsque j'ai essayé de configurer mldonkey en utilisant le script d'installation du paquet, il semble que mes choix n'aient pas été enregistrés.
Je préfère donc vous expliquer comment configurer le démon manuellement.

==== Premier lancement ====

Nous venons d'installer mldonkey. Vous ne trouverez pas d'entrée dans le menu applications
concernant mldonkey. En effet mldonkey est un [[http://fr.wikipedia.org/wiki/Disk_and_execution_monitor|démon]] qui démarre au boot de votre ordinateur. Ensuite vous utiliserez un client graphique qui permettra de contrôler ce démon.

Pour lancer le démon tapez:
<code>
   bash:~$ sudo /etc/init.d/mldonkey-server restart
</code>

==== Lancement automatique ====

Afin de ne pas à avoir à lancer le démon à chaque démarrage, il vous faut éditer le fichier /etc/default/mldonkey-server
<code>
gksudo gedit /etc/default/mldonkey-server
</code>

Puis dans le paramètre LAUNCH_AT_STARTUP, mettre à true.

Si pour une raison ou pour une autre vous voulez couper ou rallumer le démon mldonkey faites:

**Pour le stopper:**
<code>
sudo /etc/init.d/mldonkey-server stop
</code>

**Pour le démarrer:**
<code>
sudo /etc/init.d/mldonkey-server start
</code>

===== Configuration du démon mldonkey =====

==== Configuration des répertoires ====

Comme tout bon logiciel de P2P, mldonkey a besoin de deux répertoires pour fonctionner.
Un répertoire "temp" dans lequel il stockera les fichiers en cours de téléchargement,
un répertoire "incoming" dans lequel il placera les fichiers téléchargés.

Par défaut ces deux répertoires se situe dans /var/lib/mldonkey, ce qui n'est pas très pratique. Nous allons donc modifier le démon afin qu'il place ces répertoire dans votre dossier personnel.

Avant de toucher au fichier de configuration du démon nous devons éteindre celui ci, pour se faire et comme je l'ai dit plus haut :
<code>
sudo /etc/init.d/mldonkey-server stop
</code>

Maintenant nous allons éditer le fichier /var/lib/mldonkey/downloads.ini
<code>
gksudo gedit /var/lib/mldonkey/downloads.ini
</code>

Il faut trouver la ligne contenant les paramètres incoming_directory et temp_directory,
puis les remplacer par les repertoire de votre choix :

ce qui donne par exemple:

<code>
temp_directory = "/home/mondossierpersonnel/mldonkey/temp"

(* The directory where downloaded files should be moved after commit *)
 incoming_directory = "/home/mondossierpersonnel/mldonkey/fini"
</code>

bien sur nous devons créer ces deux répertoires.

**EDIT : Pour Feisty, les dossiers se trouve dans /home/mondossierpersonnel/.mldonkey**
<code>
gedit /home/mondossierpersonnel/.mldonkey/downloads.ini
</code>

Trouver la section pour les fichiers temporaires:
<code>
temp_directory = "/home/mondossierpersonnel/mldonkey/temp"
</code>
Puis la section pour les repertoires de partage et de classement
<code>
 shared_directories = [
  {     dirname = "/home/mondossierpersonnel/.mldonkey/shared"    ## dossier partagé
     strategy = only_directory
     priority = 0
};
  {     dirname = shared
     strategy = all_files
     priority = 0
};
  {     dirname = "/home/mondossierpersonnel/.mldonkey/incoming"    ## dossier fichiers finis edonkey
     strategy = incoming_files
     priority = 0
};
  {     dirname = "/home/mondossierpersonnel/.mldonkey/incoming"    ## dossier fichiers finis bittorent
     strategy = incoming_directories
     priority = 0
};]
</code>

==== Configuration des droits====

Pour des raisons de sécurité, le démon mldonkey est lancé par l'utilisateur mldonkey appartenant au groupe mldonkey.
Pour que ce dernier puisse aller écrire dans nos deux répertoires fraîchement crées, il faut modifier les droits:

<code>
sudo chgrp -R mldonkey /home/mondossierpersonnel/mldonkey/*
</code>
Avec cette commande je change le groupe de mes dossiers.
<code>
sudo chmod 662 -R /home/mondossierpersonnel/mldonkey/*
</code>
Avec cette commande, j'autorise toute personne du groupe mldonkey de modifier mes répertoires (lire, et écrire mais pas exécuter).

Comme l'utilisateur mldonkey, appartient également au groupe mldonkey et que le démon est lancé par l'utilisateur mldonkey, ce dernier pourra donc lire et écrire dans les répertoires définis.

**EDIT : Sous Feisty cette etape n'est plus obligatoire.**

===== Installation d'un client graphique =====

Bon c'est bien joli tout ça, mais moi je voudrais pouvoir lancer un téléchargement.
On y vient.
Comme je l'ai dis mldonkey n'est que le "core" du système de téléchargement. Pour pouvoir le piloter facilement il vous faut un client graphique qui se connectera au core et lui enverra des commandes.

L'avantage est que vous pouvez fermer le client graphique, le démon lui, continue à télécharger. Donc vous pouvez fermer votre session gnome, et continuer à télécharger.

Un autre avantage est que vous pouvez configurer un pc dédié uniquement au téléchargement sur lequel tourne le core, et piloter le téléchargement depuis un autre pc, ou même du bureau. Donc en résumé par exemple, un pc dans le salon qui fait du bruit et qui télécharge, un pc dans la chambre depuis lequel on lance les téléchargements et qu'on peut éteindre la nuit (ouf, ma femme est contente).

A ce propos, mldonkey fourni nativement une interface web pour piloter le core. Elle est accessible par défaut sur le port 4080 (vous pouvez le changer dans la configuration de mldonkey) de la machine qui héberge le core (vous pouvez donc accéder à votre interface web à l'addresse [[http://localhost:4080/|http://localhost:4080/]]). Si vous avez défini un mot de passe à l'installation, un identifiant/mot de passe vous sera demandé à la connexion. L'identifiant est "admin" et le mot de passe est celui que vous avez rentré.
Si vous voulez l'utilisez à l'extérieur, vous pouvez facilement définir un reverse proxy dans apache qui pointera par exemple sur le dossier http://monsite/mldonkey.
Comme ca, depuis internet, vous pouvez lancer des téléchargements.
{{applications:mldonkey-web2.png}}

==== mlgui ====

Le premier client graphique que je vous présente est le plus simple à installer. En effet il vous suffit d'installer le paquet mldonkey-gui.
<code>
sudo apt-get install mldonkey-gui
</code>

Ensuite lancez le client en lancant la commande:
<code>
mlgui
</code>

==== Sancho ====

=== installation ===

Il existe plusieurs interfaces graphiques, ma préférée est sancho : http://sancho-gui.sourceforge.net/
Ce dernier devrait devenir le futur client graphique officiel à mldonkey.

C'est une interface gtk2 avec un icone dans le systray.

Récupérez donc l'archive de sancho ici: http://sancho-gui.sourceforge.net/download.phtml, télécharger la dernière version, aujourd'hui (15/04/07) c'est : sancho-0.9.4-58-linux-gtk.sh

Placer l'archive dans votre home.

Créer le répertoire (là ou on vas installé) :
<code>
sudo mkdir /usr/local/sancho
</code>

Maintenant on vas extraire l'archive :
<code>
sudo sh /home/utilisateur/sancho-0.9.4-58-linux-gtk.sh
</code>

A la question :
<code>
Extract to directory [<sancho-0.9.4-58-linux-gtk>]:
</code>

Taper le chemin du répertoire d'installation, ici le répertoire qu'on vient de créer "/usr/local/sancho"

Voila maintenant qu'il est installé, on va créer une entrée dans le menu applications->internet.

Pour se faire créer le fichier /usr/share/applications/sancho.desktop
<code>
gksudo gedit /usr/share/applications/sancho.desktop
</code>
et copier coller les lignes suivantes:

<code>
[Desktop Entry]
Name=Sancho
Comment=Sancho
Exec=/usr/local/sancho/sancho
Icon=/usr/local/sancho/distrib/sancho-32.xpm
Terminal=false
Type=Application
StartupNotify=false
Categories=Application;Network;
</code>

L'utilisateur n'a pas le droit d'executé sancho ! Alors taper les 2 lignes suivantes pour changer l'appartenance des fichiers :
<code>
sudo chown -R utilisateur /home/utilisateur/.sancho/
sudo chown -R utilisateur /usr/local/sancho/
</code>

Voila, maintenant, vous pouvez démarrer sancho en cliquant sur l'icône du menu applications->internet->sancho.

Et voici le résultat:

=== Mettre sancho en français ===

Pour mettre sancho en français, c'est trés simple:

1- Récupérer le fichier de traduction [[http://sancho-gui.sourceforge.net/properties/sancho_fr_FR.properties|sancho_fr_FR.properties]] et copiez
ce fichier dans  votre repertoire personnel/.sancho
<code>
cp sancho_fr_FR.properties ~/.sancho/
</code>
Maintenant démarrez sancho, allez dans Preferences->sancho->general->locale et selectionnez français. Puis redémarrez sancho.

=== Dernière étape: se connecter à un serveur ===

Bon la dernière étape et de se connecter à un serveur pour pouvoir lancer une recherche.
Lancez sancho, cliquez sur l'onglet serveur.
Puis en haut a droite cliquez sur la croix verte intitulé "ajouter un nouveau serveur"
rentrez l'adresse de razorback par exemple:

Liste complète de serveurs : [[http://jd2k.com/liste.php]] ou [[http://corpo.free.fr/server.met]]

Il devrait aussi récupérer une liste d'autre serveurs.
NB : Il est plus sûr de désactiver les options de récupération automatique des serveurs afin d'éviter de recevoir des serveurs espions. Dans ce cas une liste de serveurs sûrs doit être récupérée en téléchargeant un des fichiers ".met" ci-dessus.

Une fois connecté lancez une recherche.

=== Lancement du demon avec l'interface graphique Sancho ===

Pour lancer le demon automatiquement au demarrage de Sancho et le couper à la fermeture de Sancho ( a la maniere de Amule ) :
<code>
mlnet -ask_for_gui true -start_gui true -mldonkey_gui /usr/local/sancho/sancho
</code>

**N'oubliez pas d'autorisez Sancho a couper le serveur mldonkey losque vous quittez :**
 
outils / preferences puis cocher Kill spawned core when exiting sancho

===== Un système d'analyse anti-virus et d'alerte =====

Dernier raffinement, vous pouvez vous créer un script (shell, php, perl, ...) qui sera lancé au démarrage et à la récupération d'un fichier.
Cela permet d'avertir l'utilisateur, de scanner avec un anti-virus le fichier récupéré, et même de le sortir de l'incoming, pour éviter les problèmes d'upload.
Allez voir dans downloads.ini, jusqu'a la commande file_completed.
Si il y en a que ca intéresse, je peux joindre la copie de mon script (home made 100% pas propre).

===== Enfin =====

Finalement, bon téléchargements. Mais n'oubliez pas de ne pas pirater des oeuvres. Il existe des millions d'oeuvres libres de droits alors autant en profiter.

----

//Contributeur : Rédigé par [[utilisateurs:mathieu.vilaplana]]//

Merci de recopier le code ci-contre pour prouver que vous êtes humain : W X E C D Merci de laisser ce champ vide :

Résumé

Note : En modifiant cette page, vous acceptez que le contenu soit placé sous les termes de la licence suivante : CC Paternité-Partage des Conditions Initiales à l'Identique 3.0 Unported