MangDL 1.0.1

The most inefficent Manga downloader for PC

▀▄▀▄▀▄ 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: mangdl.rf.gd

Downloads

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

Follow this link to install MangDL in your machine.

Important

This project is a work in progress, use at your own risk.

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.

Features

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

Supported OSes

• Windows
• MacOS
• Linux

Sites

• acescans.xyz
• danke.moe
• flamescans.org
• hachirumi.com
• mangadex.org
• manganato.com
• mangasushi.net
• paeanscans.com
• setsuscans.com

Coming soon™

• assortedscans.com
• bunko.ml
• deathtollscans.net
• mangapill.com
• mangareader.to
• mangarock.to
• web-ace.jp/youngaceup
• windyfall.com
• xunscans.xyz

Table of Contents

• Important
• 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: mangdl.rf.gd/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
    

  You should get a similar output like the following image:

  

• 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
    

  You should get a similar output like the following image:

  

• For Linux

  • p7zip

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

    7z --version
    

  You should get a similar output like the following image:

  

Setup

Follow this link to install MangDL in your machine.

TODO

Main to do

• Documentation

  • Bare-bones sites

  • Migrate every .md file to https://mangdl.github.io

• Library

  • Manga Update notifier

  • Backupable library with an option to store an offsite backup in supabase.io

• GUI

  • Reader

• MAL / Anilist sync

• Fully opt-in 99% configureable (mostly opinionated) analytics for new and some sampled features

Side Quests

• Installation instructions for Android users

• Package update notifier

• Saving command options to config file

• Submission of new color theme for the CLI and possibly for the future GUI

• Returning/Downloading translated languages using locale of the machine and an option to override it

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

_{NOTE: If a reference or source material is not attributed properly or not at all, please kindly message me at Discord: whi_ne#5135 or create a pull request so I can properly give credit to their respective authors.}