# Show GN: 자모야 모여라 - 파일명 자소 분리 해결 도구 (웹/CLI)

> Clean Markdown view of GeekNews topic #8872. Use the original source for factual precision when an external source URL is present.

## Metadata

- GeekNews HTML: [https://news.hada.io/topic?id=8872](https://news.hada.io/topic?id=8872)
- GeekNews Markdown: [https://news.hada.io/topic/8872.md](https://news.hada.io/topic/8872.md)
- Type: show
- Author: [hyunbin](https://news.hada.io/@hyunbin)
- Published: 2023-04-04T10:33:39+09:00
- Updated: 2023-04-04T10:33:39+09:00
- Original source: [jamo.hyunb.in](https://jamo.hyunb.in/)
- Points: 21
- Comments: 10

## Topic Body

macOS Finder에서 지정한 한글 파일 이름은 윈도 등에서 자소가 분리되어 표시됩니다. 이를 해결하는 웹 및 CLI 도구를 제작했습니다. NFD로 인코딩 된 파일명을 NFC로 normalize 하는 방식으로 작동합니다. 모든 변환은 로컬에서 이뤄집니다. (`ㅍㅏㅇㅣㄹㅁㅕㅇ` → `파일명`)  
  
#### 사용 방법  
- 웹: [자모야 모여라](https://jamoya.one/)에 접속해 파일 및 폴더를 끌어다 놓습니다. (jamoya.one)  
- CLI: 다음 명령어를 실행합니다. 디렉터리 내 모든 파일을 확인하고 변환합니다.  
  
---  
  
```bash  
npx jamoya-one@latest # 읽기 전용 - NFD로 인코딩 된 파일을 안내합니다.  
npx jamoya-one@latest --write # 쓰기 - 파일명을 NFC로 인코딩합니다.  
```  
  
CLI는 npm 패키지이므로 Node.js 및 npm을 필요로 합니다. [Node.js 웹사이트](https://nodejs.org/)에서 최신 LTS 바이너리를 다운로드해 설치하거나, [nvm](https://github.com/nvm-sh/)과 같은 버전 관리자를 사용합니다.  
  
#### 추가 링크  
- [GitHub 저장소](https://github.com/hyunbinseo/jamoya.one)  
- [웹 버전 소개](https://github.com/hyunbinseo/jamoya.one#readme)  
- [CLI 소개](https://www.npmjs.com/package/jamoya-one)

## Comments



### Comment 15559

- Author: roxie
- Created: 2023-04-06T16:39:11+09:00
- Points: 1

묻지도 따지지도 않고 다짜고짜 변환된 파일을 다운로드하는 UX가 너무 즐겁네요

### Comment 15563

- Author: hyunbin
- Created: 2023-04-06T17:06:59+09:00
- Points: 1
- Parent comment: 15559
- Depth: 1

긍정적으로 봐주셔서 감사합니다. 변환 내역을 구현할까 했는데, 어차피 다운로드 목록에 다 표시가 되더군요.

### Comment 15513

- Author: letaem77a
- Created: 2023-04-04T14:00:19+09:00
- Points: 1

이름이 귀여워요

### Comment 15514

- Author: hyunbin
- Created: 2023-04-04T14:06:05+09:00
- Points: 1
- Parent comment: 15513
- Depth: 1

감사합니다. 도메인도 직관적이고, SEO도 잘 된 것 같아서 대단히 만족하고 있습니다.

### Comment 15509

- Author: xguru
- Created: 2023-04-04T10:54:59+09:00
- Points: 1

앗 이거 좋네요!   
  
저는 "[맥에서 깨진 한글 파일명 복구하기](https://gluebyte.tumblr.com/post/132268284865)" 의 서비스 스크립트도 자주 사용하는데요.  
혹시 가능하다면 이렇게 서비스로 만들어주시는 것도 나름 편리할 것 같아서 제안 드려봅니다.

### Comment 15520

- Author: nearfall
- Created: 2023-04-05T09:31:31+09:00
- Points: 1
- Parent comment: 15509
- Depth: 1

cli 명령을 오토메티터로 폴더대상 스크립트로 등록하면 될 것 같습니다.

### Comment 15521

- Author: hyunbin
- Created: 2023-04-05T09:37:57+09:00
- Points: 1
- Parent comment: 15520
- Depth: 2

[AppleScript 실행](https://apple.stackexchange.com/a/429463)  
```  
on run {input, parameters}  
  set p to path to me  
  return p  
end run  
```  
  
셸 스크립트 실행  
```  
APP_PATH=$1  
cd "$APP_PATH"  
npx jamoya-one@latest --write  
```  
  
위와 같이 작성하면 되려나요.

### Comment 15510

- Author: hyunbin
- Created: 2023-04-04T11:03:38+09:00
- Points: 1
- Parent comment: 15509
- Depth: 1

의견 감사합니다. 공유해 주신 사례에서 사용되는 'Workflow'를 살펴봤는데, Finder 항목 이름 변경에 다음 기능들만 제공되어서 구현이 어려울 것 같습니다.  
  
- 날짜 또는 시간 추가  
- 텍스트 추가  
- 대소문자 변경  
- 연속된 이름 만들기  
- 텍스트 대치  
- 단일 항목 이름 지정

### Comment 51499

- Author: simnalamburt
- Created: 2026-02-21T02:26:20+09:00
- Points: 1

CLI 버전은 이거 추천합니다 https://github.com/cr0sh/jaso  
  
설치: `brew install simnalamburt/x/jaso`

### Comment 51497

- Author: hyunbin
- Created: 2026-02-20T23:32:59+09:00
- Points: 1

도메인이 변경되었습니다. https://jamo.hyunb.in/