▀▄▀▄▀▄ MangDL ▀▄▀▄▀▄

Manga Downloader

The most inefficient manga downloader for PC (and soon, also a reader)

❝

...but I don't think you'll write code valuable enough for them (Content creators and/or owners) to do that (file a DMCA strike against MangDL)

- KR

❝

whi_ne has good organization [skills] and bad code

- Arjix

Github: github.com/MangDL/MangDL

Website: mdl.pages.dev

To be updated, be sure to watch this repository and join the Discord Support Server for MangDL.

For the terms of usage and legals, visit license and terms of usage & disclaimer.

Downloads

Since people are looking for the download first, here you go:

Follow this link to install MangDL in your machine.

Features

• Ad free
• Batch downloading
• 0% tracking and analytics
• Can be used as a library

Supported OSes

• Windows
• MacOS
• Linux

Sites

For the full list of providers, visit this link.

Table of Contents

• Features
  • Supported OSes
• Sites
  • Coming soon™
• Table of Contents
• Usage
• Getting Started
  • Prerequisites
  • Setup
• Contributions
• Known Issues and Limitations
• Future of this project
• License
• Credits
  • Thank you
  • MIT Logo
  • Icons

Usage

Before using this project, it is recommended to visit license and terms of usage & disclaimer for the terms of usage, disclaimer, and legals.

mangdl -h

Downloading:

mangdl dl <title> [OPTIONS]

For programmatic use, visit the documentation: mdl.pages.dev/docs

Getting Started

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes.

Prerequisites

The following are the required programs and/or packages to run this project:

• For all operating systems:

  • Python 3.6 and higher

    To check that you have Python 3.6 and higher installed, in your preferred terminal, run the following command:

    python3 --version

  • pip (Package Installer for Python)

    To check that you have pip installed, in your preferred terminal, run the following command:

    pip3 --version

  • git

    To check that you have git installed, in your preferred terminal, run the following command:

    git --version

  

• For windows:

  • Chocolatey

    To check that you have Chocolatey installed, in your preferred terminal, run the following command:

    choco --version

  • 7zip

    To check that you have 7zip installed, in your preferred terminal, run the following command:

    7z --version

• For macOS:

  • Homebrew

    To check that you have Homebrew installed, in your preferred terminal, run the following command:

    brew --version

  • p7zip

    To check that you have p7zip installed, in your preferred terminal, run the following command:

    7z --version

• For Linux

  • p7zip

    To check that you have p7zip installed, in your preferred terminal, run the following command:

    7z --version

Setup

Follow this link to install MangDL in your machine.

TODO

Legend

• 🟢: Completed
• 🟡: In progress
• 🟠: Paused, not a priority
• 🔴: Yet to be done
• 🔵: Halted, considered completed despite not being done

• 🟢 Create portables

  • 🟢 Linux
  • 🟢 Windows
  • 🟢 MacOS (Not really satisfied with the solution)

• 🟡 Add features

  • 🔵 Saving command options to config file
  • 🔴 Submission of new color theme
  • 🔴 Returning/Downloading translated languages using locale of the machine (and an option to override it)
  • 🔴 Fully opt-in 99% configurable analytics (for new and some sampled features)

• 🟢 Create installables

  • 🟢 Linux
  • 🟢 Windows
  • 🟢 MacOS (Not really satisfied with the solution)

• 🟡 Documentation

  • 🟢 Bare-bones sites
  • 🟢 Migrate to https://mdl.pages.dev/
  • 🟢 Complete documentation
  • 🟢 Installation instructions
  • 🔴 Examples of programmatic usage

• 🔴 Library

  • 🔴 Manga Update notifier
  • 🔴 Backupable library (with an option to store an offsite backup in https://supabase.io/)
  • 🔴 MAL / Anilist sync

• 🟡 GUI

  • 🟡 Homepage
  • 🔴 Reader
  • 🔴 Backend

Contributions

You can contribute by creating a new issue, or by creating pull requests.

At the time of writing, there are no templates for both creating a new issue and pull requests.

The developer notes however that the said template will be created if a trend of users using this project is evident.

For creating a new issue, please make sure that the said issue is not on the list of closed and open issues.

After checking that that is the case, create a new issue.

The title of the issue must summarize its contents.

The body must contain the following:

• a clear description of the bug
• Python version used for running and/or testing the project
• OS name and version

Known Issues and Limitations

At the time of writing, this project can not be run in Termux due to a fatal error.

Also, something is broken and I don't know what is, 'cause I forgot!

Future of this project

The TODO will be done, except for that, nothing else.

License

MIT

Copyright for portions of project MangDL are held by [Github Account justfoolingaround Owner, 2021] as part of project AnimDL.

All other copyright for project MangDL are held by [Github Account whinee Owner, 2021].

Check the LICENSE for more details.

Credits

Thank you:

• To Arjix, who helped me in implementing majority of the features and de-minifying my code, making it more readable and more efficient at the same time
• To KR, who let me use the KR-naming scheme like "AnimDL" do
• To whi~nyaan, my alter ego, for just existing (and purring, ofc)
• And to everyone who supported me from the very beginning of this humble project to its release!

MIT Logo

Massachusetts Institute of Technology (vectorized by Mysid, modified by whinee), Public domain, via Wikimedia Commons

Icons

Exclamation Mark, Code Fork, Star, Group, Code, and Discord icons by Icons8