도구별 실전 가이드 · 공식 정보 확인 2026-08-20

OCRmyPDF MPL-2.0 오픈소스 조건과 시작 절차

작성: gentive · 편집·검수 책임: 신유빈 · 지원 환경: CLI · 페이지 갱신: · 운영·편집 기준

Tesseract로 이미지 PDF의 페이지 모양을 유지하며 숨은 검색 텍스트를 삽입하는 스캔 PDF에 검색 가능한 OCR 층을 더하는 CLI입니다.

Tesseract로 이미지 PDF의 페이지 모양을 유지하며 숨은 검색 텍스트를 삽입하는 스캔 PDF에 검색 가능한 OCR 층을 더하는 CLI입니다. OCRmyPDF의 첫 실전 과제는 “오래된 영수증 스캔 묶음을 검색 가능한 PDF로 만들기”이며, 이 흐름을 직접 통제할 사람에게 맞습니다.

이럴 때 맞습니다

  • “회전되거나 흐린 영수증 25쪽이 합쳐진 이미지 PDF” 같은 입력으로 OCRmyPDF의 핵심 기능을 시험하려는 사람
  • 원본 화질·페이지 수가 유지되고 날짜·금액 검색이 올바른 쪽을 찾는지 기준으로 OCRmyPDF 결과를 직접 검수할 수 있는 경우
  • CLI 환경에서 MPL-2.0 코드를 직접 설치·관리하려는 작업

이럴 때는 멈추세요

  • 스캔 PDF에 검색 가능한 OCR 층을 더하는 CLI 설치·모델 준비·업데이트를 관리하지 않고 즉시 완성된 서비스를 원하는 경우
  • 다음 위험을 사람이 확인할 수 없는 작업: 잘못 인식된 숫자가 보이는 이미지 뒤의 검색 텍스트로 남아 자동 색인·검색 결과를 왜곡하는 문제.

참고 시작점

팩트시트 · 작업 근거 확인 필요: 아래 문구는 공식 제품 사실을 정리한 참고 시작점이며, 성공 결과를 보장하는 검증 절차가 아닙니다.

원본 스캔을 보존한 OCR 명령을 만든다

회전·기울기 보정과 sidecar 검수를 포함한 안전한 CLI 실행안이 생긴다.

참고 시작점: 25쪽 영수증 PDF를 회전·기울기 보정해 검색 가능하게 만들고 OCR 텍스트도 따로 저장해 줘.

  1. 원본 PDF 사본에 `ocrmypdf --rotate-pages --deskew --sidecar receipts.txt input.pdf output.pdf` 명령을 준비한다.
  2. 이미 텍스트가 있는 페이지 처리 방식은 `--skip-text`가 맞는지 입력 특성을 확인한다.
  3. 출력 경로를 원본과 분리하고 덮어쓰지 않는지 명령 인자를 다시 읽는다.

Tesseract 텍스트 레이어를 추가한다

보이는 영수증 이미지를 유지한 검색 가능한 PDF가 생성된다.

참고 시작점: 원본 이미지는 다시 압축하지 말고 한국어·영어 날짜와 금액을 검색할 OCR layer로 추가해 줘.

  1. OCRmyPDF를 지정 언어와 `--sidecar` 옵션으로 실행한다.
  2. Tesseract 처리 로그에서 회전된 페이지와 낮은 신뢰도 쪽을 확인한다.
  3. 명령 종료 코드와 출력 PDF 페이지 수를 기록한다.

검색과 화질을 동시에 검증한다

페이지 수·화질·날짜·금액 검색이 검수된 PDF가 남는다.

참고 시작점: 원본과 출력의 25쪽 수, 이미지 화질, 대표 날짜·금액 검색 결과를 비교해 줘.

  1. `pdfinfo`로 원본과 출력의 페이지 수가 모두 25인지 확인한다.
  2. 첫·중간·마지막 영수증의 이미지 선명도를 확대 비교한다.
  3. PDF 검색 텍스트를 Tesseract sidecar와 대조하고 image-processing 뒤에도 25쪽 화질이 유지됐는지 확인한다.

무료 조건과 주의점

MPL-2.0 오픈소스 소프트웨어는 횟수 제한 없이 실행 가능. 연결한 모델 API·서버·GPU 비용은 별도

MPL-2.0 오픈소스 소프트웨어는 횟수 제한 없이 실행 가능. 연결한 모델 API·서버·GPU 비용은 별도

MPL-2.0 라이선스의 고지·소스 공개·동일 라이선스 등 조건을 확인해야 합니다.

잘못 인식된 숫자가 보이는 이미지 뒤의 검색 텍스트로 남아 자동 색인·검색 결과를 왜곡하는 문제.

공식 근거와 확인일

OCRmyPDF 가이드의 주장별 공식 출처
확인 항목확인한 내용공식 출처·확인일
제품 정보Tesseract로 이미지 PDF의 페이지 모양을 유지하며 숨은 검색 텍스트를 삽입하는 스캔 PDF에 검색 가능한 OCR 층을 더하는 CLI입니다.OCRmyPDF 공식 사이트
무료 조건MPL-2.0 오픈소스 소프트웨어는 횟수 제한 없이 실행 가능. 연결한 모델 API·서버·GPU 비용은 별도공식 무료 정책·요금 안내
공식 코드 라이선스오픈소스 코드의 사용·수정·재배포 조건공식 코드 라이선스
공식 제품 페이지Tesseract로 이미지 PDF의 페이지 모양을 유지하며 숨은 검색 텍스트를 삽입하는 스캔 PDF에 검색 가능한 OCR 층을 더하는 CLI입니다.공식 제품 페이지