FUN SFX
이 폴더를 스킬 루트로 사용하세요. 명령을 실행하기 전에 해당 위치를 확인하세요. 사용자의 작업 디렉터리가 다른 곳에 있을 수 있습니다. Python 3.10+가 검색을 지원하며, 오디오 내보내기에는 FFmpeg가 PATH에 있어야 합니다.
사운드 찾기
python3 <skill-root>/scripts/sfx.py search "whoosh" --json을 실행하면 절대 오디오 경로가 포함된 후보 목록을 얻을 수 있습니다. 검색은 "failed attempt"나 "photo capture"와 같은 장면 설명도 허용합니다. 제목, ID, 카테고리, 태그, 권장 사용처, 예제와 매칭되며, 여러 단어는 모두 일치해야 합니다. 부정적인 가이드는 의도적으로 제외됩니다. 전체 컬렉션을 보려면 list --json을, 전체 레코드를 보려면 show <id>를 실행하세요. 사람이 읽을 수 있는 개요는 카탈로그를 참조하세요.
제공된 모든 녹음에는 개별 사용 사례 가이드가 있습니다: 권장 장면, 타이밍, 피해야 할 상황, 편집 예제가 포함됩니다. 단순히 카테고리와 일치시키는 것이 아니라 레코드의 usage 필드를 사용하여 장면에 맞는 사운드를 선택하세요. 이는 창의적인 권장 사항이지 필수 사용은 아닙니다.
태그는 파일 이름에서 파생됩니다. audio_review.status를 확인하세요: 7개의 녹음에는 자동 오디오 분석 노트가 있고, 나머지 64개는 파일 이름 기반 권장 사항이며 청각 내용이 확인되지 않았습니다. 자동 노트도 음성을 잘못 들을 수 있으니 audio_review.uncertainty에 주의하세요. 어떤 녹음도 사람이 직접 청취했다고 주장하지 않습니다. 후보를 선택하기 전에 반드시 미리 들어보세요. 특히 Walmart, Whoop, Spotlight와 같은 모호한 이름은 더 주의하세요. 파일에는 음성, 음악, 무음, 여러 효과, 또는 갑작스러운 볼륨 변화가 포함될 수 있습니다. 시네마틱 휙 컬렉션과 긴 공포 클립은 선택된 부분만 발췌해야 합니다. 타이밍 가이드는 시각적 동작을 기준으로 하며, 검증된 인/아웃 포인트가 아닙니다.
큐 준비하기
python3 <skill-root>/scripts/sfx.py export <id> /absolute/output/cue.wav --start 0.2 --duration 0.8 --gain-db -8 --fade-ms 10
출력은 48kHz 스테레오 PCM WAV입니다. --start는 소스 오프셋이며, 타임라인 배치는 별도의 편집입니다. 명령은 기존 출력 파일이 있으면 거부합니다. 원본 녹음은 그대로 유지하세요. 적당한 게인을 사용하고, 대화 명료성을 유지하며, 최종 믹스를 반드시 미리 들어보세요. 하나의 볼륨 설정이 모든 녹음에 적합하지는 않습니다.
준비된 큐를 배치하려면 사용자의 기존 비디오 편집기 또는 편집 도구를 사용하세요. 큐 시트 필드, 타이밍 가이드 및 FFmpeg 혼합 예제는 editing.md를 참조하세요. 선택한 ID, 소스 발췌 부분, 타임라인 위치 및 게인을 기록하여 편집이 재현 가능하도록 하세요. 모든 컷에 기본적으로 사운드를 추가하지 마세요.
권리 및 무결성
FUN SFX 유지관리자는 번들된 사운드를 소유하지 않습니다. 모든 권리는 해당 소유자에게 있습니다. 사운드 컬렉션을 제공하거나 패키징할 때 이 소유권 표시를 유지하세요.
코드와 문서는 MIT 라이선스로 제공됩니다. 번들된 녹음 및 추출된 오디오는 확인되지 않은 권리가 있으며 해당 라이선스에서 제외됩니다. ASSET_LICENSE.md를 참조하세요. 녹음물을 MIT, 로열티 프리 또는 재배포가 허가된 것으로 설명하지 마세요. 파일 이름에 "저작권 없음"이 포함되어 있다고 해서 라이선스 증거가 되지는 않습니다. 편집물을 인계하거나 이 스킬을 패키징할 때 이 구분을 유지하세요.
다운로드 또는 수정된 팩을 확인할 때 python3 <skill-root>/scripts/sfx.py verify를 실행하세요. catalog.json은 모든 원본 및 사용 가능한 오디오 파일에 대한 포터블 경로, 기술 메타데이터 및 SHA-256 체크섬을 보유합니다.