210 lines
11 KiB
Markdown
210 lines
11 KiB
Markdown
# 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
|
||
# <ext>로 변환 (배치 가능)
|
||
.\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<ConversionPair>`
|
||
- `ProviderRegistry` — `Dictionary<(input, output), Provider>` 매트릭스 인덱싱 + `OutputsForFile()` 쿼리
|
||
- `ConversionEngine.ConvertOneAsync(source, outputExt, options)` — 동일 입출력 자동 skip + 출력 ext 기반 서브폴더 suffix(`<base>_png/`, `<base>_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)를 참고하세요. 지원 형식 선언과 실제 외부 도구 설치 여부는 별개입니다. 릴리즈는 전체 테스트·서명·패키징·업로드 검증을 통과해야 합니다.
|