Skip to content

Zehina/Webtoon-Downloader

Repository files navigation


Webtoon Downloader

A fast CLI for downloading chapters from Webtoons. ⚡📚

Report Bug · Request Feature · View Docs

Release Build status Commit activity License

What It Does 🌐

Webtoon Downloader downloads public Webtoons series and saves them as:

  • image folders
  • ZIP archives
  • CBZ archives
  • PDFs

It also supports metadata export, image quality selection, retry strategies, proxies, and async downloads with progress reporting.

Supported site:

Quick Start 🚀

Requires Python 3.10+.

Install with uv:

uv tool install webtoon_downloader

Or with pipx:

pipx install webtoon_downloader

Download a series:

webtoon-downloader "https://www.webtoons.com/en/.../list?title_no=..."

Useful first commands:

webtoon-downloader [url] --latest
webtoon-downloader [url] --start 10 --end 25
webtoon-downloader [url] --save-as cbz
webtoon-downloader [url] --out ./downloads --separate
webtoon-downloader [url] --export-metadata --export-format json
webtoon-downloader [url] --proxy http://127.0.0.1:7890 --concurrent-pages 5
webtoon-downloader [url] --debug

Run webtoon-downloader --help for generated CLI help.

Documentation 📚

Full docs site:

Useful pages:

Repository copies of those docs:

Known Limitations ⚠️

Some failures are outside the project’s control:

  • Webtoons rate limiting and slow CDN responses
  • Daily Pass and app-only chapter access
  • upstream site markup or API changes

If you want details and workarounds, read the FAQ.

Contributing 🤝

Contributions are welcome.

Typical flow:

  1. Fork the repo
  2. Create a branch
  3. Make your changes
  4. Run checks
  5. Open a pull request

Contributor docs:

Disclaimer ⚠️

This tool is intended for personal and educational use only. You are responsible for how you use it, including compliance with the terms of service of the websites involved.

License 📄

Distributed under the MIT License. See LICENSE.

Contact 📬

Zehinazehinadev@gmail.com

Project links: