Cette documentation est ancienne, et était intialement rédigée par Zebob et destiné aux utilisateurs de Macintosh.

MLDonkey est un client permettant principalement d'utiliser le réseau eDonkey. Il est disponible pour la plupart des plates-formes UNIX, dont Mac OS X. MLDonkey permet également de se connecter au réseau Overnet, et à d'autres via des plugins (voir page 5).

Ce réseau fonctionne sur la base de serveurs auquel les utilisateurs (clients) peuvent se connecter, et qui sont donc composés de milliers d'utilisateurs. Chaque utilisateur partage évidemment des fichiers, et si le fichier recherché est disponible chez plusieurs utilisateurs (sources), il est automatiquement téléchargé depuis ces utilisateurs. De plus, eDonkey assigne un ID unique à chaque fichier, ce qui limite grandement les corruptions.

Le réseau eDonkey est spécialisé dans les fichiers de taille importante (films divX, jeux, albums complets, applications…). Il est beaucoup plus efficace dans le téléchargement de ce type de fichiers que dans le téléchargement de petits fichiers (simple mp3), même si vous en rencontrerez quand même. Cela dit, vous verrez plus loin que, grâce aux plugins, vous aurez accès à FastTrack notamment (réseau de Kazaa !) qui lui propose un grand nombre de mp3s.

Les vitesses de téléchargement dépendent de la rareté et de la disponibilité du fichier. Les téléchargements mettent souvent du temps à démarrer et stagnent parfois longtemps sans progresser (des heures…) : c'est tout à fait normal, il faut être patient (notamment pour les fins de fichiers). C'est pour cela qu'une chose est primordiale avec MLDonkey : le laisser tourner le plus souvent possible quand vous téléchargez, la nuit notamment. En effet, MLDonkey cherchera constamment de nouvelles sources pour vos téléchargements, ainsi être présent 24h/24 augmente grandement vos chances d'achever rapidement vos téléchargements.

Une dernière remarque : il est conseillé de disposer d'un espace libre conséquent sur votre disque dur (plus d'1Go, de préférence). En effet, quand vous commencez à télécharger un fichier, MLDonkey réserve dès le départ la place pour s'assurer que l'espace disque est suffisant. Ainsi, dès que vous commencerez le chargement d'un divX de 650Mo, 650Mo seront retranchés à votre espace disque dès le début.

> Installation

Pour une utilisation simple de MLDonkey, vous devez posséder Mac OS X.1 ou supérieur. Il est nécessaire également de télécharger quelques fichiers :

• MLDonkey

Vous pouvez le télécharger sur le site officiel. Mais je vous recommande une version adaptée spécialement pour mac, à télécharger sur l'iDisk de Michel Moreau (prenez la dernière version STABLE, et prenez le fichier avec le suffixe “X.1” si vous êtes sous OSX.1).

• GTK, installateur nécessaire au bon fonctionnement de MLDonkey.

A télécharger une fois de plus chez Michel Moreau.

Vous pouvez visiter plus en détail la page de Michel Moreau, vous pourrez trouver quelques utilitaires qui vous faciliteront peut-être la tâche (personnellement je n'en utilise pas, mais cela ne regarde que moi !).

Une fois les fichiers téléchargés, décompressez la librairie GTK et installez la. Le fichier .dmg est une image disque. Une fois l'image montée sur le bureau (pour cela, double-cliquez dessus), ouvrez la (icône de couleur blanche), et repérez le dossier avec une icône d'âne. Placez le dans votre dossier Applications (de préférence), et renommez le “mldonkey” pour plus de facilité.

Lancer MLDonkey

1) Avec le Terminal

Le lancement de MLDonkey nécessite l'usage du Terminal (se trouvant dans les utilitaires). N'ayez crainte, ce n'est ni compliqué ni dangereux, vous prendrez vite le coup de main !

Avant tout, allez faire un tour dans le dossier MLDonkey que vous avez placé dans Applications. Repérez le fichier muni d'une icône et nommé “mlnet”. C'est le fameux daemon que l'on va tout de suite lancer avec le terminal.

Lancez donc le Terminal, puis dans la fenêtre : Tapez cd puis un espace Glissez le dossier MLDonkey dans la fenêtre du Terminal, ou tapez le chemin du dossier (soit /Applications/MLDonkey). Appuyez sur Entrée Tapez ./mlnet Appuyez sur Entrée

C'est bon, vous y êtes ! MLDonkey est maintenant lancé, de nombreuses lignes s'affichent. Vous pouvez masquer le terminal, mais ne le quittez pas.

2) Solutions alternatives

Il est possible d'éviter cette manipulation dans le Terminal en utilisant le “Lanceur MLDonkey” (à télécharger chez Moreau). Vous verrez également plus loin dans ce dossier qu'il existe des GUIs qui peuvent lancer MLDonkey pour vous. Cela dit, on s'habitue vite à cette courte manip, qui a l'avantage de permettre de visionner le log de MLDonkey (les lignes qui apparaissent dans la fenêtre du Terminal) qui peut parfois vous en dire long sur les erreurs qui surviennent.

La 3e solution, c'est d'utiliser ce mini-script que j'ai créé. Pour peu que votre dossier MLDonkey s'appelle “mldonkey” et qu'il soit dans “Applications” comme je vous l'ai suggéré, il fera les commandes dans le terminal pour vous, et le masquera une fois MLDonkey lancé. Ainsi, vous avez l'avantage du Terminal (voir le log si vous le désirez), mais vous n'avez pas à taper de commandes Note : le fichier contient le script exécutable (avec l'icône) et le script lui-même que vous pourrez éditer/améliorer à votre guise (si vous faites des améliorations intéressantes, n'oubliez pas de m'en faire part !).

Utiliser MLDonkey

1) Avec l'interface web

Maintenant que la bête est lancée, il faut apprendre à la contrôler. La 1ère solution, et certainement la plus complète (même si la prise en main n'est pas forcément aisée au début), est d'utiliser l'interface web.

Ouvrez votre navigateur et rendez-vous à l'url suivante : http://127.0.0.1:4080 Vous pouvez mettre cette adresse dans vos favoris / signets, elle restera toujours la même. Vous voici dans l'interface web !

La 1ère chose à faire est de régler quelques options pour une bonne utilisation de MLDonkey. Pour cela cliquez sur “Options”. Attention : vous devez appuyer sur entrée après chaque ligne modifiée pour que les changements soient pris en compte.

• Entrez votre nom dans le champ “client_name”, cela permet de personnaliser son client mldonkey. Cela permet aussi de se connecter plus facilement aux serveurs : certains bannissent automatiquement les clients nommés par défaut et ceux de même nom (éviter donc un nom trop courant), et cela sans vous avertir.
• Réglez vos débits maximums de téléchargement et d'upload. 0 signifie “pas de limite”. Evitez le donc pour ne pas saturer votre connection. Dans le cas d'une ADSL 512/128k, on peut par exemple attribuer un maximum de 8 en upload et 50 en download. Attention, respectez l'esprit de partage, ne limitez pas au maximum l'upload.
• Si vous souhaitez stocker les dossiers temp et incoming (contenant respectivement les fichiers temporaires et les fichiers téléchargés) sur une autre partition ou un autre disque dur, cliquez sur l'onglet “Files”. Là, entrez les chemins des dossiers temp et incoming (pour connaitre le chemin d'un dossier ou fichier, glissez le sur une fenêtre libre du Terminal).

Ne modifiez pas les autres valeurs, à moins d'être sûr de ce que vous faites. Passons maintenant aux différentes commandes.

• La liste des serveurs auquels vous êtes connectés apparaît si vous cliquez sur “Connected servers”. Vous pouvez pousser MLDonkey à se connecter plus vite à d'autres serveurs en cliquant sur “Connect more servers”, mais sachez que le nombre de serveurs connectés dépassera rarement 4 ou 5 à long terme, et cela est largement suffisant.
• Pour effectuer une recherche, cliquez sur “Custom Search”. Sélectionnez ensuite votre type de recherche (Mp3, Film, Album, ou encore une recherche personnalisée intitulée Complex Search). Les liens “Jigle”, “SR”, “FN”, “FH” et “FD” mènent vers des sites vous permettant de rechercher des liens vers des fichiers eDonkey. Note : vous pouvez également effectuer une recherche en tapant s suivi de votre recherche dans le champ en haut à droite de la fenêtre.

• Pour consulter les résultats de votre recherche, cliquez sur “Search results”. La recherche est terminée quand “(done)” apparaît après le nombre de résultats. Pour commencer le téléchargement d'un fichier, cliquez dessus.

Vous pouvez voir vos anciennes recherches et leurs résultats en cliquant sur “View searches”.

• Pour voir l'état de vos téléchargements, cliquez sur “Dls”. Pour annuler le téléchargement d'un fichier, cochez la case C (3e case, après le R) et cliquez sur “Submit Changes”. Vous pouvez aussi mettre en pause un téléchargement (1ère case, P) et le relancer (2e case, R).

Vous pouvez également voir le nombre de sources disponibles (c'est à dire le nombre d'utilisateurs qui ont le fichier, complet ou incomplet) pour chaque fichier, ainsi que le pourcentage du fichier disponible en temps réel. De plus, il est possible de régler vos priorités de téléchargement. Enfin, cliquez sur l'un de vos téléchargements pour obtenir plus d'infos.

• Pour voir vos fichiers partagés, cliquez sur “Uls”. Si vous souhaitez ajouter un fichier en partage, mettez le dans le dossier “incoming” de MLDonkey et cliquez sur “Reshare”. Parfois il faut rédémarrer MLDonkey pour que le fichier apparaisse dans la liste, mais dans tous les cas il est bien partagé.
• Quand un téléchargement est achevé, cliquez sur “Commit” pour que le fichier apparaisse dans le dossier “incoming”. Notez que dans les dernières versions, la fonction “auto-commit” est activée par défaut, et vous n'avez pas besoin de le faire à la main.
• Vous pouvez aussi suivre vos débits de téléchargement et d'upload, ainsi que la taille et le nombre de fichiers en partage, en cliquant sur “Bw Stats”.
• Enfin, pour quitter MLDonkey, cliquez sur “Kill core”. Vous pouvez ensuite quitter librement le Terminal.
• Par le biais de sites ou autre, vous pourrez trouver des liens vers des fichiers eDonkey (ils commencent par ed2k:). Pour les utiliser, c'est très simple : copiez le lien et collez-le dans le champ en haut à droite de l'interface web. Cliquez sur Entrée et le téléchargement du fichier est lancé ! 2) Avec les autres GUIs MLDonkey est ce que l'on appelle un daemon. Pour pouvoir l'utiliser efficacement, il est nécessaire de posséder un GUI (Graphical User Interface), c'est à dire une interface qui communique avec le daemon. L'interface web fait office de GUI, mais il existe d'autres alternatives. Vous trouverez les principaux GUIs (CocoDonkey, iHan, MxDonkey…) sur l'iDisk de Michel Moreau (comme tout le reste !). Personnellement, je suis un inconditionnel de l'interface web, qui reste la plus complète et la plus rapide je trouve Elle a le mérite d'être moins gourmande en CPU (ressources systèmes). Mais c'est à vous de voir ce qui vous convient le mieux. > Les plugins Les plugins de MLDonkey permettent de se connecter à d'autres réseaux qu'eDonkey2000 ! FastTrack, Gnutella, BitTorrent, SoulSeek…Ils ne sont pas encore tous au point (en tout cas à l'heure où j'écris cette FAQ), mais je vais vous expliquer comment les utiliser via l'interface web. Il faut tout d'abord les activer. Dans l'interface web, cliquez sur “Options” puis “Net”. Pour activer un plugin, choisissez “true”. La prochaine fois que vous lancerez MLDonkey, celui-ci tentera de se connecter à ces réseaux dès le démarrage. Vous pouvez voir dans “Connected Servers” les serveurs auquels vous êtes connecté. Les serveurs eDonkey, comme vu précédemment, mais également ceux des plugins activés. Si aucune information relative au plugin n'apparaît, c'est qu'il ne fonctionne pas encore. Une fois que les plugins sont activés et que vous êtes connecté à des serveurs, vos recherches s'effectueront sur tous les réseaux disponibles. Le réseau sur lequel se trouve chaque fichier est indiqué dans les résultats de vos recherches. Il peut être utile de faire des recherches sur un réseau spécifique. Le plugin FastTrack fonctionne bien et permet d'avoir accès à une bonne partie des fichiers disponibles sur Kazaa (très bon P2P pour PC) ! On profite également des excellents débits pour le téléchargement, et les mp3s français sont nombreux. Cliquez donc sur “Custom search”, choisissez le type de fichiers, puis tapez votre mot clé et choisissez le réseau (Network) sur lequel vous désirez lancer la recherche. A l'avenir, les plugins devraient beaucoup se développer, et on peut espérer qu'un jour MLDonkey soit le support de tous les réseaux P2P > Encore de l'aide ! Pour toute question, suggestion ou remarque, le forum Mac de P2PFR est à votre disposition ! Nous pourrons certainement vous répondre en cas de problème, et réagir à vos remarques. N'hésitez pas également à laisser votre point de vue sur ce dossier ! Vous pouvez aussi me joindre directement par email. Les forums en français MacDK sont également excellents, pour des questions techniques et les dernières news. Enfin, la FAQ officielle de MLDonkey est consultable en français.