robinovitch61/webtoon-dl

A webtoon comic downloader for the command line/terminal

webtoon-dl

Download webtoon comics as PDF or CBZ 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>"

# 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) 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 <cloned_repo> && go build. This will create the executable (e.g. webtoon-dl) in the current directory.

webtoon-dl's Issues

Out of memory error trying to save a specific webtoon

Getting the following error while its adding pages:

runtime: out of memory: cannot allocate 4194304-byte block (1853358080 in use)
fatal error: out of memory

I've got 300gb free space and 64gb of ram so I don't think that's actually the issue. I pasted in more of the error if that helps.

error.txt

Unexpected EOF error

Hello, firstly, I want to thank you very much for this command! It worked well, sorting through the series but then I received an error "unexpected EOF". I am new to using codes and stuff so I couldn't figure out the problem. I used the prompt for an Indonesian webtoon version on Windows Terminal x64 and the latest version of webtoon-dl. I've tried running the prompt couple of times but the issue persist.

error.txt

Where do files save to?

Hello, thank you for your work, it seems to work but I can't find the files once it's finished :/
Could you help me?
thank you

Mac OS Darwin terminal no usage issue

Read and checkbox the following by putting an "x" in the brackets like - [x] before submitting this bug report:

• I have searched existing issues, opened and closed, for existing solutions to my problem
• I understand that I have to fill out all of the following or risk my issue being closed and locked

What you ran, all the output, and the entire error message, if any

<I downloaded the latest Darwin file and opened the dl file, when I did it said all was successful opening it but I cannot paste or type anything thus not allowing me to use the downloader. Did I do something wrong?>

Expected behavior
i thought I would be able to use this command: webtoon-dl --eps-per-file=1000000 "https://www.webtoons.com/en/canvas/its-them/list?title_no=386017&page=7"

or this one in case I got it wrong : webtoon-dl --eps-per-file=1000000 "https://www.webtoons.com/en/canvas/its-them/secret-trade/viewer?title_no=386017&episode_no=1"
in order to download the entire comic series onto a single file
Screenshots
.

Complete the following information:

• OS [e.g. Mac, Windows, Ubuntu, Arch, NixOS, etc.]:
• Version [e.g. v0.0.5]:
• Available space on disk [e.g. 10GB]:
• RAM [e.g. 8GB]:

Additional context
Add any other context about the problem here.

Fails with "image: unknown format"

From https://www.reddit.com/r/webtoons/comments/18nsej2/comment/ksi25ro/?utm_source=share&utm_medium=web2x&context=3

I've been getting this (https://ibb.co/bJL9Sf5) error message whenever I try to download a webtoon. The first 70 chapters downloaded fine, but it throws the same error after it gets partially through 70-80. I've tried adjusting the starting chapter to skip a few chapters, but it recieves the same error. Here's what I put in after changing it around: (https://ibb.co/b1HrJZr).

What I input:

webtoon-dl --min-ep=75 --max-ep=180 "https://www.webtoons.com/en/comedy/cursed-princess-club/list?title_no=1537"

Please help!

Thank you so much for making this tool! I really love it.

Add cbz output format option

From reddit:

Hoping for the cbz functionality in the future. This makes keeping things preserved easier, too.

Internet connection/unknown error

Whenever I try to download a webcomic using this, it gets all the episodes and then starts to get all the panels, but after a little it give me an error. I think it's a problem because there are too many panels for the program. This is the best program I found so far, so I hope you can find an answer!

No images found with some comics shown with "oz viewer"

From reddit:

I tried to download "Scroll If You Dare" from this link: https://www.webtoons.com/en/horror/scroll-if-you-dare/list?title_no=4784

After finished "scanning" it downloaded 3 corrupted PDF files. Can't open it with anything :(