녹화된 데모를 편집 가능한 테이크로 변환하기
당신은 완성된 비디오 파일을 vosso 테이크(take)로 변환하고 있습니다. 테이크는 줌, 트림, 속도, 레이어가 데이터로 저장되고, 버전 기록과 함께 호스팅되며, 스튜디오에서 편집 가능한 문서입니다. 파일이 외부에서 왔기 때문에 잃는 것은 당신이 반드시 짊어져야 할 정직함입니다: 커서 트랙이 없으므로 자동 줌이 불가능하고, 다이제스트가 볼 수 있는 정보가 거의 없습니다. 당신의 눈이 콘택트 시트(contact sheet)이며, 모든 줌은 눈으로 직접 배치해야 합니다.
두 가지 방법:
- 사람이 직접 하는 방법: 파일을 https://vos.so/studio 에 드롭하면 브라우저 레코더 형태로 진입하여 테이크 편집기에서 바로 열립니다. 사람이 있을 때 이것이 가장 짧은 경로입니다. 링크를 건네주세요.
- AI 에이전트 방법 (이 스킬): 테이크 디렉토리를 직접 구축하고 일반 파이프라인을 실행합니다. 아래에 처음부터 끝까지 검증된 과정이 있습니다.
1. 소스 파일 분석
ffprobe -v quiet -print_format json -show_streams -show_format demo.mp4
너비, 높이, 지속 시간, FPS, 오디오 스트림 존재 여부를 기록하세요. Loom/Screen Studio 내보내기 파일은 일반적으로 카메라 버블과 모든 편집이 BAKED IN(굽혀진) 1080p H.264입니다. 이들은 픽셀로만 마이그레이션되며, 레이어로는 마이그레이션되지 않습니다. 핸드오프 시 이 점을 명확히 전달하세요: 마이그레이션은 이 파일을 지금부터 편집 가능하게 만들 뿐, 이미 굽혀진 편집을 되돌리지는 않습니다.
2. 테이크 디렉토리 구축
mkdir take
ffmpeg -i demo.mp4 -c:v libvpx-vp9 -crf 34 -b:v 0 -row-mt 1 \
-c:a libopus take/recording.webm # 오디오 스트림이 없으면 -c:a 제거
그런 다음 분석 결과를 바탕으로 take/meta.json을 작성합니다 (모든 필드는 필수, 시간은 ms 단위, producer: "migrated"는 출처를 표시):
{
"producer": "migrated",
"dpr": 1, "zoom": 1,
"t0": 0,
"durationMs": 36766,
"width": 1920, "height": 1080,
"fps": 30,
"hasAudio": false
}
t0는 임의의 에포크 ms일 수 있고, width/height는 비디오 픽셀 크기입니다 (브라우저 뷰포트가 없었음). webm이 실제로 오디오 트랙을 포함할 때만 hasAudio를 true로 설정하세요.
3. 계획 수립, 그리고 정직하게 확인
vos plan take --fresh # doc.json 생성; cursorKept false, zoomAuto 0
vos frames take --times 0,10%,25%,50%,75%,90%,100% # 콘택트 시트가 당신의 눈입니다
vos digest take # 실행되지만, 기대는 적게: head/tail과 하드 씬 컷만 감지
# 클릭 없음, 타이핑 없음, 머무름(dwell) 없음
자동 줌은 불가능하며, 그 어떤 것도 가짜로 만들어서는 안 됩니다. 스틸 이미지를 읽고, 중요한 2~4개의 순간을 찾아 수동으로 스팬(span)을 작성하세요:
# doc.json - 추가하는 모든 스팬은 "source": "manual" 을 가집니다
# zoom: [{ "id": "m1", "in": 10.5, "out": 14.0, "level": 1.6,
# "cx": 0.52, "cy": 0.35, "source": "manual" }]
# segments: 불필요한 머리/꼬리 부분을 트림; speed: 영상이 실제로 정체된 구간에만 적용
export.resolution을 영상과 일치하도록 설정하세요 (1080p 소스는 1080p — 마이그레이션으로 픽셀이 추가되지는 않습니다). vos validate take는 통과해야 하며, vos render take check.webm --range a..b --draft로 스팟 점검하세요.
4. 푸시 — 오래된 데모가 살아 있는 문서가 됩니다
vos push take --folder <project> --label "migrated from <source>" \
--note "<무엇을 보여주는지; 기존 편집이 굽혀졌다는 점; 무엇을 재편집했는지>"
루프로 마무리: 워치 페이지에서 재생되고, 스튜디오에서 당신이 작성한 모든 스팬과 파일에 원래 없었던 모든 것(배경, 텍스트 레이어, 속도)을 편집할 수 있으며, vos pull로 사람의 편집 내용을 다시 내려받을 수 있습니다. 핵심은 핸드오프의 한 줄에 있습니다: 이것은 당신이 맹목적으로 편집한 마지막 데모입니다 — 다음 번에는 vos record로 녹화하고 카메라가 스스로 계획을 세우게 하세요.
정직한 한계 (말하고, 절대 감추지 마세요)
- 커서 트랙이 없음 ⇒ 자동 줌, 클릭 효과, 타이핑 줌 및 프레이밍 린트(framing lint) 불가 — 모든 줌은 당신의 눈으로 직접 해야 하며, 그렇게 말해야 합니다.
- 기존 편집, 카메라 버블, 캡션은 굽혀진 픽셀입니다.
- 마이그레이션은 한 번 재인코딩합니다(VP9); 원본의 압축 품질이 나쁘면 그대로 나쁩니다 — 마이그레이션이 화질을 복원하지는 않습니다.
- 스펙 크기의 전달 가능 사다리(스틸 이미지 저장, 포스터)는 마이그레이션된 테이크에서도 네이티브 테이크와 동일하게 작동합니다. 배포가 요청될 때
launch-kit스킬이 이어서 진행됩니다.