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

</div>

Features 💫

Works on Windows, MacOS, Linux, Android.
No dependencies required: distributed as a single small executable file with easy installation scripts for Windows, macOS, and Linux.
Works without a MangaDex account.
Interactive downloading mode for convenient use.
Supports downloading chapters by language and translation group.
Downloads multiple chapters with a single command.
Saves manga in CBZ, PDF, EPUB formats or as a simple folder of images.
Saves multiple chapters in one file.
Automatically generates metadata for downloaded files, adapted for e-readers.
Searches manga.
Displays information about manga.

Installation ⚙️

Download the latest release HERE

Windows (recommended)

Install automatically with PowerShell script:

powershell -ExecutionPolicy Bypass -Command "iwr -useb https://raw.githubusercontent.com/arimatakao/mdx/main/install.ps1 | iex"

Or download mdx-*-windows-installer.msi and run this command in cmd:

msiexec /i "C:\path\to\mdx-...-windows-installer.msi"

Note: Administrator permission may be required.

MacOS

Install with the script (adds mdx to ~/.local/bin, no sudo; if needed, also appends it to your shell PATH):

curl -fsSL https://raw.githubusercontent.com/arimatakao/mdx/main/install.sh | bash

Or download the macOS archive (mdx_*_darwin_*.tar.gz) and run:

tar -xzf mdx_*_darwin_*.tar.gz
./mdx --help

Linux

Quick install (adds mdx to ~/.local/bin, no sudo; if needed, also appends it to your shell PATH):

curl -fsSL https://raw.githubusercontent.com/arimatakao/mdx/main/install.sh | bash

Install via Linux package manager (supported: apt, dnf, yum, apk, pacman):

curl -fsSL https://raw.githubusercontent.com/arimatakao/mdx/main/install.sh | sudo bash -s -- --pkg

Manual way: first download the package file from the Releases page, then run the install command for your distro.

Debian/Ubuntu (mdx_*_linux_*.deb):

sudo apt install ./mdx_*_linux_*.deb

RHEL/Fedora (mdx_*_linux_*.rpm):

sudo dnf install ./mdx_*_linux_*.rpm

Alpine (mdx_*_linux_*.apk):

sudo apk add --allow-untrusted ./mdx_*_linux_*.apk

Arch Linux (mdx_*_linux_*.pkg.tar.zst):

sudo pacman -U ./mdx_*_linux_*.pkg.tar.zst

Portable binaries

Windows (mdx_*_windows_*.zip, contains mdx.exe): You can just extract the archive with File Explorer/7-Zip, or use this PowerShell command:

Expand-Archive .\mdx_*_windows_*.zip -DestinationPath .\mdx
.\mdx\mdx.exe --help

Linux/macOS (mdx_*_linux_*.tar.gz, contains mdx):

tar -xzf mdx_*_linux_*.tar.gz
./mdx --help

Android (Termux)

Install curl package:

pkg install curl -y

Execute this command:

bash <(curl -s https://raw.githubusercontent.com/arimatakao/mdx/main/android_installation.sh)

You can also install mdx manually by running these commands in sequence:

pkg update && pkg upgrade -y

pkg install -y golang

echo 'export GOPATH=$HOME/go' >> ~/.bashrc

echo 'export PATH=$PATH:$GOPATH/bin' >> ~/.bashrc

source ~/.bashrc

go install github.com/arimatakao/mdx@latest

For use mdx just execute:

mdx

Go install

go install github.com/arimatakao/mdx@latest

Nix/NixOS

Using flakes to run mdx directly from the default branch:

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

Using a pinned tag for reproducible installs:

nix run 'git+https://github.com/arimatakao/mdx?ref=refs/tags/v1.15.1' -- download --help

Docker

Clone the repository:

git clone https://github.com/arimatakao/mdx.git

Build docker image:

docker build -t mdx .

Usage examples:

# Ping
docker run --rm mdx dl ping
# Download
docker run --rm -v /your/download/dir:/download mdx dl -o /download <url>
# Interactive download
docker run --rm -it -v /your/download/dir:/download mdx dl -o /download <url>

Also add useful alias for your sh:

alias containermdx="docker run --rm -it -v /your/download/dir:/download mdx"

It allows you to run mdx anywhere in your sh using the command containermdx

Usage examples️ 🖥️

Interactive downloading mode:

mdx dl -i

Demo of interactive mode:

demo

Note: Your manga title should be more than 5 characters when searching to avoid errors.

</div>

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 1 volume of manga
mdx dl -v 1 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 1 volume of manga and merge chapters in one file
mdx dl -m -v 1 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

Check available updates:

mdx update

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

FAQ 💬

Where can I get the manga link?

You 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.

Where can I get the chapter link?

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.

I can't download chapter X of manga X. Why?

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.

Why is downloading so slow?

I don't know. It's a problem on MangaDex's side or on your side.

I downloaded a chapter but the output filename doesn't have the volume number or chapter number. Why?

This problem stems from the uploader failing to specify the correct volume or chapter details.

Why do pages in the PDF have different sizes?

The size of each page in the PDF corresponds to the size of the image.

Getting error "Chapters x-y not found, try another range, language, translation group etc."

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

Mdx

Install / Use

README