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 details)

Uploaded Source

Built Distribution

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

Uploaded Python 3

File details

Details for the file webtoon_downloader-1.0.1.tar.gz.

File metadata

  • Download URL: webtoon_downloader-1.0.1.tar.gz
  • Upload date:
  • Size: 26.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.7.1 CPython/3.12.1 Linux/6.2.0-1018-azure

File hashes

Hashes for webtoon_downloader-1.0.1.tar.gz
Algorithm Hash digest
SHA256 aea8044e635e1f270be08739850d04dcdfdbfab3112bf071f55c1291bca8b08a
MD5 22b16484621acf467edaded86d7c7ab4
BLAKE2b-256 b8aafaea530012427e77531cabc9facce2112aafb7e1546c74b941fa012303f9

See more details on using hashes here.

File details

Details for the file webtoon_downloader-1.0.1-py3-none-any.whl.

File metadata

File hashes

Hashes for webtoon_downloader-1.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 f44ec61d88c7de89d04c52e48793f69b2fda85fa75754cfb70fe8fb9ee773826
MD5 883db2c007e91a19813551c3bea0d6bb
BLAKE2b-256 1fd21d5f607a040b6e431c8c74ff1da3b08cc3a375985348937ac621d1a7bddc

See more details on using hashes here.

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