PDF Image Splitter

PDF 파일의 각 페이지를 이미지로 변환하는 Chrome 확장프로그램입니다. 기존 Python CLI 스크립트도 함께 유지되어 있습니다.

Chrome 확장프로그램 사용

권장: 배포 폴더 빌드 후 로드

npm run build

1. Chrome에서 chrome://extensions를 엽니다.
2. 오른쪽 위의 개발자 모드를 켭니다.
3. 압축해제된 확장 프로그램을 로드합니다를 누르고 dist/extension 폴더를 선택합니다.
4. 툴바의 PDF Image Splitter 아이콘을 눌러 PDF를 선택합니다.
5. 이미지 형식, DPI, 페이지 범위를 선택하고 이미지 다운로드를 누릅니다.

변환은 브라우저 안에서만 실행되며 PDF 파일은 외부 서버로 업로드되지 않습니다. 결과는 페이지별 이미지가 들어 있는 ZIP 파일로 다운로드됩니다.

포함된 라이브러리

• PDF 렌더링: Mozilla PDF.js (lib/pdfjs, Apache-2.0)
• ZIP 생성: src/zip.js의 브라우저 내장 Blob 기반 구현

Python CLI 사용

1. 의존성 설치

pip install -r requirements.txt

2. Poppler 설치 (필수)

macOS:

brew install poppler

Windows:

• Poppler for Windows 다운로드
• 또는 python split_pdf.py input.pdf -p "C:\Program Files\poppler\bin" 옵션 사용

Linux (Ubuntu/Debian):

sudo apt-get install poppler-utils

사용법

기본 사용

python split_pdf.py input.pdf

옵션

• -o, --output : 출력 폴더 (기본값: PDF와 같은 폴더)
• -d, --dpi : 해상도 (기본값: 200)
• -f, --format : 이미지 형식 - png, jpg, ppm (기본값: png)
• --first-page : 시작 페이지 (1부터 시작)
• --last-page : 끝 페이지
• -p, --poppler-path : poppler 설치 경로 (Windows)

사용 예시

# PNG 형식, 기본 설정
python split_pdf.py document.pdf

# 커스텀 폴더에 저장
python split_pdf.py document.pdf -o ./images

# JPG 형식, 300 DPI
python split_pdf.py document.pdf -f jpg -d 300

# 특정 페이지만 변환 (1~5페이지)
python split_pdf.py document.pdf --first-page 1 --last-page 5

# 고해상도 PNG (300 DPI)
python split_pdf.py document.pdf -d 300

# Windows에서 poppler 경로 지정
python split_pdf.py document.pdf -p "C:\Program Files\poppler\bin"

예상 결과

📄 Converting: document.pdf
💾 Output dir: ./images
⚙️  DPI: 200, Format: PNG

✅ Total pages: 10
   ✓ Saved: ./images/document_page_1.png
   ✓ Saved: ./images/document_page_2.png
   ...
   ✓ Saved: ./images/document_page_10.png

🎉 Done! 10 images created.