Python으로-만든-PDF-JPEG-변환기-배포까지 실무 적용
아레테_Arete
2026.05.26
# Python으로 만든 PDF→JPEG 변환기 — 스크립트에서 배포용 .exe까지
## 📝 한줄 요약
로컬 Python과 PyMuPDF로 만든 GUI 도구로 PDF를 일괄 JPEG로 변환하고, 페이지 수에 따라 개별 이미지 또는 ZIP으로 자동 저장하여 배포용 .exe로 배포한 사례입니다.
바쁘시면 이것만 읽어도 돼요:
- 사용한 도구: Python (Tkinter, PyMuPDF), PyInstaller
- 문제: PDF를 수동으로 이미지로 변환하는 반복 작업이 번거로움
- 핵심 해결: GUI로 한 번에 변환 및 ZIP 묶기 자동화하여 배포 가능한 단일 실행파일 제공
- 인상적 포인트: 간단한 스크립트로 배포형 .exe 제작까지 자동화
## 🎯 이런 분들께 도움돼요
- 사내 문서 담당자, 행정업무 자동화 담당자
- 수동으로 PDF를 이미지로 변환해 배포/첨부하는 업무가 많은 분
- 간단한 데스크톱 툴을 빠르게 배포하고 싶은 개발자·비개발자
## 😫 문제 상황 (Before)
기존에는 PDF를 개별 페이지 이미지로 추출하거나, 여러 페이지 문서를 공유 가능한 이미지 형태로 일괄 변환하려면 별도 툴이나 수작업(스캔-저장-압축)이 필요했습니다. 문서 수가 많을수록 시간이 많이 소요되고, 사용자가 일일이 파일명·폴더를 정리해야 했습니다.
## 🛠️ 사용한 도구
- **도구명**: Python (로컬 스크립트), PyMuPDF (`fitz`), Tkinter (GUI), PyInstaller (배포용 .exe 생성)
- **특이사항**: 5페이지 이하일 경우 개별 JPEG 저장, 6페이지 이상일 경우 ZIP으로 묶어 저장하는 정책을 적용
---
## 🔧 작업 과정
### 1) 요구와 설계
PDF 파일을 선택하면 자동으로 페이지 수를 확인하고, 설정한 DPI로 각 페이지를 이미지로 변환한 뒤 저장 방식(개별 JPEG / ZIP)을 결정하는 단순한 워크플로가 목표였습니다.
```
PDF 파일을 선택하여 각 페이지를 JPEG로 변환하고, 5페이지 이하면 개별 JPEG로, 6페이지 이상이면 ZIP으로 저장해줘
```
### 2) 구현(주요 포인트)
- GUI: `Tkinter`로 간단한 파일 선택, 해상도(150/300 DPI) 선택, 진행바, 상태 메시지 제공
- 변환: `PyMuPDF`(fitz)를 사용해 페이지를 래스터화하고 JPEG로 저장
- 임시 작업: 변환 과정에서 임시 폴더에 이미지를 생성한 뒤 최종 위치로 이동하거나 ZIP으로 묶음
- 배포: `PyInstaller`와 `build_helper.py`로 단일 실행파일(.exe) 생성 및 안전 교체 로직 구현
### 3) 배포 및 사용자 안내
- `배포용/사용안내_공통.txt`에 Windows 실행 방법 및 Android용 HTML 사용 안내 포함
- 배포용 .exe는 Python 설치가 없는 환경에서도 단독 실행 가능하도록 빌드
---
## ✅ 결과 (After)
### Before vs After
| 항목 | Before | After |
|------|--------|-------|
| 수동 작업 | PDF마다 수작업으로 이미지 추출 및 정리 | GUI에서 파일 선택 후 자동 변환·저장 (개별 JPEG 또는 ZIP) |
| 배포성 | 스크립트 형태로만 배포 필요 | 단일 .exe로 배포 가능 |
### 결과물
- `pdf_to_jpeg.py` — GUI 및 변환 로직
- `build_helper.py` — .exe 빌드 도우미
- `PDF_JPEG변환기.exe` (빌드 시 생성) — 내부적으로 PyMuPDF 포함
---
## 💬 이 과정에서 배운 AI 활용 팁
### 효과적이었던 것
1. 작은 단위(파일 선택 → 변환 → 저장)로 기능을 나누고 각 단계의 동작을 명확히 요청하면 빠르게 프로토타입을 얻을 수 있음
2. 배포용 빌드 스크립트(`build_helper.py`)를 별도 파일로 두면 반복 배포 시 안정성 확보에 유리
### 이렇게 하면 안 돼요
1. 불필요하게 높은 해상도를 기본값으로 두면 파일 용량이 크게 늘어남 (기본 150 DPI 권장)
---
## 🌍 다른 업무에 적용한다면?
- 스캔 문서 자동화, 건축 도면 썸네일 생성, 이미지 아카이브화 등 다양한 문서 처리 워크플로에 적용 가능
## 🚀 앞으로의 계획
- 사용자 피드백을 수집해 예외 처리(암호화된 PDF, 손상된 파일)와 멀티 스레드 처리 최적화 추가
- 관리자용 배포 포털 연동(원클릭 업데이트) 고려
---
## 📋 재사용 가능한 프롬프트
### 프롬프트 1: 데스크톱 변환기 만들기
> 로컬 Python으로 간단한 GUI 기반 PDF→JPEG 변환기를 만들어줘. 요구사항: 파일 선택, 150/300 DPI 선택, 페이지 수에 따라 5페이지 이하일 때는 개별 JPEG로 저장, 6페이지 이상일 때는 ZIP으로 묶어 저장. PyMuPDF로 페이지를 래스터화하고, 배포를 위해 PyInstaller로 .exe로 만들 수 있게 구성해줘.
### 프롬프트 2: 배포 스크립트와 안전 교체 로직
> Python 스크립트를 PyInstaller로 빌드한 후 기존 실행 파일이 실행 중이면 안전하게 교체하는 `build_helper.py`를 생성해줘. 실행 중인 경우 사용자에게 닫도록 안내하고 최대 30초 대기하는 로직을 포함해줘.
---
## 추천 이미지
- 문제 상황: 기존 수동 변환 화면(파일 탐색기, 여러 이미지 파일 스크린샷)
- AI와 협업 과정: 코드 에디터에서 `pdf_to_jpeg.py` 부분(파일 선택 UI) 스크린샷
- 결과: 변환 후 폴더에 저장된 JPEG/ZIP 파일 탐색기 화면
---
원본 개발 로그는 [DEVLOG.md](DEVLOG.md)에서 확인할 수 있습니다. 수정하거나 강조할 부분 알려주시면 반영해 드리겠습니다.



오 devlog를 작성중이셨군요! ㅎㅎ
바쁘셨어도 너무 잘하시는데요?
본인이 필요한것을 바이브 코딩으로 구현하신게 인상깊네요.