Skip to main content

Manga scraper

Project description


Search & download mangas from the command line.


Requires Python3.7+

To install:

pip3 install --user MangaReaderScraper

For development:

git clone
pip install -r MangaReaderScraper/dev_requirements.txt
export PYTHONPATH=$PYTHONPATH:/path/to/MangaReaderScraper/


--search Search for a given query and select to download one of the mangas from the parsed searched results.
--manga Manga series name to download.
--volumes Manga series volume number to download.
--filetype Format to store manga as {PDF/CBZ}.
--output Directory to save downloads (defaults to ~/Downloads)
--source Website to scrape from {mangareader/mangafast} - mangakaka not longer works
--upload Upload mangas to a cloud storage service
--override_name Change manga name used to store volume(s) locally or in the cloud
--remove Delete the manga(s) after they have downloaded & uploaded


The default config file lives in $HOME/.config/mangascraper.ini and is as below:


# directory to save downloaded files to
manga_directory = /home/dir/Download

# default website to download from
source = mangareader

# defaulta filetype to store mangas as
filetype = pdf

# root cloud directory to upload the manga to
upload_root = /



Follow this guide to create a token. Then place the token into your config (~/.config/mangarscraper.ini):

token = hdkd87799jjjj


Add your email and password to the config file:

email =
password = notapassword123


Add you email and password to the config file:

email = email@email.con
password = notapassword123

Example Usage

After using the search function, a table will appear and you will be asked to select a specific manga (type a number in the first column). You will subsequently be asked to download a specific volume. In the example below, Dragon Ball Super volume 1 has been selected for download.

$ manga-scraper --search dragon ball

|    | Title                           |   Volumes | Type   |
|  0 | Dragon Ball: Episode of Bardock |         3 | Manga  |
|  1 | Dragon Ball SD                  |        20 | Manga  |
|  2 | DragonBall Next Gen             |         4 | Manga  |
|  3 | Dragon Ball                     |       520 | Manga  |
|  4 | Dragon Ball Z - Rebirth of F    |         3 | Manga  |
|  5 | Dragon Ball Super               |        29 | Manga  |
Select manga number

>> 5

Dragon Ball Super has been selected for download.
Which volume do you want to download (Enter alone to download all volumes)?

>> 1-25 33 56

To download a manga directly:

# Download all Dragon Ball volumes & upload to dropbox
manga-scraper --manga dragon-ball --upload dropbox

# Download volume 2 of the Final Fantasy XII manga
manga-scraper --manga final-fantasy-xii --volumes 2

# Download Dragon Ball Super volumes 3-7 & 23
manga-scraper --manga dragon-ball-super --volumes 3-7 23

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for MangaReaderScraper, version 0.51
Filename, size File type Python version Upload date Hashes
Filename, size MangaReaderScraper-0.51.tar.gz (27.9 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page