mdx

mdx

mdx est une simple application CLI permettant de télécharger des mangas à partir du site Web MangaDex. Le programme utilise l'API MangaDex pour récupérer le contenu des mangas.

Caractéristiques ?

• Fonctionne sous Windows, MacOS, Linux .
• Télécharge plusieurs chapitres .
• Enregistre les mangas aux formats CBZ, PDF, EPUB .
• Enregistre plusieurs chapitres dans un seul fichier .
• Mode de téléchargement interactif .
• Génère automatiquement des métadonnées pour les fichiers téléchargés, adaptées aux liseuses électroniques .
• Recherche des mangas.
• Affiche des informations sur les mangas.

Installation

1. Téléchargez l'archive .tar.gz à partir de la page des versions.
2. Désarchivez le fichier :
   • Sous Windows, utilisez des outils comme 7-Zip.
   • Sous macOS et Linux, utilisez le terminal : tar -xzf mdx-*.tar.gz
3. Exécutez l'exécutable :
   • Sous Windows, ouvrez le cmd , accédez au dossier non archivé et exécutez .mdx.exe
   • Sous macOS et Linux, ouvrez le terminal, accédez au dossier non archivé et exécutez ./mdx

Alternativement, vous pouvez installer via go :

 go install github.com/arimatakao/mdx@latest

Utilisation dans Nix, NixOS

Utiliser des flocons pour exécuter mdx directement :

 nix run github:arimatakao/mdx -- download --help

Utiliser des flocons pour créer un shell temporaire avec mdx disponible sur le $PATH :

 nix shell github:arimatakao/mdx

Étapes post-installation

Cette étape est facultative. Effectuez-le si vous souhaitez exécuter mdx depuis n'importe où dans votre terminal.

Fenêtres

Copiez mdx.exe dans un répertoire inclus dans votre PATH ou ajoutez son répertoire au PATH

Linux

Copiez le fichier mdx dans /usr/bin/ :

sudo cp mdx /usr/bin/
# or
sudo cp mdx /usr/local/bin/

Mac OS

Ajoutez mdx dans votre PATH :

 export PATH=$PATH:

Exécutez source pour redémarrer la configuration du shell :

 source ~ /.zshrc

Exemples d'utilisation️

Mode de téléchargement interactif :

mdx dl -i

Démo du mode interactif :

Remarque : le titre de votre manga doit comporter plus de 5 caractères lors de la recherche pour éviter les erreurs.

Télécharger des mangas :

 # get help
mdx download --help

# by default 1 chapter is being downloaded
mdx download -u https://mangadex.org/title/a3f91d0b-02f5-4a3d-a2d0-f0bde7152370/this-gorilla-will-die-in-1-day
# or
mdx dl -u https://mangadex.org/title/a3f91d0b-02f5-4a3d-a2d0-f0bde7152370/this-gorilla-will-die-in-1-day
# or
mdx dl https://mangadex.org/title/a3f91d0b-02f5-4a3d-a2d0-f0bde7152370
# or
mdx dl mangadex.org/title/a3f91d0b-02f5-4a3d-a2d0-f0bde7152370

# download pdf format instead of cbz
mdx dl -e pdf mangadex.org/title/a3f91d0b-02f5-4a3d-a2d0-f0bde7152370
# or epub format
mdx dl -e epub mangadex.org/title/a3f91d0b-02f5-4a3d-a2d0-f0bde7152370

# download all chapters
# i don't recommend using this flag - https://github.com/arimatakao/mdx?tab=readme-ov-file#getting-error-while-getting-manga-chapters-request-is-failed-i-cant-download-anything-why
mdx dl -a mangadex.org/title/a3f91d0b-02f5-4a3d-a2d0-f0bde7152370

# download a specific chapter
mdx dl -c 3 mangadex.org/title/a3f91d0b-02f5-4a3d-a2d0-f0bde7152370
# or set direct link to the chapter
mdx dl --this mangadex.org/chapter/7c5d2aea-ea55-47d9-8c65-a33c9e92df70
# or
mdx dl https://mangadex.org/chapter/7c5d2aea-ea55-47d9-8c65-a33c9e92df70

# download a range of chapters
mdx dl -c 1-3 mangadex.org/title/a3f91d0b-02f5-4a3d-a2d0-f0bde7152370

# download a range of chapters and merge them in one file
mdx dl -m -c 1-3 mangadex.org/title/a3f91d0b-02f5-4a3d-a2d0-f0bde7152370

# download last chapter
mdx dl --last mangadex.org/title/a3f91d0b-02f5-4a3d-a2d0-f0bde7152370

# specify language, default is english (to get the available languages, execute the info subcommand)
mdx dl -l it mangadex.org/title/a3f91d0b-02f5-4a3d-a2d0-f0bde7152370

# specify the output directory
mdx dl -o your/dir mangadex.org/title/a3f91d0b-02f5-4a3d-a2d0-f0bde7152370

# specify translation
mdx dl -t " Black Cat " mangadex.org/title/a3f91d0b-02f5-4a3d-a2d0-f0bde7152370

# download compressed version (lower image quality and file size)
mdx dl -j mangadex.org/title/a3f91d0b-02f5-4a3d-a2d0-f0bde7152370

Vérifiez les mises à jour disponibles :

mdx update

Obtenez de l'aide sur les sous-commandes et les indicateurs :

mdx
mdx -h
# ping subcommand is example
mdx ping
mdx ping -h

Rechercher des mangas :

mdx find -t " Manga Title "
mdx search -t " Manga Title "
mdx f -t " Manga Title "

Obtenez des informations détaillées sur le manga :

mdx info -u https://mangadex.org/title/319df2e2-e6a6-4e3a-a31c-68539c140a84/slam-dunk
# or
mdx info mangadex.org/title/319df2e2-e6a6-4e3a-a31c-68539c140a84/slam-dunk

Vérifiez la connexion à l'API MangaDex :

mdx ping

FAQ

Où puis-je trouver le lien du manga ?

Vous pouvez trouver le lien du manga sur mangadex.org. Choisissez le manga que vous aimez et ouvrez sa page. Le lien vers le manga ressemble à ceci :

 https://mangadex.org/title/abc-123-abc/some-title

Vous pouvez utiliser ce lien pour télécharger des chapitres du manga.

Où puis-je obtenir le lien du chapitre ?

Allez sur mangadex.org, choisissez le manga que vous aimez et ouvrez le chapitre spécifique que vous souhaitez. Le lien vers le chapitre ressemble à ceci :

 https://mangadex.org/chapter/abc-123-abc

Vous pouvez utiliser ce lien pour télécharger le chapitre spécifique.

Je n'arrive pas à télécharger le chapitre X du manga X. Pourquoi ?

Assurez-vous d'avoir spécifié la langue, le groupe de traduction et le nombre de chapitres corrects. Si vous ne parvenez pas à télécharger un chapitre spécifique, essayez d'utiliser le lien direct vers le chapitre :

 mdx dl https://mangadex.org/chapter/abc-123-abc

N'oubliez pas : mdx ne peut télécharger que des chapitres depuis MangaDex.

Pourquoi le téléchargement est-il si lent ?

Je ne sais pas. C'est un problème du côté de MangaDex ou de votre côté.

J'ai téléchargé un chapitre mais le nom du fichier de sortie ne comporte pas le numéro de volume ni le numéro de chapitre. Pourquoi?

Ce problème vient du fait que le téléchargeur n'a pas réussi à spécifier les détails corrects du volume ou du chapitre.

Pourquoi les pages du PDF ont-elles des tailles différentes ?

La taille de chaque page du PDF correspond à la taille de l'image.

Obtention de l'erreur "Lors de l'obtention des chapitres du manga : la demande a échoué". Je ne peux rien télécharger. Pourquoi?

Ce problème est lié à l'API MangaDex (https://api.mangadex.org/docs/2-limitations/#general-rate-limit), mdx envoie trop de requêtes par seconde. Essayez de télécharger les chapitres plus tard.

Obtention de l'erreur "Chapitres xy introuvables, essayez une autre plage, une autre langue, un autre groupe de traduction, etc."

Peut-être n'avez-vous pas spécifié correctement le groupe de traduction, la plage de chapitres ou la langue. Assurez-vous que le chapitre peut être ouvert sur MangaDex (pas sur une ressource externe).

Parfois, il ne se télécharge pas à cause de problèmes du côté de MangaDex. Réessayez plus tard.

Obtenir une erreur en mode interactif lors de la recherche de manga. Pourquoi?

Parce que votre requête doit comporter plus de 5 caractères pour éviter les erreurs.

FAIRE ?

Fonctionnalité

• Supprimez Doujinshi de la liste dans la sous-commande find et ajoutez le drapeau doujinshi pour afficher Doujinshi dans la liste.
• Ajoutez des métadonnées pour l'archive téléchargée par cbz.
• Ajoutez la sous-commande check update.
• Ajouter un drapeau à download :
  • merge - télécharger les chapitres dans un seul fichier.
  • last - téléchargez le dernier chapitre.
  • this - téléchargez un chapitre spécifique en utilisant un lien fourni par l'utilisateur.
  • extension - définit l'extension du fichier de sortie. Ajouter les formats de prise en charge des fichiers :
    • pdf (inclure les métadonnées).
    • epub (inclure les métadonnées).
  • all - téléchargez tous les chapitres.
  • volume - téléchargez tous les chapitres du volume spécifié.
  • volume-range - télécharge tous les chapitres de la plage de volumes spécifiée.
  • volume-bundle - téléchargez tous les chapitres du volume dans un seul fichier.
  • oneshot - téléchargez tous les oneshots du manga (si disponible).
• Ajoutez le mode interactif pour la sous-commande download .
• Ajoutez un mécanisme de mise à jour automatique.
• Ajoutez un filtre de recherche pour la sous-commande find .
• Ajoutez un indicateur random dans la sous-commande info pour obtenir des informations sur les mangas aléatoires.
• Ajoutez un mode interactif pour la sous-commande find . (déjà ajouté dans la sous-commande download )

Code

• Utilisez plutôt la sortie pterm fmt .
• Refactoriser le package cmd .
• Ajouter un limiteur de débit pour l'API client.
• Créez une action Github pour automatiser la création de packages .deb .rpm .pkg.tar.zst lorsqu'une nouvelle version est créée.
• Ajoutez des tests pour le package mangadexapi .
• Refactoriser le package internal/mdx .
• Refactoriser le package mangadexapi .
• Refactoriser le package filekit .

Licence

Ce projet est sous licence MIT - voir le fichier LICENSE pour plus de détails.

Bibliothèques tierces

Ce projet utilise les bibliothèques tierces suivantes :

• Cobra (https://github.com/spf13/cobra) - Sous licence Apache License 2.0
• Resty (https://github.com/go-resty/resty) - Sous licence du MIT
• PTerm (https://github.com/pterm/pterm) - Sous licence du MIT
• gopdf (https://github.com/signintech/gopdf) - Sous licence du MIT
• go-epub (https://github.com/go-shiori/go-epub) - Sous licence du MIT
• consolesize-go (https://github.com/nathan-fiscaletti/consolesize-go) - Sous licence du MIT

Contributeurs

• arimatakao
• wollandark
• nikololihim