Avenox Studio — 운영자 라우터
로컬 우선, 에이전트 운영 비디오 파이프라인을 위한 빠른 운영자 가이드입니다. 모든 것은 사용자의 로컬 머신에서 실행됩니다: 클라우드 편집기나 업로드-투-렌더(upload-to-render)가 없습니다.
사람은 감독하고 품질을 승인합니다; 에이전트는 파이프라인을 운영합니다.
설정
export STUDIO_JOBS="$HOME/video/projects" # 무거운 미디어 파일이 있는 곳
export STUDIO_ROOT="/path/to/this/repo" # 스크립트, 템플릿, 브랜드 파일
요구 사항: macOS (h264_videotoolbox를 통한 하드웨어 인코딩; mlx-whisper를 위한 Apple Silicon), ffmpeg, python3, melt/MLT, Node (HyperFrames용). 대부분은 libx264와 대체 CUDA whisper 빌드를 사용하여 Linux에서도 작동합니다.
운영 원칙
- 미디어 규율. 무거운 미디어는 절대 클라우드 동기화 폴더에 두지 마십시오 — 동기화는 수 GB 중간 파일을 처리할 때 심하게 부하를 주고 쓰기 중인 파일을 손상시킬 수 있습니다. 작업은 $STUDIO_JOBS// (raw/ cut/ graphics/ audio/ outputs/) 안에 있습니다. 메모 시스템에는 핵심만 저장합니다: 이 시스템, 브랜드 사양, edit.json 계획.
- 감독 루프. 미리보기를 생성(그래픽 스틸 + 빠른 드래프트 렌더) → 피드백 전송 → 그 후에만 최종 렌더링합니다. 승인 없이 최종본을 절대 보내지 마십시오. 이것이 가장 중요한 규칙입니다; 검토되지 않은 최종본을 렌더링하는 에이전트는 거부된 컷에 몇 시간을 소모할 것입니다.
- 브랜드는 제안이 아니라 엄격한 제약 사항입니다. 그래픽을 만들기 전에 brand/frame.md를 읽으십시오. 한 번 정의하고 고정하십시오. (참조 구현은 의도적으로 'AI 슬롭'과 반대입니다: 프리미엄 편집, 따뜻한 종이 + 잉크 + 단일 악센트, 네온/그라데이션/글라스모피즘/3D 광택 없음.)
- 포맷: YouTube 16:9 1080p60. brand/presets/youtube-16x9.json에 사전 설정.
- 마감은 하이브리드입니다. 드래프트를 자동 생성; 동일한 .mlt 파일이 Kdenlive 또는 Shotcut에서 열려 수동 마감할 수 있습니다. 취향을 자동화하려 하지 마십시오.
- 전사 기본값은 로컬 mlx-whisper와 whisper-large-v3-turbo를 사용합니다 — 빠르고, 무료이며, 비영어 오디오에 강력합니다. 대부분의 LLM 라우팅 프록시는 whisper 엔드포인트를 노출하지 않습니다; 원격으로 전환하는 경우 전용 음성 API를 사용하십시오.
스크립트 (scripts/)
| 스크립트 | 기능 |
|---|---|
| autocut.sh IN.mp4 [balanced | aggressive |
| transcribe.py IN.mp4 PREFIX | → transcript/PREFIX_timed.json + _narration.txt |
| mltgen.py edit.json out.mlt --base | 편집 목록 → MLT 프로젝트 (Kdenlive/Shotcut/melt) |
| vrender.sh project.mlt out.mp4 [fast | quality] |
| grabshot.sh | 클립보드 스크린샷 → 디스크 |
| slides2png.sh | 레거시 정적 슬라이드 — HyperFrames 선호 |
| remove-silence.py | 독립 무음 제거 패스 |
7단계
- 인테이크 — 원본 파일 복사 → $STUDIO_JOBS//raw/. 브리프와 실제로 중요한 세그먼트를 확인합니다.
- 러프 컷 — autocut.sh raw.mov balanced → cut/screen_cut.mp4; 스크립트를 위해 transcribe.py 실행. 전체 레시피 → avenox-roughcut 스킬.
- 그래픽 — HyperFrames. hyperframes 스킬을 통해 라우팅 → 일반적으로 motion-graphics (짧은 비트), faceless-explainer (개념 설명), 또는 general-video. 먼저 brand/frame.md를 읽고; 애니메이션 MP4를 graphics/에 렌더링합니다. 전체 레시피 → avenox-graphics 스킬.
- 조립 — cut/.mp4 + graphics/.mp4 + 음악을 혼합하여 edit.json 작성 (templates/edit.json에 템플릿 있음) → mltgen.py edit.json project.mlt --base .
- 자막 — transcribe.py → .srt; brand/caption-corrections.json 적용 (caption-corrections.example.json에서 복사 — ASR이 자주 망가뜨리는 용어를 찾아 바꾸는 맵입니다). YouTube CC로 제공하고, 화면에 박지 마십시오.
- 음악 — 모든 것 아래에 배경 음악을 깔고, 음성 아래에서 사이드체인 덕킹, 목표 ~-14 LUFS. CREDITS.md에 속성을 기록합니다.
- 내보내기 — vrender.sh project.mlt draft.mp4 fast → 감독 검토 → vrender.sh … final.mp4 quality → 임시 파일 정리.
그래픽 품질 기준
HyperFrames 클립은 brand/frame.md를 따라야 합니다. 유형 중심, 절제되고 무게감 있는 움직임을 선호합니다. 비트에 움직임이 필요하지 않다면 깔끔한 정적 프레임도 괜찮습니다 — 애니메이션을 위해 애니메이션을 만들지 마십시오.
참고
- 러프 컷: avenox-roughcut · 그래픽: avenox-graphics
- HyperFrames 스킬: hyperframes (라우터), hyperframes-cli, hyperframes-animation, hyperframes-creative, motion-graphics, faceless-explainer, general-video
- 브랜드 사양: brand/frame.md (brand/frame.template.md에서 채워 넣기)