Skip to content

gomgom/hwp2pdf-plus

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

8 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

hwp2pdf+ icon

hwp2pdf+

HWP to PDF Plus — 여러 개의 HWP·HWPX 파일을 한 번에 PDF로 변환하는 Windows 도구

Batch-convert Hangul (HWP/HWPX) documents to PDF on Windows — drag & drop or CLI.
Free for personal, business, and public use. Requires Hancom Office Hangul 2010 SE or later.

License: MIT Platform .NET Framework


소개

hwp2pdf+는 한글(HWP·HWPX) 문서를 드래그 & 드롭 한 번으로 여러 개씩 PDF로 일괄 변환합니다. 개인·기업·기관 누구나 무료로 제약 없이 사용할 수 있습니다.

명령줄(CLI) 모드도 지원하므로 배치 스크립트나 자동화에도 바로 쓸 수 있습니다.

특징

  • HWP·HWPX 일괄 변환 — 파일 여러 개, 폴더 통째로(하위 폴더까지 재귀 수집) 한 번에.
  • 드래그 & 드롭 GUI — 목록에 끌어다 놓고 버튼 한 번. 파일별 진행 상태(대기 / 변환 중 / 완료 / 실패) 표시.
  • 한글 버전에 강함 — 한글 오토메이션을 늦은 바인딩(late binding) 으로 호출하여, 한글 2010부터 2024까지 어떤 버전이든 인터페이스 차이로 깨지지 않습니다. (구버전 타입 라이브러리로 조기 바인딩된 도구가 한글 2024에서 실행 즉시 죽던 문제를 해결한 것이 이 프로젝트의 출발점입니다.)
  • 편의 기능 — 중복 파일 자동 제거, 기존 PDF 덮어쓰기 옵션, Delete 키로 목록 항목 제거.
  • CLI 모드 — GUI 없이 인자로 파일·폴더를 넘겨 일괄 변환.

요구 사항

항목 내용
운영체제 Windows 10 / 11
한컴오피스 한글 2010 SE 이상 반드시 설치 (이 프로그램은 자체 변환 엔진이 없으며, 설치된 한글을 자동화로 원격 조종합니다)
HWPX 변환 한글 2020 이상(설치된 한글이 hwpx를 열 수 있어야 함)
.NET Framework 4.x (Windows 10/11에 기본 내장)

한글이 설치되지 않은 PC, 또는 MS Office·LibreOffice만 있는 PC에서는 동작하지 않습니다.

설치

  1. Releases에서 hwp2pdf-plus.exe를 내려받습니다.
  2. 아무 폴더에나 두고 실행합니다. 별도 설치 과정이 없습니다. (삭제도 파일만 지우면 끝)

SmartScreen 경고가 뜨는 경우: "Windows의 PC 보호" 창에서 [추가 정보][실행] 을 누르면 됩니다. (서명되지 않은 개인 배포 앱이라 나타나는 정상적인 경고입니다.)

실행이 막힐 때 — 스마트 앱 컨트롤 끄기

Windows 11에서 "스마트 앱 컨트롤이 안전하지 않을 수 있는 앱을 차단했습니다" 라며 실행이 막히고 [계속 실행] 같은 버튼도 보이지 않는다면, 스마트 앱 컨트롤(Smart App Control) 기능 때문입니다. 서명되지 않은 개인 배포 앱이라 생기는 것으로, 아래처럼 잠깐 껐다가 실행한 뒤 다시 켜면 됩니다.

  1. 시작 버튼(또는 검색)을 누르고 스마트 앱 컨트롤 을 검색해 여세요.

    설정 → 개인정보 및 보안 → Windows 보안 → 앱 및 브라우저 컨트롤 → 스마트 앱 컨트롤 → 스마트 앱 컨트롤 설정 → 끄기 를 통해서도 접근할 수 있습니다.

    시작에서 '스마트 앱 컨트롤' 검색
  2. 끄기 를 선택합니다.

    스마트 앱 컨트롤 '끄기' 선택
  3. hwp2pdf-plus.exe 를 실행합니다. 실행 후에는 보안을 위해 다시 으로 돌려두는 것을 권장합니다.

2026년 4월 Windows 업데이트부터는 스마트 앱 컨트롤을 껐다가 다시 켤 수 있습니다. 그 이전 버전에서는 한 번 끄면 되돌리기 어려우니, 먼저 Windows를 최신으로 업데이트한 뒤 진행하세요.

사용법

GUI

  1. hwp2pdf-plus.exe 실행.
  2. HWP·HWPX 파일이나 폴더를 창에 드래그 & 드롭 (또는 [파일 추가]).
  3. [PDF 변환] 클릭.
  4. PDF는 각 원본 파일과 같은 위치에 생성됩니다. (아래 출력 폴더 선택으로 바꿀 수 있음)
  • 기존 PDF 덮어쓰기 체크 시 같은 이름의 PDF가 있어도 다시 만듭니다(기본값은 건너뜀).
  • 출력 폴더 선택을 체크하고 [폴더 선택]으로 폴더를 지정하면, PDF를 원본 옆이 아니라 그 폴더에 모아서 저장합니다.
  • 현재 저장된 PDF 설정으로 출력을 체크하면 한/글에 저장된 PDF 설정(변환 범위 등)을 그대로 사용합니다. 기본값은 항상 문서 전체를 출력합니다.
  • 목록에서 항목을 선택하고 Delete 키로 제거할 수 있습니다.

CLI

:: 파일 하나
hwp2pdf-plus.exe "C:\문서\보고서.hwp"

:: 여러 개
hwp2pdf-plus.exe "a.hwp" "b.hwpx"

:: 폴더 통째로 (하위 폴더 포함)
hwp2pdf-plus.exe "C:\문서폴더"

종료 코드: 0 전부 성공 / 2 실패 있음 / 1 대상 파일 없음.

소스 빌드

Windows에 기본 포함된 .NET Framework의 C# 컴파일러만 사용합니다. NuGet·외부 라이브러리가 필요 없습니다.

powershell -ExecutionPolicy Bypass -File build.ps1

build.ps1csc.exe와 WPF 어셈블리를 찾아 hwp2pdf-plus.exe 하나를 만듭니다.

구성 파일:

파일 역할
Program.cs 진입점, 한/글 오토메이션 연동, 화면 동작, CLI 모드
ui/MainWindow.xaml 화면 디자인 (실행 시 XamlReader로 로드되도록 exe에 임베드)
res/app.ico 앱 아이콘

동작 원리

HWPFrame.HwpObject COM 오브젝트(한글 오토메이션)를 IDispatch 늦은 바인딩으로 호출해, 설치된 한글이 문서를 열고 PDF로 저장(SaveAs ... "PDF")하도록 합니다. 한컴의 코드나 타입 라이브러리를 포함·재배포하지 않으므로 라이선스 충돌이 없습니다.

한계

  • 한글이 설치되지 않은 PC에서는 사용할 수 없습니다.
  • 암호가 걸린 문서 등 일부 파일은 변환에 실패할 수 있습니다.
  • 변환 품질·레이아웃은 설치된 한글의 PDF 저장 결과를 따릅니다.

라이선스

MIT License © 2026 gomgom

About

HWP·HWPX 문서를 PDF로 한 번에 변환하는 도구 · Batch HWP/HWPX to PDF converter

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages