mxdownloader

A command line tool, utilizing the mangadex.org api you can download single, list, range or all chapters of a given manga.

Compatibility

Windows: In Progress

Linux: Ok

Mac: Error msg may appear during the download process but the download should go through regardless. This is on my list of things to work on going forward.

As of 12/17/24

Installation

You will need to have python installed.

Install: pip install mxdownloader

Run: mdx

View Project on PyPi

Manual Install

• Clone repo: git clone https://github.com/Hiro427/mxdownloader.git /path/to/directory

• Navigate to the project directory: cd path/to/project

• Install the requirements: pip/pip3 install -r requirements.txt

• Run: cd into mxdownloader/mxdownloader: python/python3 -m mxdownloader.mdx

Main Menu

The main functionality is the same for the program whether you decide to copy and paste the url from mangadex or to search from the CLI.

PLEASE NOTE: The URL must be the manga url not the inidividual chapter url.

Using the CLI

You have two ways to download for every option, either the cli or the interactive cli.

In the interactive version, vim keys can be used to navigate in main menu and the download options menu.

Vim Keys CANNOT be used when selecting multiple in the list view as the keystrokes will register in the fuzzy finder

Downloading All Chapters

Download Range of Chapters

Download Selected Chapters

As I said above VIM keys CANNOT be used here as the program will register them as part of the search. In this menu you will need to use up or down arrows to navigate in addition to the fuzzy finder.

You can type the chapter title or number, pressing enter adds that chapter to the list of the ones you wish to download.

You can then press continue to begin downloading.

Config File

View Config File info

Usable without config file: Default to ~/Downloads/Manga

The location of the config file is hard coded by default to be ~/config/mxcli/config.ini. I will add functionality in the program so that it can be changed from the cli. But for now if you want to change the default download directory create the config file.

Example Config File:

Acknowledgements

Scanlation Groups: https://www.reddit.com/r/mangadex/comments/mafhtl/scanlation_sites_megathread/

I couldn't find a reliable way to get all of the scanlation groups, since this program allows downloading any chapter(s), I wanted to give credit to as many groups as possible.

If a group's name is not in this thread or would like me to post there links in the readme or in the wiki (not active atm, but I would make it for this) more directly please let me know via the Issues section.

MangaDex API: https://api.mangadex.org/docs/

Credits the devs at MangaDex for their work in making this api available to everyone.