Reelsmith은(는) 무엇을 하나요?
하나의 사양으로 코드로 비디오 제작: 스크립트 -> 계획 -> 승인 -> 템플릿 렌더링 -> 리뷰 -> 내보내기.
모든 기능이 무료로 오프라인에서 작동합니다. 선택적 키를 사용하면 기능이 추가됩니다.
아래 경로 (scripts/, templates/, references/)는 Reelsmith 폴더를 기준으로 합니다: 이 파일 옆 또는 Grok Bot 박스에서는 /workspace/reelsmith/.
모든 작업 시작
python3 scripts/capabilities.py- ON/OFF 상태를 보여줍니다 (키는 절대 출력하지 않음). 어떤 무료 키가 도움이 될지 한 번 언급하세요 (예: 스톡 비디오용 Pexels). 절대 필수로 요구하지 마세요.- 수집: 목표, 대상, 플랫폼(들), 길이, 브랜드 (
brand.json; 하나를 생성: references/brand-kit.md), 미디어, 음악 선호도, 음성 사용 여부. 불명확한 것만 질문하세요. - 템플릿 (아래) 또는 맞춤 제작을 선택하세요.
작업 분류
| 작업 | 사용 | 참고 자료 |
|---|---|---|
| 런칭 릴, 기능 발표, 프로모 | 템플릿 product-launch (음악 중심) | templates.md, music.md |
| 사진으로 이벤트 하이라이트 | event-recap | templates.md, stock-media.md |
| 고객 인용 / 리뷰 | testimonial | templates.md |
| 티저, "Coming Soon", 날짜 공개 (루프 가능) | countdown-teaser | templates.md |
| 숫자, 리포트 하이라이트, 마일스톤 | stat-callout | templates.md |
| 강연/부스/키오스크 루프, 애니메이션 덱 | slides-presentation (--loop) | templates.md |
| 튜토리얼, 워크스루, 온보딩 (+ YouTube 챕터) | howto-tutorial | templates.md, youtube-publishing.md |
| 자막이 있는 내레이션 제품 설명 | feature-explainer (Remotion; render.sh) | remotion.md |
| 맞춤 키네틱 작품, 오버레이, 알파, GIF | HyperFrames 수동 | hyperframes.md, motion-design.md |
| 다이어그램/수학, Lottie, 사용자 영상 편집, 전사 | Manim, Lottie, auto-editor, parakeet | helpers.md |
| 스크립트 또는 VO 대사 | 2-3개 옵션 + script_lint.py | scriptwriting.md, voiceover.md |
| 자막 (SRT/VTT/ASS, 번인) | captions.py | captions.md |
| 플랫폼 사양, 안전 영역, 전달 파일 | export.py, presets.json | platform-specs.md, loudness-accessibility.md |
| AI B-roll, 이미지, 아바타, AI 음악 (유료) | Fal / Higgsfield, 먼저 견적 | ai-generation.md |
라이선스: HyperFrames는 Apache-2.0입니다. Remotion은 개인 및 최대 3인 팀에게 무료이며, 4인 이상 회사는 라이선스가 필요합니다 (상업용인 경우 한 번 질문). 음악, 스톡, 폰트: 라이선스 적용, 크레딧 표시 (stock.py credit, credits.json).
워크플로우
- 스크립트: 2-3개 옵션 작성 (3초 내 후크, 장면당 하나의 아이디어, 마지막에 CTA) 초당 약 2.5단어 속도; 린트 검사.
- 계획:
reelsmith.py sample TEMPLATE > content.json, 내용을 채운 후,reelsmith.py render --template T --content content.json --brand brand.json --out OUT --dry-run실행. 샷 리스트(장면, 텍스트, VO, 초), 음악 + 라이선스, 음성 (무료 또는 견적), 화면 비율을 보여줍니다. - 승인 (항상) 긴 렌더링 전과 유료 생성 전에.
- 드래프트:
reelsmith.py render … --aspect 16x9,9x16,1x1 --music track.mp3|synth --vo auto --draft. - 리뷰 게이트:
review.py check VIDEO --out OUT/_review --preset P --job OUT/job.json; scenes.jpg, safe.jpg, phone.jpg를 확인하고; 수정 후 프리뷰 전송; 사용자의 승인 시review.py approve실행. - 최종 + 내보내기:
--draft없이 렌더링한 후export.py run VIDEO --preset reels,tiktok,youtube --review OUT/_review --out OUT/delivery실행 (승인 없으면 거부). YouTube:youtube_prep.py(절대 업로드하지 않음). - 전달: 각 파일을 한 줄씩 (화면 비율, 길이, LUFS), 크레딧, AI 공개와 함께 첨부; 재편집 제안.
스크립트 (scripts/)
capabilities.py 기능 on/off | brand.py 검증, 번들, 로고에서, 사이트에서 | reelsmith.py 목록, 샘플, 렌더링, 루프, 이음새 | script_lint.py | beats.py 그리드, 스냅, 맞춤, 합성 | stock.py 검색, 가져오기, 크레딧 (API 키만, --dry-run) | captions.py 생성/번인 | review.py 확인, 승인, 상태 | export.py 실행, 오버레이, 목록, loudnorm | youtube_prep.py | presets.json.
HyperFrames 설정 및 고정: references/hyperframes.md. Kokoro는 HYPERFRAMES_PYTHON=<venv>/bin/python 필요.
규칙
- 키는 플랫폼의 시크릿 프롬프트를 통해서만 환경 변수로 전달; 절대 출력, 로깅, 기록하지 마세요.
REELSMITH_IGNORE_KEYS=1은 무료 경로를 강제합니다. - 유료 음성/AI는 이름이 지정되고
--allow-paid와 키가 존재하며 사용자가 견적을 승인한 경우에만 사용 가능. 거절은 최종적입니다. - 스톡은 API 키를 통한 공식 API로만 사용; 절대 스크래핑하거나 핫링크하지 말고 크레딧 유지.
- 실제 인용, 로고, 얼굴은 허가가 있는 경우에만 사용; 아바타와 음성 복제는 동의 필요; AI 사용 공개.
- 음성이 있는 모든 콘텐츠에 자막; 텍스트는 안전 영역 내에; 최대 3플래시/초; -14 LUFS, 최대 -1 dBTP.
- Remotion 최종본:
export.py loudnorm(자체적으로 노멀라이즈하지 않음). - 절대 자동 게시 또는 업로드하지 않음; 사용자가 직접 업로드할 수 있도록 파일 준비.
오류 처리
OOM: --workers 2 (HyperFrames) / --concurrency=2 (Remotion). Chrome: $HF doctor / npx remotion browser ensure. 빈 HyperFrames 프레임: 타임라인이 일시 중지/등록되지 않았거나 잘못된 에셋 경로. librosa 없음: 비트는 고정 BPM으로 대체 (--bpm 전달). Kokoro 없음: espeak-ng. 401: 시크릿 프롬프트를 통해 키 재요청.
사용자에게 물어볼 때
계획 승인 (항상); 스크립트 선택; 음성 선택; 불명확한 플랫폼, 길이, 브랜드 또는 음악; 유료 생성 (견적 포함); 얼굴 또는 음성 사용 동의; 최종 리뷰 승인; 상업용인 경우 Remotion 인원 수.