macOS · 무료 · 오픈소스 macOS · Free · Open Source

스페이스바 한 번으로,
HWP 파일을 바로 열다.
Preview HWP files
with a single spacebar.

한컴오피스 없이도, Finder에서 한글 문서를 즉시 미리보고 열 수 있습니다. macOS 네이티브 Quick Look에 딱 맞게 설계된 가볍고 조용한 뷰어. Preview and open Korean HWP documents straight from Finder — no Hancom Office required. A quiet, native viewer built for macOS Quick Look.

DMG 다운로드 Download DMG GitHub
$ brew install hulryung/tap/hwpquicklook
Apple 공증 완료 · Gatekeeper 경고 없음 Notarized by Apple · no Gatekeeper warning Apple Silicon · Intel 모두 지원 Universal: Apple Silicon + Intel 한컴오피스 설치 불필요 No Hancom Office required
noori.hwp
HWPQuickLook rendering a Korean government press release HWP document
핵심 기능
Core features

꼭 필요한 만큼만,
조용하게 잘 동작합니다.
Only what you need —
and it just works, quietly.

macOS의 흐름을 방해하지 않습니다. 스페이스바를 누르면 프리뷰가 뜨고, 더블클릭하면 창이 열리고, 그 외엔 아무 소리도 내지 않습니다. HWPQuickLook stays out of your way. Spacebar opens the preview, double-click opens a window, and otherwise it makes no noise at all.

01

Finder Quick Look 프리뷰

Finder Quick Look preview

.hwp · .hwpx 파일을 고르고 스페이스바만 누르면, 고품질 SVG 렌더링으로 본문·표·미리보기가 즉시 나타납니다.

Select an .hwp or .hwpx file, hit space, and get instant, high-quality SVG rendering of the whole document.

02

Finder 썸네일

Finder thumbnails

아이콘 크기에서도 문서 첫 페이지가 보입니다. HWP 내부에 저장된 프리뷰 이미지를 그대로 사용해 빠르고 깔끔합니다.

Each file icon shows a real first-page preview. We reuse the embedded preview image inside the HWP, so it's fast and stays sharp.

03

독립 뷰어 앱

Standalone viewer app

더블클릭으로 별도 창에서 열어 문서를 차분히 읽을 수 있습니다. SwiftUI + AppKit 하이브리드로 파일 라우팅이 안정적입니다.

Double-click to read in a dedicated window. Built as a SwiftUI + AppKit hybrid for rock-solid file routing.

macOS 네이티브 Native macOS
SwiftUI AppKit WKWebView Quick Look
04

공증 서명 + 무료 오픈소스

Notarized + open source

Apple 공증을 받아 Gatekeeper 경고 없이 바로 실행됩니다. MIT 라이선스로 전체 소스가 공개되어 있어 안심하고 쓰세요.

Notarized by Apple — no "unidentified developer" warning. The full source is MIT-licensed, so you always know what you're running.

동작 방식
How it works

3단계로 끝나는, 눈에 보이지 않는 공정 A quiet three-step pipeline

Rust로 파싱하고, SVG로 렌더하고, macOS 익스텐션으로 꽂습니다. 사용자 입장에선 그저 스페이스바 한 번입니다. Parse in Rust, render to SVG, plug into native macOS extensions — from your side, it's just a spacebar.

STEP 01

Rust로 HWP 파싱

Parse HWP in Rust

rhwp 크레이트가 HWP·HWPX 바이너리를 빠르고 안전하게 해석합니다.

The rhwp crate decodes HWP and HWPX binaries quickly and safely.

STEP 02

SVG + HTML로 렌더

Render to SVG + HTML

Swift는 FFI로 hwp_parse_to_html을 호출해 페이지를 SVG로 감싼 HTML을 받습니다.

Swift calls hwp_parse_to_html over FFI and gets back an SVG-wrapped HTML document.

STEP 03

Quick Look에 연결

Plug into Quick Look

프리뷰·썸네일 익스텐션이 시스템 패널에, 독립 뷰어가 WKWebView에 렌더링합니다.

Preview and thumbnail extensions feed the system panel; the standalone app renders inside a WKWebView.

설치 · 시작하기
Install · Get started

30초면 충분합니다. 30 seconds, start to finish.

둘 중 편한 방법으로 설치하세요. 설치 후 Finder에서 .hwp 파일 선택 → 스페이스바. Pick whichever you prefer. Then select a .hwp file in Finder and hit space.

OPTION A · DMG

최신 릴리스 다운로드

Download the latest release

공증된 DMG를 받아 HWPQuickLook.app을 Applications 폴더로 드래그하면 끝입니다.

Grab the notarized DMG and drag HWPQuickLook.app into your Applications folder.

Releases에서 DMG 받기 Get DMG from Releases
OPTION B · HOMEBREW

터미널 한 줄로

One line in Terminal

이미 Homebrew를 쓴다면 그대로 tap을 추가해 설치할 수 있습니다.

If you're already on Homebrew, just add the tap and install.

$brew install hulryung/tap/hwpquicklook

tap 반영까지 며칠 지연될 수 있어요. 최신이 필요하면 DMG를 권장합니다. The tap may lag a couple of days behind the DMG. For the absolute latest, use the DMG.

macOS
12.0 Monterey+
Ventura · Sonoma · Sequoia 포함
incl. Ventura · Sonoma · Sequoia
아키텍처
Architecture
Universal
Apple Silicon · Intel
지원 포맷
File formats
.hwp · .hwpx
한컴 네이티브 UTI
Hancom native UTIs
라이선스
License
MIT
완전 무료 · 오픈소스
Free · open source

이제 Finder에서 스페이스바를 눌러보세요. Now go press space in Finder.

다운로드하고, 드래그하고, 스페이스바 — HWP가 그냥 열립니다. Download, drag, spacebar — your HWP just opens.