Giting.
낮의 Giting

홈 · C# · 파일 변환 · HWP · 오프라인 · Avalonia

Filee 대표 이미지 ff56a0c (2026-10-17) · 전체 이력 301커밋 · 첫 커밋 2026-09-30 · 저자 표기 3(사실상 1명 + 1명)
분석 리포트실측 정보적용점

무엇을 하나

파일 변환기다. 파일을 끌면서 Ctrl(macOS 는 Option)을 누르면 커서 자리에 형식이 둥글게 늘어선 도넛이 열리고, 원하는 형식 위에 놓으면 원본 옆에 변환된 파일이 생긴다. 끌고 있는 파일에 맞는 형식만 나온다.

지원 형식은 244가지다. 이미지 · PDF · 워드 · 엑셀 · 파워포인트 · HWP · 전자책 · 압축 파일 · 글꼴 · CAD · 3D 모델을 오피스나 한컴오피스 없이 바꾼다. 아무것도 올리지 않고 오프라인으로 돈다. 우클릭 메뉴, 단축키, 드롭 영역, filee 명령줄로도 쓸 수 있다.

직접 돌려 봤다

macOS 판 1.11.0(arm64)을 내려받아 체크섬을 확인하고, 설치하지 않은 채 앱 안의 filee-cli 로 변환했다. 맥미니라 화면이 없어 도넛은 띄우지 못했다.

우리가 쓴 안내문(제목 · 표 · 목록)을 이렇게 돌렸다.

  • 마크다운 → HWPX 0.2초
  • HWPX → HWP 0.2초
  • HWP → PDF 0.6초, HWP → DOCX 0.2초

PDF 를 그림으로 떠 보니 제목 색 · 표 칸 · 목록 점이 그대로였다. 이 리포트의 표지 오른쪽이 그 쪽이다.

공개 HWP 표본(대학 보고서 양식 7쪽, hwp.js 저장소의 시험 파일)도 돌렸다. PDF 0.7초, DOCX · HWPX · 마크다운 0.2초, 쪽마다 PNG 7장 1.5초로 모두 나왔다. 다만 1쪽 제목 줄에 회색 띠와 점 하나가 끼었다. 원본을 한컴오피스로 열어 대조하지 못해서, 원본에 있는 것인지 변환에서 생긴 것인지는 판단하지 않았다.

HWP 말고도 HEIC → JPG, JPG → WEBP · AVIF, PDF → DOCX, DOCX → PDF, 마크다운 → EPUB 가 모두 됐다. WEBP 와 AVIF 는 기본 품질로 바꾸면 원본 JPG 보다 커졌다.

무엇으로 만들었나

C# 과 .NET 10, 화면은 Avalonia 다. 코드가 10만 줄인데 가장 큰 파일이 HWPX 를 읽는 HtmlReader.cs 다. HWP 는 NuGet 의 Unhwp(MIT)를 쓰고 HWPX 읽기 · 쓰기는 직접 짰다. 이미지는 Magick.NET, PDF 는 PDFsharp · PdfPig, CAD 는 ACadSharp 를 쓴다.

LibreOffice · FFmpeg · Pandoc · calibre · Ghostscript 가 필요한 형식은 기본 설치에 넣지 않았다. 처음 쓸 때 내려받고, 받은 파일이 정해 둔 SHA-256 과 다르면 버린다.

믿을 만한가

테스트 파일 108개에 테스트 716개, CI 워크플로가 셋이다. 이슈 25건을 보니 21건에 답이 달렸고 중앙값 6.3시간이었다.

네트워크는 두 군데만 나간다. 새 판 확인(GitHub API)과 추가 엔진 내려받기다. 통계를 보내는 코드는 찾지 못했다. 후원 링크(GitHub Sponsors · Patreon 등)가 앱에 들어 있지만 누르지 않으면 아무 데도 가지 않는다.

주의점

9월 30일에 첫 커밋을 한 3주 된 저장소다. 그 사이 커밋 301개, 릴리스 26번이 나갔다. 좋게 보면 빠르고, 나쁘게 보면 판이 매일 바뀐다. 커밋 301개 중 212개에 Claude Opus 5.5 가 공동 저자로 적혀 있다.

Windows 가 정식이고 macOS 와 Linux 는 미리보기다. macOS 판은 공증 전이라 처음 열 때 직접 허용해야 하고, 도넛을 쓰려면 손쉬운 사용 권한이 필요하다. Linux 는 X11 에서만 끌기가 된다.

실측 정보

HEAD 커밋
ff56a0c (2026-10-17) · 전체 이력 301커밋 · 첫 커밋 2026-09-30 · 저자 표기 3(사실상 1명 + 1명)
스타 / 포크 / 다운로드
3,612 / 192 / 릴리스 에셋 누적 약 6만 5천
규모
522파일 · 텍스트 100,748줄 · C# 403파일 90,363줄 · 가장 큰 파일 src/Filee.Engines/Hwp/Hwpx/HtmlReader.cs 1,143줄
테스트 / CI
테스트 파일 108 · [Fact]·[Theory] 716 · CI 워크플로 3(ci · portable · release)
이슈 응답
표본 25건 중 21건 응답 · 중앙값 6.3시간 · 열린 이슈 30
플랫폼
Windows 10/11 정식 · macOS 14+ · Linux x64/ARM64 미리보기 · .NET 10 · UI 는 Avalonia
HWP
NuGet Unhwp 0.13.0(iyulab, MIT) 위에 HWPX 읽기·쓰기를 직접 구현
네트워크
업데이트 확인(GitHub API) · 추가 엔진 내려받기(필요할 때만, SHA-256 검증) · 통계 수집 코드 없음
라이선스
MIT · 7-Zip(LGPL) · ImageMagick 등 고지는 THIRD-PARTY-NOTICES.md

적용점

  • 쓴다면한컴오피스가 없는 맥이나 리눅스에서 HWP 를 PDF · DOCX 로 바꿀 때. 앱을 안 띄워도 filee convert 파일.hwp --to pdf 한 줄로 된다. 폴더를 지켜보다 들어온 파일을 바로 바꾸는 filee watch 도 있다.
  • 알고 쓸 것이미지를 WEBP · AVIF 로 바꿀 때 기본 품질이 높아 원본 JPG(322KB)보다 커졌다(WEBP 399KB · AVIF 366KB). 용량을 줄이려면 --quality 를 낮춘다.
  • 알고 쓸 것macOS 판은 공증 전이라 처음 열 때 시스템 설정에서 직접 허용해야 하고, 도넛을 쓰려면 손쉬운 사용과 Finder 자동화 권한이 필요하다. 리눅스는 X11 에서만 끌기 동작이 된다.
  • 가져올 생각변환이 여러 단계 필요하면(HWP → HWPX → DOCX) 길을 알아서 찾는다. 무거운 엔진(LibreOffice · FFmpeg · Pandoc · calibre · Ghostscript)은 기본 설치에 넣지 않고 필요할 때 내려받아 SHA-256 으로 확인한다.
◆ 도입 후보

도입 후보. 한국에서 파일 변환기를 고를 때 가장 막히는 HWP 를 한컴오피스 없이, 업로드 없이 바꾼다. macOS 판 명령줄로 직접 돌려 보니 우리가 쓴 안내문이 마크다운에서 HWPX, HWP, PDF, DOCX 로 표와 목록까지 그대로 넘어갔고 한 번에 0.2~0.6초였다. 공개 HWP 표본 7쪽도 PDF · DOCX · HWPX · 마크다운 · PNG 로 모두 나왔다. 테스트 716개와 CI 셋, 엔진 내려받기의 SHA-256 검증, 통계 수집 코드가 없는 점도 믿을 근거다. 다만 세 가지는 알고 쓴다. 9월 30일에 시작한 3주 된 저장소인데 릴리스가 벌써 26번이라 판이 매일 바뀐다. HWP 표본 1쪽 제목에 원본에 없어 보이는 회색 띠와 점이 끼었고, 원본을 한컴오피스로 열어 대조하지는 못했다. 이 저장소의 얼굴인 도넛 화면은 맥미니(화면 없는 서버)에서 띄우지 못해 확인하지 못했다.

의견

판정에 대한 반론, 도입 경험, 정정 제보를 환영합니다. GitHub 계정으로 참여합니다.

이것도 재봤습니다

전체 리포트 →