webtoon-dl

단일 에피소드 다운로드

웹툰 에피소드 URL을 입력하여 해당 에피소드만 PDF 또는 CBZ 형식으로 다운로드할 수 있습니다.

전체 시리즈 다운로드

웹툰 시리즈 URL을 입력하면 기본값으로 10화씩 묶은 PDF 파일을 생성하여 다운로드받을 수 있습니다.

형식 선택

–format cbz 옵션을 사용하여 PDF 대신 CBZ 형식으로 다운로드할 수 있습니다.

에피소드 범위 지정

–min-ep와 –max-ep 옵션을 사용하여 특정 에피소드 범위만 다운로드할 수 있습니다.

파일당 에피소드 수 조정

–eps-per-file 옵션을 사용하여 하나의 파일에 포함될 에피소드 수를 조정할 수 있습니다. 예를 들어 –eps-per-file=1 로 설정하면 에피소드별로 개별 파일이 생성됩니다.

다운로드 간격 조절

–delay-ms 옵션을 사용하여 요청 간 지연 시간을 밀리초 단위로 설정할 수 있습니다. 기본값은 1000ms이며, rate limiting을 방지하기 위해 이 값을 증가시킬 수 있습니다.

다운로드·설치 방법

Windows 사용자는 다음 방법 중 하나로 webtoon-dl을 설치할 수 있습니다:

• winget을 사용하는 경우: winget install robinovitch61.webtoon-dl
• scoop을 사용하는 경우: 먼저 scoop bucket add robinovitch61 https://github.com/robinovitch61/scoop-bucket 를 실행한 후 scoop install webtoon-dl 명령을 실행합니다.
• Chocolatey를 사용하는 경우: choco install webtoon-dl 명령을 실행합니다.
• Homebrew를 사용하는 경우 (Windows용 WSL 또는 기타 환경): brew install robinovitch61/tap/webtoon-dl
• Go를 사용하는 경우: go install github.com/robinovitch61/webtoon-dl@latest
• 수동 설치: GitHub 릴리스 페이지에서 운영체제에 맞는 바이너리를 다운로드한 후 압축을 풀고, 실행 가능한 파일을 PATH에 등록된 디렉터리로 이동시킵니다.

기본 사용법

설치 후 터미널 또는 명령 프롬프트에서 다음 예시와 같이 webtoon-dl을 사용할 수 있습니다:

• 단일 에피소드 다운로드: webtoon-dl ""
• 전체 시리즈 다운로드 (기본 10화당 PDF): webtoon-dl ""
• CBZ 형식으로 다운로드: webtoon-dl --format cbz ""
• 에피소드 범위 지정 (10화부터 20화까지): webtoon-dl --min-ep=10 --max-ep=20 ""
• 파일당 1화씩 생성: webtoon-dl --min-ep=10 --max-ep=20 --eps-per-file=1 ""
• 요청 간격 2초로 설정: webtoon-dl --delay-ms=2000 ""

중요: URL에 특수 문자가 포함된 경우, 터미널 설정에 따라 따옴표 사용 여부가 달라질 수 있습니다. 예를 들어, webtoon-dl "https://www.webtoons.com/.../list?title_no=123" 또는 webtoon-dl https://www.webtoons.com/.../list?title_no=123 형태 중 하나가 작동하지만, webtoon-dl "https://www.webtoons.com/.../list?title_no=123" 형태는 작동하지 않을 수 있습니다.

이런 경우에 유용합니다

웹툰을 오프라인에서 보고 싶은 사용자에게 유용합니다. 특히 시리즈 전체를 PDF 또는 CBZ 형식으로 저장하여 독서 앱이나 전자책 리더에서 편리하게 감상하고자 할 때 적합합니다. 다운로드 간격 조절 기능을 통해 서버 과부하를 방지하면서 안정적으로 대량 다운로드를 수행할 수 있습니다.