webtoon-dl-gif-support/README.md
2023-12-29 13:35:42 -08:00

3.8 KiB

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
webtoon-dl "<your-webtoon-series-url>"

# create single pdfs from a range of episodes (inclusive)
webtoon-dl --min-ep=10 --max-ep=20 "<your-webtoon-series-url>"

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

Build from Source (Mac, Linux, Windows)

Clone this repo, build from source with cd <cloned_repo> && go build, then move the binary to somewhere accessible in your PATH, e.g. mv ./webtoon-dl /usr/local/bin.

Step by Step Windows 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.