# Everything2Everything Windows용 파일 변환 프로그램. 이미지·문서·PDF·HTML·영상/오디오·표 데이터를 하나의 대기열에서 처리합니다. 지원 경로와 설치된 도구에 따라 사용 가능한 출력 형식이 달라집니다. > 이 프로젝트는 단방향 *EverythingToJpeg* 에서 양방향 *Everything2Everything* 으로 피보팅된 결과물입니다. - **카스케이드 컨텍스트 메뉴** — 입력 파일에 따라 가능한 출력 형식만 자동 노출 - **양방향 이미지 매트릭스** — PNG ↔ JPEG ↔ WebP ↔ AVIF ↔ TIFF ↔ BMP ↔ GIF - **HTML → PDF**, **DOCX/HWPX ↔ PDF** 같은 문서 변환 포함 - 출력 형식별 인코딩 옵션(JPEG quality, WebP lossless, AVIF speed 등) 분리 - 진행 상황 + 썸네일 + 드래그 & 드롭 메인 창 ## 변환 매트릭스 | Provider | 입력 | 출력 | |---|---|---| | **MagickProvider** | PNG · JPEG · WebP · AVIF · BMP · TIFF · GIF · PSD · RAW (NEF/CR2/CR3/ARW/DNG/RAF/ORF/RW2/SRW/PEF) | PNG · JPEG · WebP · AVIF · BMP · TIFF · GIF | | **HeicProvider** | HEIC · HEIF | PNG · JPEG · WebP · AVIF · BMP · TIFF · GIF | | **PdfProvider** | PDF | PNG · JPEG · WebP · AVIF · BMP · TIFF | | **HtmlProvider** | HTML · HTM | PNG · JPEG · WebP · AVIF · BMP · TIFF · **PDF** | | **DocxProvider** | DOCX · DOC | **PDF** + 이미지 7종 | | **HwpxProvider** | HWP · HWPX | **PDF** + 이미지 7종 | 추가 Provider는 다음과 같습니다. 정확한 직접 변환 쌍은 각 Provider의 `SupportedConversions`가 기준이며, 그래프가 중간 형식을 거친 경로도 합성합니다. | Provider | 범위 / 조건 | |---|---| | FfmpegProvider | 영상·오디오 변환과 오디오 추출. FFmpeg 필요 | | DataProvider | CSV·JSON·XLSX 평면 표 변환. 서식·수식 보존 편집기 아님 | | DocumentProvider | 문서 ↔ HTML/Markdown/TXT 및 텍스트 → DOCX. LibreOffice 필요 | | MarkdownProvider | HTML·Markdown·TXT 변환. 내장 엔진 | | VectorProvider | SVG → PNG/PDF 및 이미지 경유 변환 | | OcrProvider | 이미지/PDF → TXT. Windows OCR 언어팩 필요 | | PdfToolProvider | PDF 재압축. 서명·XFA·PDF/A 보존을 보장하지 않음 | | ImageOptimProvider | 같은 이미지 형식 재압축 | | LlmProvider | 텍스트 요약·번역·교정. 외부 AI 서비스 또는 설정된 Codex CLI 필요 | 알파 채널이 없는 출력은 배경색으로 평탄화됩니다. 형식 전환은 페이지·애니메이션·메타데이터·색상·문서 배치를 바꿀 수 있습니다. WebP 무손실과 메타데이터 보존 옵션을 별도로 확인하세요. 외부 AI 기능은 텍스트가 외부 서비스로 전송됩니다. ## 빠른 시작 ### 1) 빌드 ```powershell # 솔루션 빌드 dotnet build Everything2Everything.slnx -c Release # 단일 폴더 publish (framework-dependent, .NET 9 Desktop Runtime 필요) dotnet publish src\Everything2Everything.App\Everything2Everything.App.csproj ` -c Release -r win-x64 --self-contained false -o publish # .NET 런타임 동봉 (단일 사용자 배포가 편함) dotnet publish src\Everything2Everything.App\Everything2Everything.App.csproj ` -c Release -r win-x64 --self-contained true ` -p:PublishSingleFile=false -o publish-self ``` 산출물: `publish\Everything2Everything.exe` ### 2) 컨텍스트 메뉴 등록 ```powershell .\Everything2Everything.exe register .\Everything2Everything.exe unregister ``` > Windows 11 기본 우클릭에서는 **추가 옵션 표시(Shift+우클릭)** 안에 노출됩니다. 메인 메뉴 노출은 MSIX + IExplorerCommand DLL이 필요합니다 — `packaging/BuildAndSign.ps1` 참고. ### 3) 사용 #### 우클릭 카스케이드 파일 우클릭 → **Everything2Everything으로 변환** → 서브메뉴에서 출력 형식 선택. 각 입력의 매트릭스에 따라 가능한 출력만 표시됩니다. | 입력 → 노출되는 서브메뉴 항목 | |---| | `.png` → JPEG · WebP · AVIF · GIF · TIFF · BMP · 변환… | | `.heic` → JPEG · PNG · WebP · AVIF · GIF · TIFF · BMP · 변환… | | `.pdf` → JPEG · PNG · WebP · AVIF · TIFF · BMP · 변환… | | `.docx` → PDF · JPEG · PNG · WebP · AVIF · TIFF · BMP · 변환… | | `.html` → PDF · JPEG · PNG · WebP · AVIF · TIFF · BMP · 변환… | "변환…" 항목은 메인 창을 띄워 사이드바에서 출력 형식로 직접 선택할 수 있습니다. #### 메인 창 파일을 드래그 & 드롭하거나 **파일 추가**(Ctrl+O)를 사용합니다. **폴더 추가**는 선택한 폴더의 파일만 가져오며 하위 폴더는 포함하지 않습니다. 사이드바의 **출력 형식** 선택창는 **큐의 모든 파일이 변환 가능한 출력의 교집합**만 보여줍니다 (이종 입력을 섞으면 자동 필터링). **단일 파일로 결합** 체크박스 — 출력이 PDF/TIFF/GIF이고 큐가 2개 이상의 이미지일 때 활성화. 큐의 모든 이미지를 단일 다중 페이지 파일로 결합합니다 (예: 스크린샷 5장 → 1개 PDF). 이력에서 결과 열기·오류 복사·원본 다시 추가와 **실패 다시 추가**를 사용할 수 있습니다. **내 프리셋**에서 옵션을 저장·적용하거나 가져오기/내보내기 합니다. 탐색기 메뉴는 화면의 등록/해제 버튼 또는 CLI로 관리합니다. #### CLI ```powershell # 로 변환 (배치 가능) .\Everything2Everything.exe to png photo.heic shot.jpg banner.webp .\Everything2Everything.exe to pdf doc.docx report.html .\Everything2Everything.exe to webp *.png # 빠른 변환 (기본 출력 .jpg, 컨텍스트 메뉴 호환) .\Everything2Everything.exe quick photo.heic # 메인 창에서 출력 형식 선택 .\Everything2Everything.exe dialog photo.heic # 진단 .\Everything2Everything.exe diagnose ``` ## 외부 도구 의존성 | 변환 | 필요 도구 | |---|---| | 모든 이미지 ↔ 이미지, RAW/PSD 디코딩 | (내장) Magick.NET 14 | | HEIC/HEIF 디코딩 | (내장) PhotoSauce + libheif | | PDF ↔ 이미지 | (내장) PDFtoImage(PDFium) | | HTML → 이미지/PDF | Microsoft Edge **WebView2 Runtime** (Win11 기본 포함) | | DOCX/DOC → PDF/이미지 | **Microsoft Word** 또는 **LibreOffice** (자동 감지) | | HWP/HWPX → PDF/이미지 | **LibreOffice** + [**H2Orestart**](https://github.com/ebandal/H2Orestart) 확장 | 메인 창 시작 시 가용성을 자동 점검해 사이드바에 안내하고, 미설치 도구는 다이얼로그에서 다운로드 링크를 제공합니다. ## 기술 스택 - **.NET 9 + WPF**, Windows 10.0.19041.0+ - UI: **WPF-UI 4.3** (Win11 Fluent 2) - 변환 엔진: Magick.NET, PDFtoImage, PhotoSauce.MagicScaler + Libheif, WebView2 (CDP) ## 아키텍처 ``` 입력 파일 → ProviderRegistry.TryGet(input ext, output ext) ↓ (input, output) → IConverterProvider 매트릭스 인덱스 ↓ provider.ConvertAsync(source, outDir, outExt, options, ...) ``` 핵심 추상화: - `ConversionPair(InputExtension, OutputExtension)` — 단방향 쌍 - `ProviderCapability.SupportedConversions: IReadOnlyList` - `ProviderRegistry` — `Dictionary<(input, output), Provider>` 매트릭스 인덱싱 + `OutputsForFile()` 쿼리 - `ConversionEngine.ConvertOneAsync(source, outputExt, options)` — 동일 입출력 자동 skip + 출력 ext 기반 서브폴더 suffix(`_png/`, `_pdf/`) - `ConvertOptions` — 형식별 sub-record (`Jpeg.Quality`, `Webp.Lossless`, `Avif.Speed`, `PdfRender.Dpi`, `HtmlRender.FullPage` 등) ## 키보드 단축키 | 키 | 동작 | |---|---| | Ctrl+O | 파일 추가 | | Ctrl+Enter | 변환 시작 | | Ctrl+A | 대기열 선택 | | Delete | 선택 항목을 대기열에서 제거 (원본 유지) | | Esc | 처리 중에는 취소, 대기 중에는 창 닫기 | | F5 | 통계 새로고침 | | F1 | 도움말 및 프로그램 정보 | ## 두 가지 사용 방식 ### A) Portable EXE — 가장 가벼움 - `dotnet publish` 산출물 그대로 사용 - 우클릭 → **추가 옵션 표시** → "Everything2Everything으로 변환" → 카스케이드 서브메뉴 - 인증서·서명 불필요 ### B) MSIX 패키지 — Win11 메인 메뉴 노출 - `packaging/BuildMsix.ps1`로 MSIX 빌드 - 자체 서명 인증서를 `LocalMachine\TrustedPeople`에 임포트 후 사이드로드 - 우클릭 → 메인 메뉴 바로 노출 (IExplorerCommand DLL 사용) - 자세한 절차는 [packaging/README.md](packaging/README.md) ## 프로젝트 구조 ``` Everything2Everything/ ├── Everything2Everything.slnx └── src/ ├── Everything2Everything.Core/ — 변환 엔진, Provider 추상화 │ ├── Providers/ │ │ ├── ConversionPair.cs — (입력ext, 출력ext) 단방향 쌍 │ │ ├── ProviderCapability.cs — SupportedConversions + 입출력 헬퍼 │ │ ├── ProviderRegistry.cs — N×M 매트릭스 인덱싱 │ │ └── IConverterProvider.cs │ ├── Converters/ — Magick / Heic / Pdf / Docx / Html / Hwpx │ ├── ConversionEngine.cs — outputExt 라우팅 + 서브폴더 suffix │ ├── ConvertOptions.cs — 형식별 sub-options │ └── Everything2EverythingBootstrap.cs └── Everything2Everything.App/ — WPF + CLI 통합 진입점 ├── App.xaml(.cs) ├── Cli/CliRouter.cs — verb: to / quick / dialog / register / unregister / diagnose ├── Shell/ContextMenuRegistrar.cs — HKCU 카스케이드 등록 └── Views/ — Fluent UI 화면 ``` ## Provider 확장 새 변환 쌍을 추가하려면 `IConverterProvider`를 구현합니다. `ServiceCollectionExtensions`의 어셈블리 스캔으로 자동 등록됩니다. `ProviderCapability.SupportedConversions`에 (입력ext, 출력ext) 쌍 리스트를 정의하면 `ProviderRegistry`가 매트릭스 인덱스에 자동 편입하며, 컨텍스트 메뉴 카스케이드 + 메인 창 ComboBox에 자동 반영됩니다. ```csharp // 매트릭스 헬퍼 — 모든 입력 × 모든 출력 카르테시안 곱 SupportedConversions: ProviderCapability.PairsFromMatrix( new[] { ".png", ".jpg", ".webp" }, new[] { ".png", ".jpg", ".pdf" }), ``` ## 라이선스 MIT. ## 현재 기능과 검증 범위 [현재 기능·제약](docs/current-features.md), [조사 및 개선 작업장](docs/research/2026-11-04/TASKS.md), [완결성 감사](docs/research/2026-11-04/agent-completeness.md)를 참고하세요. 지원 형식 선언과 실제 외부 도구 설치 여부는 별개입니다. 릴리즈는 전체 테스트·서명·패키징·업로드 검증을 통과해야 합니다.