Thanks to visit codestin.com
Credit goes to Github.com

Skip to content
/ mdx Public
forked from arimatakao/mdx

mdx is a command-line interface program for downloading manga from the MangaDex website. The program uses MangaDex API to fetch manga content.

License

Notifications You must be signed in to change notification settings

wolandark/mdx

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

59 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

mdx 📚

mdx is a simple CLI application for downloading manga from the MangaDex website. The program uses MangaDex API to fetch manga content.

GitHub go.mod Go version GitHub Release GitHub Downloads (all assets, all releases) GitHub Repo stars

demo v1.4.0

Features 💫

  • Works on Windows, MacOS, Linux.
  • Downloads multiple chapters.
  • Saves manga in CBZ, PDF, EPUB formats.
  • Saves multiple chapters in one file.
  • Automatically generates metadata for downloaded files, adapted for e-readers.
  • Searches manga.
  • Displays information about manga.

Installation ⚙️

  1. Download .tar.gz archive from releases page.
  2. Unarchive the .tar.gz file.

Open the unarchived folder and execute the mdx file to use the application.

You can also install the application with go:

go install github.com/arimatakao/mdx@latest

Usage examples️ 🖥️

Download manga:

# get help
mdx download --help

# by default 1 chapter is being downloaded
mdx download -u https://mangadex.org/title/319df2e2-e6a6-4e3a-a31c-68539c140a84/slam-dunk
# or
mdx dl -u https://mangadex.org/title/319df2e2-e6a6-4e3a-a31c-68539c140a84/slam-dunk
# or
mdx dl https://mangadex.org/title/319df2e2-e6a6-4e3a-a31c-68539c140a84
# or
mdx dl mangadex.org/title/319df2e2-e6a6-4e3a-a31c-68539c140a84

# download pdf format instead of cbz
mdx dl -e pdf mangadex.org/title/319df2e2-e6a6-4e3a-a31c-68539c140a84

# download a specific chapter
mdx dl -c 123 mangadex.org/title/319df2e2-e6a6-4e3a-a31c-68539c140a84/slam-dunk

# download a range of chapters
mdx dl -c 12-34 mangadex.org/title/319df2e2-e6a6-4e3a-a31c-68539c140a84

# download a range of chapters and merge them in one file
mdx dl -m -c 12-34 mangadex.org/title/319df2e2-e6a6-4e3a-a31c-68539c140a84

# specify language, default is english (to get the available languages, execute the info subcommand)
mdx dl -l it mangadex.org/title/319df2e2-e6a6-4e3a-a31c-68539c140a84/slam-dunk

# specify the output directory
mdx dl -o your/dir mangadex.org/title/319df2e2-e6a6-4e3a-a31c-68539c140a84/slam-dunk

# specify translation
mdx dl -t "Some Group" mangadex.org/title/319df2e2-e6a6-4e3a-a31c-68539c140a84/slam-dunk

# download compressed version (lower image quality and file size)
mdx dl -j mangadex.org/title/319df2e2-e6a6-4e3a-a31c-68539c140a84/slam-dunk

Get help about subcommands and flags:

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

Search manga:

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

Get detailed information about the 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

Check connection to MangaDex API:

mdx ping

TODO 📌

Functionality

  • Remove Doujinshi from list in find subcommand and add doujinshi flag for show Doujinshi in list.
  • Add metadata for cbz downloaded archive.
  • Add check update subcommand.
  • Add self update mechanism.
  • Add search filter for find subcommand.
  • Add flag random in info subcommand to get information about random manga.
  • Add flag to download:
    • last - download latest chapter.
    • this - download specific chapter using link from user. Make download chapter get the chapter link instead of the manga link.
    • volume - download all chapters of specified volume.
    • volume-range - download all chapters of specified volume range.
    • oneshot - download all oneshots of manga (if available).
    • all - download all chapters.
    • merge - download chapter in one file.
    • volume-bundle - download all chapters of volume into one file.
    • extension - sets the extension of the outpud file. Add file support formats:
      • pdf (include metadata).
      • epub (include metadata).
  • Add interactive mode for find subcommand.
  • Add interactive mode for download subcommand.

Code

  • Add tests for mangadexapi package.
  • Refactor mangadexapi package.
  • Refactor cmd package.
  • Refactor filekit package.

License 📜

This project is licensed under the MIT - see the LICENSE file for details.

Third-party Libraries

This project uses the following third-party libraries:

About

mdx is a command-line interface program for downloading manga from the MangaDex website. The program uses MangaDex API to fetch manga content.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Go 99.6%
  • Makefile 0.4%