ebook_scanner

Windows에서 전자책 뷰어 화면을 자동으로 넘기며 캡처하고, 캡처 결과를 하나의 PDF로 저장하는 데스크톱 도구입니다.

한눈에 보기

구분	내용
대상 환경	Windows 데스크톱
실행 방식	PySide6 GUI
입력값	캡처 영역, 페이지 수, PDF 이름, 저장 폴더, 페이지 넘김 키
출력값	PDF 파일
보조 출력	선택 시 원본 PNG 캡처 파일 보관

바로 다운로드

Python을 설치하지 않고 실행 파일만 받아서 사용할 수 있습니다.

ebook_scanner.exe 다운로드

다운로드 후 ebook_scanner.exe를 실행하면 됩니다. Windows에서 알 수 없는 게시자 경고가 표시될 수 있습니다.

동작 흐름

1. 사용자가 전자책 뷰어에서 캡처할 영역을 지정합니다.
2. 프로그램이 지정한 키로 페이지를 넘깁니다.
3. 각 페이지를 같은 영역 기준으로 캡처합니다.
4. 캡처 파일을 순서대로 PDF로 변환합니다.
5. 설정에 따라 원본 캡처 파일을 삭제하거나 보관합니다.

기능

기능	설명
영역 지정	좌측상단/우측하단 좌표를 클릭해서 캡처 범위를 정합니다.
문서 설정	페이지 수, PDF 파일명, 저장 폴더를 입력합니다.
페이지 넘김	오른쪽/왼쪽/위/아래/스페이스/Page Down 키를 선택할 수 있습니다.
대기 시간	시작 대기와 페이지별 캡처 간격을 조절합니다.
뷰어 포커스	시작 전에 캡처 영역을 클릭해 전자책 뷰어를 활성화합니다.
진행 표시	캡처 단계와 PDF 변환 단계의 진행률을 보여줍니다.
작업 중지	실행 중인 캡처 작업을 중단할 수 있습니다.
파일 처리	기존 PDF 덮어쓰기 확인과 Windows 파일명 문자 정리를 처리합니다.
원본 보관	PDF 생성 후 PNG 캡처 파일을 삭제하거나 보관할 수 있습니다.

설치

Python 3.10 이상이 필요합니다.

git clone https://github.com/deploy103/ebook_scanner.git
cd ebook_scanner

python -m venv .venv
.\.venv\Scripts\activate

pip install -e .

실행

ebook-to-pdf

또는:

python -m ebook_to_pdf

사용 방법

1. 전자책 뷰어를 열고 첫 페이지를 화면에 표시합니다.
2. 프로그램에서 좌측상단 좌표 클릭을 누른 뒤 캡처 영역의 왼쪽 위를 클릭합니다.
3. 우측하단 좌표 클릭을 누른 뒤 캡처 영역의 오른쪽 아래를 클릭합니다.
4. 캡처할 총 페이지 수를 입력합니다.
5. 생성할 PDF 이름을 입력합니다.
6. PDF를 저장할 폴더를 선택합니다.
7. 전자책 뷰어에서 다음 페이지로 이동하는 키를 선택합니다.
8. 필요하면 시작 대기와 캡처 간격을 조절합니다.
9. PDF로 만들기를 실행합니다.

설정 기준

설정	권장 기준
캡처 영역	전자책 본문이 들어가는 영역만 선택
총 페이지 수	실제로 PDF에 넣을 페이지 수 입력
시작 대기	실행 후 뷰어 포커스를 잡을 수 있을 만큼 설정
캡처 간격	페이지가 완전히 로딩된 뒤 캡처되도록 설정
페이지 넘김 키	현재 전자책 뷰어에서 실제로 동작하는 키 선택
캡처 파일 보관	결과 확인이나 디버깅이 필요할 때만 사용

주의사항

• 프로그램 창이 캡처 영역을 가리면 그대로 PDF에 들어갈 수 있습니다.
• 페이지 로딩이 느린 뷰어에서는 캡처 간격을 늘려야 합니다.
• 페이지 넘김 키가 맞지 않으면 같은 페이지가 반복 캡처될 수 있습니다.
• 페이지 수가 많을수록 처리 시간과 PDF 크기가 증가합니다.
• 본인이 사용할 권한이 있는 문서에만 사용하세요.

개발

pip install -e .
python -m unittest discover -s tests

라이선스

MIT