winget install --id=jeiel85.LocalPDFStudio -e LocalPDF Studio is a local-first desktop PDF viewer and utility suite built with Tauri. Features include PDF viewing, merging, splitting, encryption, OCR (via Tesseract), page editing (reorder/delete/rotate/insert), watermarking, metadata editing, form filling, searchable PDF generation, and side-by-side comparison. All processing is performed locally — no cloud uploads.
LocalPDF Studio는 광고·계정·클라우드 업로드 없이 PDF를 다루는 로컬 우선 데스크톱 앱입니다. 모든 파일 처리는 사용자의 PC 안에서 일어나며, Tauri 2 + React 19 + Rust로 만들었습니다.
Cross-platform: Windows · macOS (Apple Silicon + Intel) · Linux. 자세한 설치 방법은 INSTALL.md를 참고하세요.
🌐 GitHub Pages 랜딩 페이지 · English · 日本語
최신 릴리즈에서 OS별 산출물을 받을 수 있습니다.
| 플랫폼 | 산출물 | 설치 방법 |
|---|---|---|
 Windows 10+ | NSIS .exe · MSI · Portable ZIP | 더블 클릭 · winget · Chocolatey |
 macOS 10.15+ ⚠️ 무서명 | Universal DMG (M1+Intel) | DMG 마운트 → Applications → 우클릭 열기 |
 Linux | AppImage · .deb · |
.rpm| 배포판별 패키지 또는 AppImage 직접 실행 |
| 매니저 | 명령어 | 상태 |
|---|---|---|
 winget | winget install jeiel85.LocalPDFStudio | v0.18.0 매니페스트 SHA 반영 완료, PR 제출 대기 |
 Chocolatey | choco install localpdf-studio | v0.18.0 패키지 메타데이터 반영 완료, community push 대기 |
 Snap | sudo snap install localpdf-studio | v0.18.0 .deb URL/SHA 반영 완료, Store 등록 대기 |
 AUR | yay -S localpdf-studio-bin | v0.18.0 PKGBUILD URL/SHA 반영 완료, AUR 등록 대기 |
 Homebrew | brew tap jeiel85/tap && brew install --cask localpdf-studio | v0.18.0 Cask 반영 완료, tap 게시 대기 |
> macOS 빌드는 현재 Apple Developer 서명/공증이 없습니다 ($99/년 비용 부담). 첫 실행 시 Gatekeeper 우회가 필요합니다 — 절차는 INSTALL.md#macOS 참고. 사용자가 의미 있게 늘면 서명 도입 검토 예정.
pdf-local:// 커스텀 프로토콜 + HTTP Range)TextItem의 transform/width 정보를 바탕으로 개인정보가 문장 일부에만 포함된 경우에도 문자 비례 너비(charWidth)로 밀착 좌표를 산출.RedactionArea로 병합.* 마스킹 표시와 유형별 배지로 보여주며, 전체/개별 선택 후 기존 블랙아웃 마스킹 목록에 추가. 스캔 이미지 PDF는 OCR → 검색 가능 PDF 안내를 제공.insertPage & removePage 전략). 기존의 원본 텍스트 레이어, 벡터 그래픽스 및 메타데이터를 영구 파괴하여 백그라운드 드래그나 데이터 마이닝을 통한 개인정보 유출을 원천 방지!drawRectangle API를 활용하여 검은색 사각형 영역을 PDF 위에 빠르게 덧그림..textLayer와 .annotationLayer 선택을 원천 차단.window.getSelection()을 유기적으로 연동하여 자연스럽게 여러 페이지를 넘나드는 다중 줄 하이라이트 지정.pdf-lib 저수준 API를 사용하여 각 페이지의 /Annots 딕셔너리에 표준 Highlight Annotation 객체를 임베딩함으로써, Adobe Acrobat, Chrome 내장 뷰어, macOS Preview 등 타 리더기 주석 패널과의 완벽한 양방향 호환성 확보.1-5, 7, 10-12)--password-file로 CLI 노출 방지)react useLocale 훅으로 즉시 전환)Ctrl+O/F/B/G/L/P/+/-/0, Home/End, Alt+←→, F1)default-src 'self', object-src 'none'isEvalSupported: false — 악성 PDF 임베디드 JS 차단pdf-local:// 프로토콜 CORS 화이트리스트0o600
Desktop Shell : Tauri 2
Frontend : React 19 + TypeScript 5 + Vite 7
Backend : Rust (edition 2021) — chrono, sha2, uuid, base64, which
PDF Viewer : PDF.js (pdfjs-dist v5) + TextLayer
PDF Engine : qpdf CLI wrapper (--password-file 안전 모드)
OCR : Tesseract CLI wrapper (searchable PDF / 이미지 OCR)
Image/PDF : pdf-lib (JS), Canvas API
Bundler : Tauri NSIS / MSI / DMG / AppImage / deb / rpm
Updater : Tauri updater plugin (minisign)
Test : Vitest (41 tests), Rust #[test] (37 tests)
CI/CD : GitHub Actions 3-OS matrix
libwebkit2gtk-4.1-dev libgtk-3-0-dev libayatana-appindicator3-dev librsvg2-dev patchelfnpm install
npm run tauri:dev # 개발 모드
npm run typecheck # TypeScript 타입 체크
npm run test # Vitest 단위 테스트
npm run build # 프론트엔드 빌드
npm run tauri:build # 데스크톱 앱 빌드 (현재 OS)
powershell -ExecutionPolicy Bypass -File scripts/windows/install-context-menu.ps1 `
-ExePath "$PWD\src-tauri\target\release\localpdf-studio.exe"
# 해제
powershell -ExecutionPolicy Bypass -File scripts/windows/uninstall-context-menu.ps1
src/ React UI (components, lib, i18n, App, types)
src-tauri/ Rust/Tauri backend (commands, qpdf, ocr, watermark, ...)
scripts/windows/ Windows 우클릭 메뉴 + Portable ZIP 생성 스크립트
└── sync-package-manifests.ps1 패키지 매니저 매니페스트 버전/SHA 동기화
docs/ 제품/기술/배포 설계 문서 + GitHub Pages 랜딩
packaging/ 패키지 매니저 매니페스트
├── winget/ Windows winget
├── chocolatey/ Windows Chocolatey
├── homebrew/ macOS Homebrew Cask
├── snap/ Linux Snap
└── aur/ Linux AUR
e2e/ Playwright + Tauri WebDriver (스캐폴드)
.github/workflows/ CI / release workflow (3-OS matrix)
vX.Y.Zsetup.exe + .sig, .msi (ko/en), portable .zip, latest.json.dmg, .app.AppImage, .deb, .rpmv*.*.*) 기준 GitHub Actions 3-OS 매트릭스 자동 빌드외부 바이너리 (qpdf, Tesseract) 및 라이브러리는 docs/05_SECURITY_PRIVACY_LICENSE.md 기준으로 라이선스 호환성을 검토합니다.