Skip to main content

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

Project description


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

  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 - zehinadev@gmail.com

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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

webtoon_downloader-1.0.1.tar.gz (26.7 kB view hashes)

Uploaded Source

Built Distribution

webtoon_downloader-1.0.1-py3-none-any.whl (35.3 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page