11 KiB
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 | 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) 빌드
# 솔루션 빌드
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) 컨텍스트 메뉴 등록
.\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
# <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 확장 |
메인 창 시작 시 가용성을 자동 점검해 사이드바에 안내하고, 미설치 도구는 다이얼로그에서 다운로드 링크를 제공합니다.
기술 스택
- .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
프로젝트 구조
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에 자동 반영됩니다.
// 매트릭스 헬퍼 — 모든 입력 × 모든 출력 카르테시안 곱
SupportedConversions: ProviderCapability.PairsFromMatrix(
new[] { ".png", ".jpg", ".webp" },
new[] { ".png", ".jpg", ".pdf" }),
라이선스
MIT.
현재 기능과 검증 범위
현재 기능·제약, 조사 및 개선 작업장, 완결성 감사를 참고하세요. 지원 형식 선언과 실제 외부 도구 설치 여부는 별개입니다. 릴리즈는 전체 테스트·서명·패키징·업로드 검증을 통과해야 합니다.