A webtoon comic downloader for the command line/terminal
Find a file
2024-01-14 18:51:46 -08:00
.github Release to chocolatey 2024-01-14 18:51:46 -08:00
.gitignore Release to chocolatey 2024-01-14 18:51:46 -08:00
.goreleaser.yaml Release to chocolatey 2024-01-14 18:51:46 -08:00
go.mod working 2023-12-21 08:38:48 -08:00
go.sum working 2023-12-21 08:38:48 -08:00
main.go Support "OZ Page" image links 2024-01-14 13:45:25 -08:00
README.md separate install and build in the readme 2024-01-06 22:02:06 -08:00

webtoon-dl

Download webtoon comics as PDFs using a terminal/command line.

Usage

# download single episodes
webtoon-dl "<your-webtoon-episode-url>"

# download entire series, default 10 episodes per pdf
webtoon-dl "<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) 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 (Mac, Linux)

brew install robinovitch61/tap/webtoon-dl

To upgrade the version installed with homebrew:

brew update && brew upgrade webtoon-dl

Download from Github (Mac, Linux, Windows)

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.

Using go installed on your machine (Mac, Linux, Windows)

go install github.com/robinovitch61/webtoon-dl@latest

Step by Step Windows Installation Instructions

  1. Check the processor type you're using by going to System Information and looking at Processor. Go to this page. If your Processor says "Intel" anywhere, download the file that ends in "Windows_i386.tar.gz" by clicking it. If it says "Arm", instead click the file that ends in "Windows_arm64.tar.gz".
  2. Once the file is downloaded to your Downloads folder, you have to unzip and extract it. If you use 7zip, you can right click the file and hit "7zip -> Extract here", then right click the ".tar" file that's created and hit "7zip -> Extract here" again. You should end up with a file called "webtoon-dl.exe" in your Downloads folder.
  3. If Windows thinks the .exe file is malware and deletes it automatically, you can prevent that by temporarily disabling "Real time protection" under "Virus & threat protection settings", following step 2 again to get back the .exe, then adding an exclusion for it. This isn't malware, it's just some code I wrote in go, with all the source code available here.
  4. Once you have the .exe in your Downloads and Windows isn't going to auto-remove it, you can open the Command Prompt:
    1. First, type cd Downloads and hit enter to get to your Downloads folder
    2. Now confirm that "webtoon-dl.exe" shows up in the output when you type dir and hit enter
    3. Setup is over!
  5. Still in the Command Prompt, now run, for example, webtoon-dl.exe "https://www.webtoons.com/en/slice-of-life/bugtopia/ep-8-a-special-gift/viewer?title_no=4842&episode_no=8". This will run and print what it's doing, then output a PDF file of that comic in your Downloads folder.

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. wander) in the current directory.