MyMule

Un client eMule moderne pour votre serveur ou votre NAS. Un petit programme pour les réseaux eD2K et Kad, piloté depuis le navigateur, le téléphone ou le terminal.

L’interface web : les téléchargements avec leur progression, leurs sources et leurs places dans les files
L’interface web, avec des données de démonstration : les fichiers sont inventés.

Pourquoi MyMule

Un seul fichier, rien d’autre

Un seul programme sans dépendances : pas de démon séparé, de serveur web, de Python ni de Node à installer. Pour Windows, Linux, macOS, FreeBSD, les cartes ARM et les NAS, avec environ 15 Mo de RAM.

Un vrai client eMule

eD2K et Kad, crédits, AICH, échange de sources, obfuscation et HighID : il parle avec eMule et aMule comme l’un des leurs.

Fait pour tourner seul

Il tourne comme un service, reprend après un arrêt ou un redémarrage, vérifie tout ce que les autres envoient et est sûr par défaut.

Tout depuis le navigateur

Une interface web intégrée qui fonctionne sur téléphone et s’installe comme une app, plus une ligne de commande pour le terminal.

Ce qu’il fait

Télécharger et partager sur eD2K et Kad

Une interface web pour tous les appareils

Votre bibliothèque, rangée

L’interface web : un film avec son affiche et les fichiers trouvés, notés selon la langue et la qualité
L’interface web : choisissez un film ou une série et obtenez ses fichiers notés selon la langue, la résolution et la source. Données de démonstration : les titres et les fichiers sont inventés.

Toujours sous les yeux

N’utilisez MyMule que pour du contenu que vous avez le droit de télécharger et de partager. Voir les conditions d’utilisation.

Installer

Docker

Tout système avec Docker, NAS et Raspberry Pi compris (amd64, arm64 et armv7). Dans un dossier vide :

docker run -d --name mymule --restart unless-stopped -e PUID=1000 -e PGID=1000 -v ./config:/config -v ./downloads:/downloads -p 4662:4662/tcp -p 4672:4672/udp -p 127.0.0.1:4711:4711/tcp ghcr.io/i234dev/mymule:latest

Ouvrez ensuite http://localhost:4711 et connectez-vous avec l’api_key de config/mymule.conf. Vous préférez Compose ? Utilisez le docker-compose.yml prêt à l’emploi et lancez docker compose up -d. Plus de détails dans le guide Docker (en anglais).

macOS et Linux

Avec Homebrew :

brew install i234dev/tap/mymule

La configuration et les téléchargements sont dans ~/MyMule. Mise à jour : brew upgrade mymule.

Windows

Avec Scoop :

scoop bucket add mymule https://github.com/i234dev/scoop-bucket
scoop install mymule

La configuration et les téléchargements sont dans %USERPROFILE%\scoop\persist\mymule. Mise à jour : scoop update mymule.

Téléchargement

Windows, Linux, macOS et FreeBSD, pour Intel/AMD et ARM : téléchargez l’archive de votre système depuis Releases et décompressez-la où vous voulez. MyMule est portable : sa configuration et ses téléchargements restent à côté du programme. Sous Windows, décompressez le zip et double-cliquez sur mymule.exe : l’interface web s’ouvre dans le navigateur.

Premiers pas

Sans Docker, activez l’interface web dans mymule.conf (créé à côté du programme au premier lancement) et démarrez MyMule :

web_ui = true
mymule start                 # lance le moteur en arrière-plan

Ouvrez ensuite http://127.0.0.1:4711 et connectez-vous avec l’api_key de mymule.conf.

Chaque version est livrée avec un fichier SHA256SUMS et une attestation signée de sa compilation. La documentation (en anglais) a un guide pour chaque partie : installation, interface web, films et séries, ligne de commande, configuration et sécurité, les apps *arr et l’API.

Fonctionne avec

Radarr, Sonarr et compagnie

Un indexeur Torznab et un client de téléchargement compatible qBittorrent : eD2K devient une source de plus pour Radarr, Sonarr, Lidarr, Readarr et Prowlarr.

Plex, Jellyfin et Emby

Il leur demande d’analyser leurs bibliothèques quand de nouveaux fichiers arrivent, pour qu’ils apparaissent tout de suite.

API HTTP

Une petite API JSON pour les scripts : PHP, Python, shell, tâches cron et domotique.

Pour le terminal

Un démon en arrière-plan avec des commandes courtes, et mymule top, une vue en direct plein écran où vous pouvez aussi chercher et gérer les téléchargements.

mymule status                # serveur, vitesse et progression de chaque téléchargement
mymule search -links ubuntu  # recherche ; -links affiche des liens ed2k://
mymule add "ed2k://|file|...|/"
mymule top                   # vue en direct (q pour quitter)
mymule doctor                # ce qui empêche MyMule de bien fonctionner
mymule top : vue en direct des téléchargements, envois et fichiers partagés
mymule top, la vue en direct dans le terminal, avec des données de démonstration.

Questions fréquentes

Est-ce compatible avec les utilisateurs d’eMule et d’aMule ?

Oui. MyMule rejoint les mêmes serveurs eD2K et le même réseau Kad : vous téléchargez depuis et partagez avec tous ceux qui utilisent eMule, aMule et les autres clients compatibles.

Qu’est-ce que le HighID, et en ai-je besoin ?

Avec un HighID, les autres utilisateurs peuvent se connecter directement à vous : vous obtenez beaucoup plus de sources et des téléchargements plus rapides. MyMule ouvre lui-même les ports 4662 (TCP) et 4672 (UDP) sur votre box avec UPnP ou NAT-PMP, si elle le permet ; sinon, redirigez-les à la main vers l’ordinateur où tourne MyMule. Sans HighID, MyMule fonctionne quand même, en LowID et avec moins de sources.

Est-ce sûr ?

Tout ce qu’envoient les autres utilisateurs, serveurs et nœuds Kad est vérifié et limité, et un paquet malveillant ferme cette connexion, pas le programme. L’interface web et l’API ne répondent que sur votre propre ordinateur, sauf si vous le changez, et demandent toujours une clé. Ne redirigez jamais le port 4711 dans votre box. Gardez à l’esprit qu’eD2K est un réseau public : les autres voient votre adresse IP et les fichiers que vous partagez.

Est-ce légal ?

MyMule est un client pour un protocole ouvert d’échange de fichiers, comme un navigateur l’est pour le web. Ce que vous téléchargez et partagez dépend de vous : utilisez-le uniquement pour du contenu que vous avez le droit de partager, comme des logiciels libres, des œuvres du domaine public ou vos propres fichiers. Lisez les conditions d’utilisation.

Pourquoi MyMule et pas aMule ?

MyMule a commencé comme un projet personnel, avant que je sache qu’aMule reprenait vie. Aujourd’hui il existe de très bonnes options : aMule est le client mûr et de longue date, de nouveau activement développé, avec davantage de fonctions classiques d’eMule ; avec aMuTorrent, vous avez en plus une interface web moderne et la prise en charge de Sonarr et Radarr. MyMule est un client plus petit et indépendant, écrit de zéro : il peut vous convenir si vous voulez un seul programme, sans rien d’autre à installer ni à connecter, une bibliothèque qui trouve films et séries par leur titre et les renomme pour vous, et une faible consommation. Si vous avez besoin d’une fonction que MyMule n’a pas, aMule est un excellent choix. Les deux partagent le même réseau : dans tous les cas, vous aidez à le garder vivant.

Que ne fait-il pas encore ?

Certains extras d’eMule, comme les amis et le chat, ne sont pas implémentés. Les idées et les rapports de bugs sont les bienvenus sur GitHub.

Est-ce gratuit ?

Oui : c’est un logiciel libre sous GNU GPL v3, sans publicité et sans compte à créer. Son code source est sur GitHub.

N’utilisez MyMule que pour du contenu que vous avez le droit de télécharger et de partager. eD2K est un réseau public : les autres utilisateurs voient votre adresse IP et les fichiers que vous partagez. Lisez les conditions d’utilisation et l’avertissement avant de l’utiliser.