70 lines
2.5 KiB
Markdown
70 lines
2.5 KiB
Markdown
# 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 "<your-webtoon-episode-url>"
|
|
|
|
# download entire series, default 10 episodes per pdf
|
|
webtoon-dl "<your-webtoon-series-url>"
|
|
|
|
# download as cbz (default is pdf)
|
|
webtoon-dl --format cbz "<your-webtoon-series-url>"
|
|
|
|
# specify a range of episodes (inclusive on both ends)
|
|
webtoon-dl --min-ep=10 --max-ep=20 "<your-webtoon-series-url>"
|
|
|
|
# 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 "<your-webtoon-series-url>"
|
|
|
|
# download entire series into a single file (GENERALLY NOT RECOMMENDED)
|
|
webtoon-dl --eps-per-file=1000000 "<your-webtoon-series-url>"
|
|
```
|
|
|
|
> [!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 <cloned_repo> && go build`. This will create the executable (e.g. `webtoon-dl`) in the current directory.
|
|
|