Skip to content

Zehina/Webtoon-Downloader

Repository files navigation


Webtoon Downloader

A simple tool for downloading chapters of any releases hosted on the webtoons website.

Report Bug · Request Feature

Release Build status codecov Commit activity License

Contents

  1. Supported Sites
  2. Getting Started
  3. Usage
  4. Contributing
  5. License
  6. Contact
  7. Built With

Supported Sites

Getting Started

To get a local copy up and running follow these simple steps.

Compatibility

Webtoon Downloader is supported on Windows, Linux & OSX. The minimum python version required is: 3.8

Installation

Install via pip or pipx

pip install webtoon_downloader

Usage

  • Downloading all chapters of a given title.

    $ webtoon-downloader "www.webtoons.com/en/.../.../list?title_no=...&page=1"
  • Downloading all released chapters starting from chapter 10 until the last released chapter.

    $ webtoon-downloader [url] --start 10
  • Downloading all released chapters until chapter 150.

    $ webtoon-downloader [url] --end 150
  • Downloading all released chapters between chapter 35 and chapter 67, inclusive of both of these chapters.

    $ webtoon-downloader [url] --start 35 --end 67
  • Downloading only the latest released chapter using either -l or --latest.

    $ webtoon-downloader [url] --latest
  • You can change the format of the downloaded pictures with the --images-format argument

    $ webtoon-downloader [url] --images-format 'png'
  • By default, the downloaded chapters will be stored under the current working directory with the folder name [series_title]. For example, downloading Tower of God, Chapter 150 would result in the following: ps Tower_of_God │--150_001.jpg │--150_002.jpg │--150_003.jpg │...

  • In order to download these images into a different folder, you can use the --dest optional argument.

    $ webtoon-downloader [url] --dest ./path/to/parent/folder/of/downloaded/images
  • The downloaded images of the chapters are by default all located in the [dest], however these images can be separated into separate directories by providing the --separate argument, where each directory corresponds to a downloaded chapter.

    $ webtoon-downloader [url] --separate

    For example, downloading Tower of God, Chapter 150 to 152 would result in the following:

    Tower_of_God
        │150
            │--150_001.jpg
            │--150_002.jpg
            │--150_003.jpg
            │...
        │151
            │--151_001.jpg
            │--151_002.jpg
            │--151_003.jpg
            │...
        │152
            │--152_001.jpg
            │--152_002.jpg
            │--152_003.jpg
            │...
  • You can additionally export the summary, chapter-title and author-notes into text files. You can select the format for the output as either JSON (default) or plain text files or both. ps $ webtoon-downloader [url] --export-texts [--export-format <json|text|all>]

For more details on positional arguments, please use the -h or --help argument:

webtoon_downloader --help

Contributing

Any contributions you make are greatly appreciated.

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

License

Distributed under the MIT License. See LICENSE for more information.

Contact

Zehina - [email protected]

Project Link: https://github.com/Zehina/Webtoon-Downloader

Built With

  • Rich Amazing and beautiful text formatting in terminals.
  • Webtoons For the accessibility to thousands of free comics.