<img align="left" width="80" src="docs/logo.png" alt="comicMaker project app icon">

comicMaker

comicMaker is a command line tool which downloads Comics and Manga from various Manga and Comic sites and converts them into (lossless) pdf easily. This is for educational purpose only.

Don't overuse this script. It puts loads on their servers.
Support the developers of those websites by disabling your adblock on their site.
Advertisments pay for the website servers.

<p align="center"> <img src="docs/comiccharacters.jpg"> </p>

TL;DR :
step 1: Use "config.json" to enter desired comic book names, and from which chapter you want to download.  
step 2: Then enter following commands:  
        pip install -r requirements.txt
        python comicMaker.py

Table of Content

• Getting Started
  • Supported Sites
  • Find Comic Book Name
  • Configuring Downloads
• Dependencies Installation
  • Linux/Debian
  • Windows
  • Mac OS X
• Python Support
• Usage
  • Windows
  • Linux/Debian
• Features
  • Save Location
  • Working Principle
  • Resource Management
• Future Plans
  • Short Term
  • Long Term
• Known Bugs
• Changelog
• Opening An Issue/Requesting A Site
  • Reporting Issues
  • Suggesting A Feature
• License

<p align="center"> <img src="docs/bookStore.jpg"> </p>

Getting Started

Supported Sites

URL can be any URL of the supported websites.

| Supported Sites | Compatiability | |----------------------------- |---------------- | | https://readcomiconline.to | 100% | | https://readcomicsonline.ru | 100% | | https://www.comicextra.com | 100% | | https://mangalike.net | 90% |

How to find the book name

Go to the required book website and see the URL. Find the book name, usually just after the "http://mangalike.net/manga/" or "https://readcomiconline.to/Comic/" part. If you want to download from start put 1 in the chapter part in the config.json file.

Configuring download list

Find the file config.json. Inside there you can enter names of any books you want to download. And specify from which chapter you want to download. Here is an example:

+ Below is the content of "config.json" ->

{
    "mangaLike": {
        "chromosome-47" : "1",
        "haomen-tianjia-qianqi" : "35",
        "pulse" : "63"
        },
    "readComicOnlineTo": {
        "Civil-War-2006": "1",
        "Batman-The-Dark-Knight-Returns": "2",
        "X-Men-Origins-Jean-Grey": "1"
    },
    "readComicsOnlineRu": {
    
    },
    "comicExtra": {

    },
    "temporary library": {
        "tamen-de-gushi": "187",
        "otome-no-teikoku": "108.5"
    }
}  


+ This will download 6 books:
+ chromosome-47 , where downloads starts from chapter 1.
+ haomen-tianjia-qianqi , where download starts from chapter 35.
+ pulse , where download starts from chapter 63.
+ Civil-War-2006 , where download starts from chapter 1.
+ Batman-The-Dark-Knight-Returns , where download starts from chapter 2.
+ X-Men-Origins-Jean-Grey , where download starts from chapter 1.

- temporary library contains books that won't be downloaded by the program.

- Don't forget to put ',' between two books.

Dependencies Installation

This script can run on multiple Operating Systems. You need Node.js in your system's path for this script to work (You need this on each and every Operating System, even on WINDOWS :/).
Download the Node.Js from Node.js official website. Doesn't matter which operating system you're on, this is a must. Follow the instructions mentioned below, according to your OS.

Linux/Debian :

Since most (if not all) Linux/Debian OS come with python pre-installed, you don't have to install python manually. Make sure you're using python >= 3.5 though.

We need pip to install any external dependenc(ies). So, open any terminal and type in pip list and if it shows some data, then it is fine. But, if it shows error, like pip not found or something along this line, then you need to install pip. Just type this command in terminal :

sudo apt-get install python-pip

If you're on Fedora, CentOS/RHEL, openSUSE, Arch Linux, then you simply need to follow THIS TUTORIAL to install pip.

If this still doesn't work, then you'll manually need to install pip. Doing so is an easy one time job and you can follow THIS TUTORIAL to do so.

• Download this requirements.text file and put it in some directory/folder.
• Open terminal again and browse to the directory where you downloaded your requiremenets.txt file and run this command :

pip install -r requirements.txt

• It should install the required external libraries.

Windows :

If you're on windows, then follow these steps :

• Install Python >= 3.5. Download the desired installer from download Python.
• Add it in the system path (if not already added).
• Download this requirements.text file and put it in some directory/folder.
• Open Command Prompt and browse to the directory where you downloaded your requiremenets.txt file and run this command :

pip install -r requirements.txt

• It should install the required external libraries.

Now, install Node.Js as well and make sure it's in your path.

Well, if everything came up good without any error(s), then you're good to go!

Mac OS X :

Mac OS X users will have to fetch their version of Python and Pip.

• Python installation guide : Install python on mac os X
• Pip installation guide : Installing pip on mac os X

After downloading and installing these, you need to add PIP & Python in your path. Follow THIS LITTLE GUIDE to install both, Python & pip successfully.

Python Support

Supports python >= 3.5

Usage

Follow the instructions according to your OS :

Windows

After you've saved this script in a directory/folder, you need to open command prompt and browse to that directory and then execute the script. Let's do it step by step :

• Open the folder where you've downloaded the files of this repository.
• Hold down the SHIFT key and while holding down the SHIFT key, RIGHT CLICK and select Open Command Prompt Here from the options that show up.
• Now, in the command prompt, type this :

python comicMaker.py

<p align="center"> <img src="docs/terminal.gif" width="500"> </p>

Linux/Debian

After you've saved this script in a directory/folder, you need to open command prompt and browse to that directory and then execute the script. Let's do it step by step :

• Open a terminal, Ctrl + Alt + T is the shortcut to do so (if you didn't know).
• Now, change the current working directory of the terminal to the one where you've downloaded this repository.
• Now, in the Terminal, type this :

python comicMaker.py

Features

• This will download all the images from a chapter in a folder.
• Progressbar added for getting realtime downloading status.
• This will also create pdf for each chapters.
• This will merge all chapter pdfs into a single one as a full book after completing downloading each book.
• Added proxy support from Free Proxy List for anonymous downloading and to avoid getting banned.
• Used multithreading for parallel downloading.

Save Location

Comics will be saved on the same directory you clone this repository. Here is how:

-     --SomeDirectory (Where you cloned the repository)
        |--comicMaker
-       |  |--comicMaker
        |  |  |--__init__.py
        |  |  |--(and some necessary modules the program needs)
        |  |--requirements.txt
        |  |--.gitignore
        |  |--_config.yml
        |  |--comicMaker.py
        |  |--config.json
        |  |--readme.md
-       |--comicDownloads
        |  |--chromosome-47
        |  |--haomen-tianjia-qianqi