Retrieves and deobfuscates manga pages for an input chapter id. Manga pages can be saves the dual spread images as well as single page images. Chapter ids need to be retrieved from the Viz site by looking at the chapter url.
DISCLAIMER: I am not licensed or affiliated with Viz Media and this repository is meant for informational purposes only. Please delete the retrieved pages after reading.
pip install viz_manga
The VizMangaDetails class can be used to lookup series and chapter metadata and the VizMangaFetch class is used to actually get the chapter pages.
To get all the series that are publicly available:
from viz_manga import VizMangaDetails, VizMangaFetch
details: VizMangaDetails = VizMangaDetails()
series: List[Series] = details.get_series()
To get all the chapters that are publicly free for a series:
series: Series = Series(None, "one-piece")
details: VizMangaDetails = VizMangaDetails()
for chapter in details.get_series_chapters(series):
if chapter.is_free:
print(chapter)
To get all pages for a chapter:
viz: VizMangaFetch = VizMangaFetch()
viz.save_chapter(24297, "images/", combine=True):
This module is bundled with a CLI script viz-manga-cli that allows the user to lookup and get chapters without writing any code.
usage: viz-manga-cli [-h] {fetch,series,chapters} ...
Lookup Viz manga information.
positional arguments:
{fetch,series,chapters}
fetch Fetches and deobfuscates an entire manga chapter for reading.
series Get series title and slug (for chapter lookup) obtained from the Viz site.
chapters Get chapter title and id obtained from the Viz site.
options:
-h, --help show this help message and exit
>>> viz-manga-cli series
{'name': '7thGARDEN', 'slug': '7th-garden'}
{'name': 'Agravity Boys', 'slug': 'agravity-boys'}
{'name': 'Akane-banashi', 'slug': 'akane-banashi'}
{'name': "Akira Toriyama's Manga Theater", 'slug': 'akira-toriyamas-manga-theater'}
{'name': 'All You Need is Kill', 'slug': 'all-you-need-is-kill-manga'}
{'name': 'Assassination Classroom', 'slug': 'assassination-classroom'}
>>> viz-manga-cli chapters --help
usage: viz-manga-cli chapters [-h] [--free] series_slug
positional arguments:
series_slug Series title for which to lookup chapter ids from the Viz site.
options:
-h, --help show this help message and exit
--free Only show publicly available free chapters for the series.
>>> viz-manga-cli chapters 7th-garden
{'title': 'ch-1', 'id': '15220', 'link': 'https://www.viz.com/shonenjump/7th-garden-chapter-1/chapter/15220', 'is_free': True}
{'title': 'ch-2', 'id': '15221', 'link': 'https://www.viz.com/shonenjump/7th-garden-chapter-2/chapter/15221', 'is_free': True}
{'title': 'ch-3', 'id': '15222', 'link': 'https://www.viz.com/shonenjump/7th-garden-chapter-3/chapter/15222', 'is_free': True}
{'title': 'ch-4', 'id': '15223', 'link': 'https://www.viz.com/shonenjump/7th-garden-chapter-4/chapter/15223', 'is_free': False}
{'title': 'ch-5', 'id': '15224', 'link': 'https://www.viz.com/shonenjump/7th-garden-chapter-5/chapter/15224', 'is_free': False}
>>> viz-manga-cli fetch --help
usage: viz-manga-cli fetch [-h] [--directory DIRECTORY] slug
positional arguments:
slug Chapter id or series name obtained from the Viz site.
options:
-h, --help show this help message and exit
--directory DIRECTORY
Output directory to save the deobfuscated pages.
>>> viz-manga-cli fetch 15220 --directory images/
INFO:root:Getting 79 pages for Root 1: The Demon's Servant
Successfully retrieved chapter 15220
IMPORTANT: This is for reading purposes only, please delete after reading.
If a series slug is specified for fetch, it will try to retrieve all free chapters of the series, placing each chapter into it's own sub-directory. If a directory folder already exists for the chapter, the cli will skip that chapter.
>>> viz-manga-cli fetch one-piece --directory images/
INFO:root:Getting 18 pages for One Piece Chapter 1049.0
INFO:root:Successfully retrieved chapter ch-1049 at: images/ch-1049
INFO:root:Getting 18 pages for One Piece Chapter 1048.0
INFO:root:Successfully retrieved chapter ch-1048 at: images/ch-1048
INFO:root:Getting 20 pages for One Piece Chapter 1047.0
INFO:root:Successfully retrieved chapter ch-1047 at: images/ch-1047
INFO:root:Successfully retrieved chapter ch-3 at: images/ch-3
INFO:root:Getting 25 pages for Chapter 2: They Call Him “Straw Hat Luffy”
INFO:root:Successfully retrieved chapter ch-2 at: images/ch-2
INFO:root:Getting 55 pages for Chapter 1: Romance Dawn
INFO:root:Successfully retrieved chapter ch-1 at: images/ch-1
>>> docker build -t viz-manga .
>>> docker run -v /home/user/images/:/app/images viz-manga fetch 24297 --directory images/
INFO:root:Getting 20 pages for One Piece Chapter 1047.0
Successfully retrieved chapter 24297