https://github.com/robinovitch61/webtoon-dl
A webtoon comic downloader for the command line/terminal
https://github.com/robinovitch61/webtoon-dl
webtoon webtoon-crawler webtoon-downloader webtoons webtoons-downloader
Last synced: 8 months ago
JSON representation
A webtoon comic downloader for the command line/terminal
- Host: GitHub
- URL: https://github.com/robinovitch61/webtoon-dl
- Owner: robinovitch61
- License: mit
- Created: 2023-12-20T18:23:49.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2025-10-05T21:44:10.000Z (8 months ago)
- Last Synced: 2025-10-05T22:21:54.136Z (8 months ago)
- Topics: webtoon, webtoon-crawler, webtoon-downloader, webtoons, webtoons-downloader
- Language: Go
- Homepage:
- Size: 4.49 MB
- Stars: 55
- Watchers: 2
- Forks: 7
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# webtoon-dl
Download [webtoon](https://www.webtoons.com/en/) comics as PDF or CBZ using a terminal/command line.
## Usage
```shell
# 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](https://ohmyz.sh)) make it so pasted URLs will be [automatically escaped](https://github.com/ohmyzsh/ohmyzsh/issues/7632).
> 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
```shell
# 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](https://github.com/robinovitch61/webtoon-dl/releases). 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. `webtoon-dl`) in the current directory.