webtoon-dl is a command-line tool designed for downloading webtoons from webtoon.com in PDF or CBZ formats. It provides users with a flexible and efficient way to manage their comic downloads directly from the terminal.
Key Features:
Supports downloading individual episodes or entire series.
Offers both PDF and CBZ output formats.
Allows specifying ranges of episodes for targeted downloads.
Provides options to customize the number of episodes per file.
Includes adjustable delays between requests to avoid rate limiting.
Audience & Benefit:
Ideal for comic enthusiasts, researchers, and anyone who prefers digital comics. Users benefit from a streamlined, automated process for downloading and organizing webtoons directly in their preferred formats. The tool is particularly beneficial for those seeking efficient, command-line-based solutions for managing large collections of webtoon content.
webtoon-dl can be installed via winget on Windows systems, ensuring easy setup for users familiar with CLI environments.
README
webtoon-dl
Download webtoon comics as PDF or CBZ using a terminal/command line.
Usage
# download single episodes
webtoon-dl ""
# download entire series, default 10 episodes per pdf
webtoon-dl ""
# download as cbz (default is pdf)
webtoon-dl --format cbz ""
# specify a range of episodes (inclusive on both ends)
webtoon-dl --min-ep=10 --max-ep=20 ""
# change the number of episodes per file, e.g. this would create 11 files
webtoon-dl --min-ep=10 --max-ep=20 --eps-per-file=1 ""
# download entire series into a single file (GENERALLY NOT RECOMMENDED)
webtoon-dl --eps-per-file=1000000 ""
# change the delay between requests (default is 1000ms) - NOTE: anything less than 1000ms may result in rate limiting
webtoon-dl --delay-ms=2000 ""
> [!IMPORTANT]
> The episode numbers specified in --min-ep and --max-ep will correspond to the URL parameter &episode_no=, which may be different from the episode number in the title
> [!IMPORTANT]
> Some terminal settings (e.g. Oh My Zsh) make it so pasted URLs will be automatically escaped.
> You want to EITHER surround your unescaped webtoon URL with double quotes (otherwise you'll get something like a "no matches found" error) OR leave the double quotes off escaped URLs.
> So either of these will work:
> - webtoon-dl "https://www.webtoons.com/.../list?title_no=123"
> - webtoon-dl https://www.webtoons.com/.../list\?title_no\=123
>
> But this won't work:
> - webtoon-dl "https://www.webtoons.com/.../list\?title_no\=123"
Installation
# homebrew
brew install robinovitch61/tap/webtoon-dl
# upgrade using homebrew
brew update && brew upgrade webtoon-dl
# windows with winget
winget install robinovitch61.webtoon-dl
# windows with scoop
scoop bucket add robinovitch61 https://github.com/robinovitch61/scoop-bucket
scoop install webtoon-dl
# windows with chocolatey
choco install webtoon-dl
# with go (https://go.dev/doc/install)
go install github.com/robinovitch61/webtoon-dl@latest
Alternatively, download the relevant binary for your operating system (MacOS = Darwin) from
the latest github release. Unpack/extract it, then move the
binary or .exe to somewhere accessible in your PATH, e.g. mv ./webtoon-dl /usr/local/bin.
Build from Source (Mac, Linux, Windows)
Clone this repo, build from source with cd && go build. This will create the executable (e.g. ) in the current directory.