Metadata-Version: 2.3
Name: webtoon-downloader
Version: 2.4.0
Summary: A fast scrapper ⚡ for downloading comics from the Webtoons platform.
Author: Ali Taibi
Author-email: Ali Taibi <zehinadev@gmail.com>
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Requires-Dist: beautifulsoup4>=4.12.2,<5
Requires-Dist: lxml>=6.0.2,<7
Requires-Dist: pillow>=12.0.0,<13
Requires-Dist: rich>=13.7.0,<14
Requires-Dist: furl>=2.1.3,<3
Requires-Dist: httpx[http2]>=0.28.1,<0.29
Requires-Dist: aiofiles>=25.1.0,<26
Requires-Dist: pymupdf>=1.27.1,<2
Requires-Dist: rich-click>=1.7.2,<2
Requires-Dist: dacite>=1.9.2,<2
Requires-Dist: httpx-retries>=0.4.0,<0.5
Requires-Python: >=3.10, <4.0
Project-URL: Documentation, https://zehina.github.io/Webtoon-Downloader/
Project-URL: Repository, https://github.com/Zehina/webtoon-downloader
Description-Content-Type: text/markdown

<br />
<p align="center">
  <h2 align="center">Webtoon Downloader</h2>
  <p align="center">
    A fast CLI for downloading chapters from Webtoons. ⚡📚
    <br />
    <br />
    <a href="https://github.com/Zehina/Webtoon-Downloader/issues">Report Bug</a>
    ·
    <a href="https://github.com/Zehina/Webtoon-Downloader/issues">Request Feature</a>
    ·
    <a href="https://zehina.github.io/Webtoon-Downloader/">View Docs</a>
  </p>
</p>

[![Release](https://img.shields.io/github/v/release/Zehina/webtoon-downloader)](https://github.com/Zehina/Webtoon-Downloader/releases)
[![Build status](https://img.shields.io/github/actions/workflow/status/Zehina/webtoon-downloader/main.yml?branch=master)](https://github.com/Zehina/webtoon-downloader/actions/workflows/main.yml?query=branch%3Amaster)
[![Commit activity](https://img.shields.io/github/commit-activity/m/Zehina/webtoon-downloader)](https://img.shields.io/github/commit-activity/m/Zehina/webtoon-downloader)
[![License](https://img.shields.io/github/license/Zehina/webtoon-downloader)](https://img.shields.io/github/license/Zehina/webtoon-downloader)

<p align="center">
  <img src="https://raw.githubusercontent.com/Zehina/Webtoon-Downloader/da001b7f9198a842610e09d3e45a31b0f5e0b9e9/docs/imgs/demo.svg">
</p>

## 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:

- [https://www.webtoons.com/](https://www.webtoons.com/)

## Quick Start 🚀

Requires Python `3.10+`.

Install with `uv`:

```bash
uv tool install webtoon_downloader
```

Or with `pipx`:

```bash
pipx install webtoon_downloader
```

Download a series:

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

Useful first commands:

```bash
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:

- [Documentation Home](https://zehina.github.io/Webtoon-Downloader/)

Useful pages:

- [Getting Started](https://zehina.github.io/Webtoon-Downloader/getting-started/)
- [CLI Guide](https://zehina.github.io/Webtoon-Downloader/cli/)
- [FAQ](https://zehina.github.io/Webtoon-Downloader/faq/)
- [Architecture](https://zehina.github.io/Webtoon-Downloader/architecture/)
- [Development](https://zehina.github.io/Webtoon-Downloader/development/)
- [API Reference](https://zehina.github.io/Webtoon-Downloader/modules/)

Repository copies of those docs:

- [docs/getting-started.md](docs/getting-started.md)
- [docs/cli.md](docs/cli.md)
- [docs/faq.md](docs/faq.md)
- [docs/architecture.md](docs/architecture.md)
- [docs/development.md](docs/development.md)
- [docs/modules.md](docs/modules.md)

## 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](docs/faq.md).

## 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:

- [Development Guide](docs/development.md)

## 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](LICENSE).

## Contact 📬

**Zehina** – [zehinadev@gmail.com](mailto:zehinadev@gmail.com)

Project links:

- [Repository](https://github.com/Zehina/Webtoon-Downloader)
- [Issues](https://github.com/Zehina/Webtoon-Downloader/issues)
- [Docs Site](https://zehina.github.io/Webtoon-Downloader/)
