Release Note
5.12.1.post1 (2026-05-01)
이용약관과 개인정보처리방침이 신설되었습니다. WebtoonScraper 제품군 (WebtoonScraper 앱, CLI, 문서 사이트)에는 이제 이용약관과 개인정보처리방침이 적용됩니다.
이용약관과 개인정보처리방침은 WebtoonScraper 제품군을 사용하려면 동의해야 하므로 꼭 읽어보셨으면 합니다. 약관의 주요 골자는 보증의 부인과 통계 목적의 분석 정보 수집입니다.
약관에도 적혀 있지만 다시 한 번 강조하자면 WebtoonScraper는 통계 목적의 분석 정보가 아닌 개인정보(IP주소, 쿠키, bearer 등)는 절대 수집하지 않습니다. 또한 수집된 정보는 절대 제3자에게 공개되거나 판매되지 않습니다. 오로지 서비스 품질 향상과 통계적인 분석을 위해서만 활용됩니다.
- 리디북스의 API 변경에 대응했습니다.
- 이제 네이버 웹툰에서 다운로드가 되지 않을 웹툰들을 미리 확인합니다. 다운로드가 되지 않을 웹툰들은 이전처럼 다운로드를 시도한 뒤 실패하지 않고 스킵됩니다.
- 네이버 웹툰에서 다운로드받았던 댓글이 information.json에 있던 경우 그 값을 유지합니다.
- webtoon 뷰어가 개선되었습니다. information.json이 없어도 빌드되고 AppleDouble 파일이 있어도 포함하지 않습니다.
- 기타 작은 버그 수정과 개선
5.12.0 (2026-04-19)
- WebtoonScraper의 문서의 외관과 주소가 변경되었습니다. 이제 문서는 docs.wbtn.org에서 확인하실 수 있습니다.
- 웹툰 폴더 압축을 지원합니다. 이제 '디렉토리 압축하기'를 활성화하면 다운로드를 마친 뒤 폴더가 zip파일로 압축됩니다.
- 'webtoon.html 뷰어에 이미지 크기 계산하기' 기능: webtoon.html을 만들 때 이미지 크기 정보를 미리 계산해서 활용합니다. 이 기능을 키면 뷰어를 생성하는 시간은 늘어나지만 뷰어를 처음 불러올 때 레이아웃이 깨지는 현상을 개선할 수 있습니다.
- 웹툰 뷰어에서 스크롤 위치 수동 보존 기능: 보통의 브라우저들은 새로고침을 하더라도 스크롤 위치를 보존하기 때문에 웹툰 뷰어가 직접 스크롤 위치에 관여할 이유는 없습니다. 그러나 스크롤 위치를 수동으로 보정하고 싶은 경우 이 기능을 활용해 URL에 스크롤 위치를 보존할 수 있습니다. 이 기능을 켜려면 웹툰 뷰어의 URL에
&scroll=0을 추가하면 됩니다. Safari 기반 브라우저에서는 이 기능이 기본적으로 켜져 있습니다. - 일부 레진코믹스 웹툰의 이미지 품질이 개선되었습니다.
- snapshot은 이제 hash를 저장합니다. 기본 동작을 유지하려면
--no-hash를 사용하세요. - 기타 작은 개선 및 수정
5.11.1 (2026-03-21)
- 카카오페이지 사이트 변화 반영
- 레진코믹스 일본어 사이트가 앱에서 제대로 처리되지 않는 오류 수정
5.11.0 (2026-02-25)
- 타파스 지원 추가
5.10.4 (2026-02-13)
- 최신 크롬 버전이 아니더라도 쿠키 얻기 기능이 정상적으로 동작하도록 수정
- 네이버 블로그 다운로드시 더 높은 화질로 다운로드가 가능하도록 수정
5.10.3 (2026-01-29)
- 쿠키가 제대로 로드되지 않은 오류 해결
- 레진코믹스에서 이제 페이지 형식 만화 다운로드 지원
페이지 형식을 지원하는 만화의 경우 페이지 형식으로 다운로드하고 싶으신 경우 레진코믹스 웹툰 URL을 입력하고 "페이지 형식 다운로드 선호하기" 옵션을 켜 웹툰 형식으로 다운로드하는 대신 페이지 형식으로도 다운로드할 수 있습니다. * 봄툰에서 다운로드가 간헐적으로 작동하지 않는 문제 개선 * 다운로드를 다시 시작할 수 있는 버튼을 추가
오류로 인해 다운로드가 종료될 경우 이제 재시작 버튼을 눌러 다운로드를 다시 시도할 수 있습니다. * 그 외 다양한 작은 버그 수정과 개선
5.10.2 (2025-12-18)
- 레진코믹스에서 GIF 이미지가 셔플되지 않도록 수정
- '쿠키 얻기' 기능 안정화
5.10.1 (2025-11-25)
- 일부 사용자에게 다운로드 경로가 유지되지 않는 문제 해결
- 앱에서 오류가 발생했을 때 경고 메시지가 나타나도록 함
- 앱을 사용할 때 쿠키가 플랫폼마다 유지될 수 있도록 함
- 리디 라이브러리에서 여러 book_id가 있을 경우에 다운로드가 가능하도록 개선
이제 앱에서 쿠키를 특정 플랫폼에 입력하면 해당 쿠키 값이 해당 플랫폼에 종속되며, 플랫폼의 url이 확인되면 거기에 맞추어 값이 저장됩니다. 이 값은 플랫폼별로 관리되고 저장되며, 폼 데이터를 저장하면 다음에 프로그램을 열었을 때 쿠키가 플랫폼별로 유지됩니다.
5.10.0.post1 (2025-11-15)
- 레진코믹스 일본어 지원
- 네이버 웹툰에 always-refresh-comments 옵션 추가
- 이미지를 다운로드 시 문제가 발생했을 때 오류를 발생시키는 대신 경고를 출력
- (post1) always-refresh-comments의 역할 변경 및 GUI에 추가
- (post1) 레진코믹스 다운로드 오류 수정
- (post1) 다운로드 중 오류 발생할 경우 나타나는 방식 개선
5.9.1 (2025-11-11)
- 레진코믹스 1280p/1440p 지원
- 다양한 문서 개선
전반적으로 오래된 정보를 담고 있던 WebtoonScraper의 문서가 여러모로 개선되었습니다. 관심이 가신다면 한번 둘러보시는 것도 좋을 것 같습니다.
PyPI 버전에서 더이상 레진코믹스를 기본으로 제공하지 않습니다. 5.9.0 이하의 버전에서는 여전히 레진코믹스를 사용할 수 있습니다.
5.9.0 (2025-10-16)
- macOS에서 앱 지원 추가 (ARM 기반 맥 지원)
- 다운로드 경로가 override되는 문제 수정
- (5.8.2에서 추가됨) webtoon.html에서 다크 모드 지원
5.8.2 (2025-10-04)
- cookie 데이터를 json으로 입력 가능 (Get cookies.txt LOCALLY 등을 이용해서도 로그인 가능)
- 인텔 맥 지원 종료 (여전히
5.8.1.post1에서는 다운로드 및 사용 가능) - 쿠키 얻기 버튼이 동작하지 않는 버그 해결
- webtoon.html에서 다크 모드 지원
5.8.1.post1 (2025-09-02)
- 네이버 댓글 다운로드 오류 해결 및 개선
- 일부 정보가
information.json에 제대로 저장되지 않는 오류 해결 - 쿠키 가져오기를 실패했을 때 크롬 최신 버전을 설치하고 재시작했는지 확실하게 물음
- httpc 최대 지원 버전 상향
- 기타 다양한 버그 수정 및 개선
- (post1) option이 제대로 먹히지 않은 오류 수정
- (post2) PyPI 버전에서 CLI에 제대로 동작하지 않는 버그 수정
GitHub Actions가 인텔 맥OS 지원을 종료함에 따라, 이번 버전이 마지막으로 인텔맥을 지원하는 버전입니다. 앞으로는 macos-intel-installer.zip은 포함되지 않습니다.
5.8.0 (2025-08-06)
- 리디북스 확장 지원 (웹툰, E북, 라이브러리 지원)
- SSL 관련 오류 해결
5.7.7 (2025-07-27)
- 투믹스 문제 해결
- 콜백과 디렉토리 실행 방법 변경
5.7.6 (2025-07-04)
- 레진코믹스 라이브러리 (
https://www.lezhin.com/ko/library) 지원 쿠키 얻기버튼을 통해 앱에서 쿠키를 직접 붙여넣을 필요 없이 브라우저에서 로그인해 얻을 수 있음
5.7.5 (2025-07-02)
- 레진코믹스를 다운로드할 때 더 이상 bearer를 필요로 하지 않으며 cookie로 통합됨
- 앱에서 여러 웹툰을 한번에 다운로드할 수 있음
- callback이 작동하는 방식이 크게 변경됨
- 기타 다양한 버그 수정과 리팩토링
5.7.3 (2025-06-19)
- App: 봄툰 확장 지원
- App: 레진코믹스 관련 사이트 변화 반영
- App:
unshuffle-immediately옵션 추가 (기본값; 기존 방식처럼shuffled폴더를 별도로 유지하고 싶은 경우--option unshuffle-immediately=false인자를 추가해야 합니다) - All: 여러 웹툰을 다운로드할 때 오류를 무시할 수 있는
--suppress-error-on-batch추가 - All: 이전 다운로드에서 특정한 상태를 가졌던 에피소드를 다운로드하지 않는
--skip-status인자 추가
5.7.2 (2025-05-23)
- App: 레진코믹스 확장 지원
5.7.1 (2025-05-21)
- App: 재담쇼츠 확장 지원
5.7.0 (2025-04-30)
- App: 재담쇼츠 지원 추가
- App: 투비컨티뉴드 지원 추가
- Portable(post1): cli와 포터블 관련 로직 정리 및 버그 수정
5.6.0 (2025-04-26)
- App: 봄툰 지원 추가
- App: (2025년 4월 30일 네이버 포스트 서비스 종료)로 인해 네이버 포스트 지원 중단
5.5.1 (2025-04-22)
- App: 투믹스 확장 지원
- Dev: 문서 개선
- Dev: simplebuilder 사용 중단
- App(post1): 투믹스 더욱 확장해 지원
5.5.0 (2025-04-19)
- All: 웹툰과 에피소드 디렉토리 이름을 변경할 수 있는
--webtoon-dir-name,--episode-dir-name파라미터 추가 - PyPI: 파이썬 3.11에서 작동하도록 수정
- App: 웹툰 앱 설치 파일 제공 (윈도우)
- App: 폼 데이터 기본값 저장 가능하도록 함
- App: 웹툰과 에피소드 디렉토리 이름을 변경할 수 있는 필드 추가
5.4.1 (2025-03-28)
- 카카오페이지 사이트 변화 반영
- 투믹스 확장 지원
5.4.0 (2025-03-20)
- 투믹스 글로벌(
https://global.toomics.com/en) 모든 언어 지원 Support downloading webtoons from toomics global (every languages) - 리디와 투믹스 성인 웹툰 지원
- 문서 개선 및 과거 문서 정리
- 많은 API 개선 (async_callback, 예외 이름, progress bar, ...)
5.3.0 (2025-02-28)
- 레진코믹스 다른 언어(영어, 일본어)도 다운로드 지원. Support downloading webtoons from languages other than korean (English, Japanese) on Lezhin. Lezhin 英語, 日本語 支援.
- 탑툰 지원 추가
5.2.2 (2025-02-08)
- 브라우저 API 변화로 인한 폴더 선택 오류 해결
- 앱의 외양 개선
5.2.1 (2025-01-30)
- 이만배 지원
- 인텔 맥 지원 추가
- portable 코드에 인자를 주어 바로 사용 가능하게 함 ('설치' 문서의 '직접 사용하기' 문단 참고)
- 셸 메시지 개선
- 오래된 과거 문서 일부 제거
- 기타 코드 및 문서 개선
5.1.1 (2025-01-17)
- 리디북스 지원 확장
webtoons.com사이트 변경 대응--option관련 처리 개선- 문서 보강
- 기타 크고 작은 버그 수정 및 개선
5.1.0 (2024-01-08)
- 리디북스 지원
- 레진코믹스에서 경고 이미지 다운로드 생략
- 이전 상수를 이용한 방식에서 DirectoryState를 사용하는 방식으로 변경 (fieldenum 의존성 추가)
- 웹툰 뷰어 시작 시 오류가 나는 문제 해결
- 기타 버그 수정 및 기능 개선
5.0.3 (2024-12-31)
- 네이버 웹툰 오디오 다운로드 지원
5.0.2 (2024-12-27)
- 레진코믹스 관련 변경 사항 반영
--excluding옵션 추가 (TODO: 관련 문서 추가 필요)- 이미지 높이 관련 기능 개선
- 카카오페이지 관련 변경 사항 반영
- 기타 크고 작은 버그 수정 및 개선
5.0.1 (2024-12-10)
- https://webtoonscraper.readthedocs.io/로 문서 위치 변경
- 기타 크고 작은 버그 수정
5.0.0 (2024-11-11)
--options를--option으로 변경하고 사용하는 방식 변경 (문서 참고) 및 관련 버그 수정(post1)- 다양한 성능 개선, 특히 레진코믹스 다운로드 시 성능이 크게 개선됨
- 의존성 변경
- 기타 버그 수정 및 개선
5.0.0a1
- 진행 표시줄로 tqdm 대신 rich.progress 사용
- hxoptions 대신 client 사용 -- 속도가 상당히 개선됨
- 코드의 다양한 부분에서 async 사용
- NaverWebtoonScraper가 더 이상 웹툰 타입에 따라 분할되지 않음.
- hxsoup와 tqdm 의존성을 버리고 httpc 의존성 추가
- download_range에 임의의 컨네이너를 사용할 수 있도록 허용; 이제는 간단한 케이스에 대해
range(1, 11)과 같이 사용하는 것이 가능해짐 - import pillow eagerly
- 파일 확장차 추론 메커니즘 개선
- Scraper의 문서 개선
- 기타 크고 작은 버그 수정과 기능 개선
4.5.0 (2024-10-19)
- (plus) 스냅샷 기능 추가 (webtoon snap)
- pillow 필수 의존성으로 변경
- ctrl+C로는 셸 나가지 못하도록 함; ctrl+D(UNIX)나 ctrl+Z then Enter(윈도우) 사용 가능
- webtoons.com 스크래퍼 개선
- 기타 오류 수정 및 개선
- (실험적) readthedocs 문서 추가
- Scraper.download_status 추가
4.4.1 (2024-09-25)
- 카카오페이지 유료 회차 다운로드 지원
4.4.0 (2024-09-24)
- 앱 가이드와 실행 파일 가이드 등 문서 대폭 개정
- 투믹스 지원
- 버그 수정 및 리팩토링
4.3.0 (2024-09-17)
- 안정화 및 GUI 출시
4.2.0 (2024-09-11)
- 레진코믹스 사이트 변화 반영
- processing 서브모듈 통합
4.1.2 (2024-09-10)
- 레진코믹스 사이트 변화 반영
4.1.1 (2024-09-08)
- 레진코믹스 사이트 변화 반영
- 패키지 관리자로 uv 사용 (yay!)
- 스크래퍼가 자동으로 스크래퍼에 등록하도록 변경
- 스크래퍼 모듈 이름 변경
- (post1): 실행이 되지 않는 버그 수정
- (post2): 파이썬 3.10/3.11에서 실행되도록 변경
4.1.0 (2024-09-05)
- 스크래퍼 가용성 변화
- furl 대신 yarl 사용
- EpisodeRange 개선
- 문서 및 코드 개선