내 사운드팩
만들기

먼저 알림에 사용할 음성/사운드 파일을 준비하세요. 보통 5–15초 분량의 짧은 클립 6~10개면 충분합니다.

4가지 방법 중 선택

say -v Yuna -o start.aiff "작업을 시작합니다"
afconvert start.aiff start.mp3 -d aac -f m4af

파일 형식 요구사항

• 지원 포맷: .mp3 / .wav / .ogg
• 파일당 최대 1MB
• 전체 팩 최대 50MB
• 파일명: 영문/숫자/하이픈/언더스코어만 (한글 X)
• 권장 길이: 1~5초

크로마이핑은 사용자가 만든 팩을 직접 호스팅하지 않고, 각자의 GitHub 저장소를 인덱싱합니다. 그래서 GitHub 에 새 저장소를 만들어야 해요.

2-1. GitHub.com 에서 새 저장소 만들기

1. github.com/new 접속
2. Repository name: cromaiping-내팩이름 (예: cromaiping-mypack)
3. Public 선택 (Private 은 cromaizing 이 접근 불가)
4. “Create repository” 클릭

2-2. 로컬에 클론

git clone https://github.com/<본인-사용자명>/cromaiping-mypack.git
cd cromaiping-mypack

크로마이핑(과 다른 호환 도구)이 팩을 인식할 수 있도록 openpeon.json 매니페스트 파일을 만들어야 합니다. 손으로 쓸 수도 있지만, 자동 생성 도구를 강력 추천합니다.

방법 A: 자동 도구 사용 (추천 ⭐)

크로마이핑 자체 스크립트로 텍스트 파일 1개만 작성하면 모든 게 자동으로 만들어집니다.

# 1. 크로마이핑 설치 (한 번만)
brew install cromaizing/tap/cromaiping

# 2. 템플릿 가져와서 편집
curl -O https://raw.githubusercontent.com/cromaizing/cromaiping/main/templates/pack-template.txt
# 텍스트 에디터로 pack-template.txt 편집

# 3. 자동 빌드
bash <(curl -fsSL https://raw.githubusercontent.com/cromaizing/cromaiping/main/scripts/make-pack.sh) pack-template.txt

이미 음원 파일이 있다면? import-pack.sh

녹음/합성 끝난 음원이 이미 있으면 폴더 통째로 변환:

# 폴더에 음원 파일 정리:
#   ./my-pack/session.start.mp3
#   ./my-pack/task.complete.mp3
#   ./my-pack/task.error.mp3
#   ...

bash <(curl -fsSL https://raw.githubusercontent.com/cromaizing/cromaiping/main/scripts/import-pack.sh) mypack ./my-pack/ "내 팩 표시명"

방법 B: 직접 작성

편한 대로 openpeon.json 직접 작성도 가능. 최소 형식:

{
  "cesp_version": "1.0",
  "name": "mypack",
  "display_name": "내 팩",
  "version": "1.0.0",
  "description": "한국어 AI 음성팩",
  "language": "ko",
  "license": "CC-BY-NC-4.0",
  "author": { "name": "내 이름" },
  "categories": {
    "session.start": { "sounds": [
      { "file": "sounds/start.mp3", "label": "세션 시작" }
    ]},
    "task.complete": { "sounds": [
      { "file": "sounds/done.mp3", "label": "작업 완료" }
    ]}
  }
}

최종 폴더 구조

cromaiping-mypack/
├── openpeon.json          # 매니페스트 (필수)
├── sounds/                # 음원 폴더
│   ├── start.mp3
│   ├── done.mp3
│   ├── error.mp3
│   └── ...
├── README.md             # 선택 (팩 설명)
└── LICENSE               # 선택 (라이선스 명시)

저장소에 파일을 올립니다. Git 명령 3줄.

git add -A
git commit -m "Initial commit: 내 첫 크로마이핑 팩"
git push origin main

(선택) 버전 태그 만들기

나중에 업데이트 추적하려면 태그 추천:

git tag -a v1.0.0 -m "v1.0.0 첫 릴리즈"
git push origin v1.0.0

여기까지 왔으면 다 끝났어요. 마지막은 진짜 30초:

1. /cromaiping/submit 페이지 접속
2. 로그인 (회원가입 시 핸드폰 인증)
3. GitHub 저장소 URL 입력 (예: https://github.com/내사용자명/cromaiping-mypack)
4. [검증하기] 클릭 → 자동 검증 + 미리보기
5. [즉시 등록하기] 클릭
6. 끝! 마켓플레이스에 즉시 노출

등록 후 자동으로 일어나는 일

• 📰 자동 게시글 생성 (제목/설치 가이드/미리듣기 자동 작성)
• 🌐 다른 사용자가 cromaiping packs install <팩이름> 으로 즉시 설치 가능
• 💬 댓글/별점/신고 시스템 활성화
• 📊 다운로드 카운트 자동 집계