mdx is a simple CLI application for downloading manga from the MangaDex website. The program uses MangaDex API to fetch manga content.
- 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.
- Download
.tar.gzarchive from releases page. - Unarchive the
.tar.gzfile.
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
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-dunkGet help about subcommands and flags:
mdx
mdx -h
# ping subcommand is example
mdx ping
mdx ping -hSearch 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-dunkCheck connection to MangaDex API:
mdx ping- Remove Doujinshi from list in
findsubcommand and adddoujinshiflag for show Doujinshi in list. - Add metadata for cbz downloaded archive.
- Add check update subcommand.
- Add self update mechanism.
- Add search filter for
findsubcommand. - Add flag
randomininfosubcommand 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
findsubcommand. - Add interactive mode for
downloadsubcommand.
- Add tests for
mangadexapipackage. - Refactor
mangadexapipackage. - Refactor
cmdpackage. - Refactor
filekitpackage.
This project is licensed under the MIT - see the LICENSE file for details.
This project uses the following third-party libraries:
- Cobra (https://github.com/spf13/cobra) - Licensed under the Apache License 2.0
- Resty (https://github.com/go-resty/resty) - Licensed under the MIT
- PTerm (https://github.com/pterm/pterm) - Licensed under the MIT
- gopdf (https://github.com/signintech/gopdf) - Licensed under the MIT
- go-epub (https://github.com/go-shiori/go-epub) - Licensed under the MIT