mdx
v1.11.1
mdx is a simple CLI application for downloading manga from the MangaDex website. The program uses MangaDex API to fetch manga content.
.tar.gz archive from releases page.tar -xzf mdx-*.tar.gz
cmd, navigate to the unarchived folder, and run .mdx.exe
./mdx
Alternatively, you can install via go:
go install github.com/arimatakao/mdx@latest
Using flakes to run mdx directly:
nix run github:arimatakao/mdx -- download --help
Using flakes to create a temporary shell with mdx available on the $PATH:
nix shell github:arimatakao/mdx
This steps is optional. Perform it if you want to run mdx from anywhere in your terminal.
Copy mdx.exe to a directory included in your PATH or add its directory to the PATH
Copy mdx file to /usr/bin/:
sudo cp mdx /usr/bin/
# or
sudo cp mdx /usr/local/bin/Add mdx in your PATH:
export PATH=$PATH:</path/to/mdx>
Run source to restart the shell configuration:
source ~/.zshrcInteractive downloading mode:
mdx dl -iDemo of interactive mode:
Note: Your manga title should be more than 5 characters when searching to avoid errors.
Download manga:
# 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-f0bde7152370Check available updates:
mdx updateGet 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 pingYou can find the manga link at mangadex.org. Choose the manga you like and open its page. The link to the manga looks like this:
https://mangadex.org/title/abc-123-abc/some-title
You can use this link to download chapters of the manga.
Go to mangadex.org, choose the manga you like, and open the specific chapter you want. The link to the chapter looks like this:
https://mangadex.org/chapter/abc-123-abc
You can use this link to download the specific chapter.
Make sure you have specified the correct language, translation group, and number of chapters. If you are unable to download a specific chapter, try using the direct link to the chapter:
mdx dl https://mangadex.org/chapter/abc-123-abc
Remember: mdx can only download chapters from MangaDex.
I don't know. It's a problem on MangaDex's side or on your side.
This problem stems from the uploader failing to specify the correct volume or chapter details.
The size of each page in the PDF corresponds to the size of the image.
This issue is related to the MangaDex API (https://api.mangadex.org/docs/2-limitations/#general-rate-limit), mdx is sending too many requests per second. Try downloading chapters later.
Maybe you didn't specify the translation group, chapter range, or language correctly. Make sure that the chapter can be opened on MangaDex (not on external resource).
Sometimes it doesn't download because of some problems on the MangaDex side. Just try again later.
Because your query should be more than 5 characters to avoid errors.
find subcommand and add doujinshi flag for show Doujinshi in list.download:
merge - download chapters in one file.last - download latest chapter.this - download a specific chapter using a link provided by the user.extension - sets the extension of the output file. Add file support formats:
all - download all chapters.volume - download all chapters of specified volume.volume-range - download all chapters of specified volume range.volume-bundle - download all chapters of volume into one file.oneshot - download all oneshots of manga (if available).download subcommand.find subcommand.random in info subcommand to get information about random manga.find subcommand.download subcommand)pterm output instead fmt.cmd package..deb .rpm .pkg.tar.zst packages when a new release is created.mangadexapi package.internal/mdx package.mangadexapi package.filekit package.This project is licensed under the MIT - see the LICENSE file for details.
This project uses the following third-party libraries:
