webtoon_downloader 1.0.0

A fast scrapper ⚡ for downloading comics from the Webtoons platform.

Webtoon Downloader

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

Report Bug · Request Feature

Contents

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

Supported Sites

• https://www.webtoons.com/

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

1. Clone the repo

   git clone https://github.com/Zehina/Webtoon-Downloader.git
   

2. Navigate to the project folder

   cd Webtoon-Downloader
   

3. Install this module in the system and generate a webtoon-downloader console-script for easier usage

   pip install .
   

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 - [e-mail]

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.