데모 비디오: 녹화, 편집, 내레이션, 자막, GIF
화면에서 실제 워크플로(터미널, 브라우저, 앱)를 다음으로 변환합니다:
- 유튜브 컷: TTS 음성 해설이 포함된 MP4, 자막은 따로 제공(
.en.srt) - 하이라이트 GIF: 핵심 단계만, 무음, 자막 없음, README에 넣기에 충분히 작은 크기
- 선택적으로 자막이 포함된 MP4(자막 지원이 없는 플랫폼용)
scripts/ 디렉토리의 스크립트는 템플릿입니다. 비디오 폴더에 복사하여(녹화 파일은 수백 MB이므로 리포지토리 외부) 설정 블록을 편집하세요. 필요한 것: ffmpeg(PATH에 있거나 FFMPEG/FFPROBE 환경 변수), Python 3, pip install edge-tts (음성용).
1. 사람과 계획하기
- 스토리를 단계별로 정하고, 어떤 단계가 사용자(클릭, 타이핑)의 것인지 vs. 대기 단계인지 확인합니다. 무엇을 눌러야 하는지 단계 목록을 작성하여 사용자가 녹화 중에 조작할 수 있도록 합니다.
- 주제(이슈, 할 일)를 선택하여 시각적으로 보여줄 수 있도록 합니다.
- 무대를 정리합니다: 데모가 생성하는 것의 중복을 제거하고, 개인 탭을 닫고(새 브라우저 창을 열어 해당 사이트만 띄움), 알림을 숨깁니다. 방해가 되는 요소(업데이트 배너 등)에 대해 언급합니다.
- 사용자가 녹화 중에 Claude에게 입력하는 모든 내용이 화면에 보인다는 점을 알려주고, "다음" / "완료" 정도로만 유지하도록 합니다.
2. 두 창을 하나의 캡처 박스에 배치하기
데모에 사용되는 모든 창을 정확히 동일한 사각형(1920×1080이 기본값)에 배치하고 해당 박스를 녹화합니다: 앞에 있는 창이 장면이 되므로, 창 전환이 편집이 됩니다.
Windows에서는 scripts/rec.ps1 place -X <px> -Y <px> 명령을 사용합니다. 주의할 점:
- DPI 스케일링: DPI 인식 프로세스가 아닌 곳에서 좌표를 가져오면 스케일링됩니다(125%에서 "1920" 창은 실제 1536픽셀).
place는 모니터별 DPI 인식(SetThreadDpiAwarenessContext(-4))을 설정하므로 모든 것이 물리적 픽셀입니다.rec.ps1 monitors로 모니터를 나열하세요. - 보이지 않는 테두리: Windows 10/11 창에는 약 7픽셀의 투명 테두리가 있습니다. DWM 표시 경계(
DWMWA_EXTENDED_FRAME_BOUNDS)로 크기를 측정하고,GetWindowRect는 사용하지 마세요.place가 측정 및 보정합니다. - 녹화 전에 한 프레임을 캡처하여 확인하세요(PNG 파일 읽기).
3. 녹화하기
scripts/rec.ps1 start <이름> / stop / mark <텍스트> 명령을 사용합니다. 참고:
- gdigrab은 DPI 인식이 아니며 스케일링된 모니터에서 축소된 데스크톱을 캡처합니다(
__COMPAT_LAYER=HighDpiAware로도 해결되지 않음). Desktop Duplication(ddagrab)을 사용하세요. 이는 모니터당 기본 픽셀을 제공합니다.offset_x/y는 해당 모니터를 기준으로 합니다. - 두 번째 GPU(노트북 + 외부 디스플레이)에 연결된 모니터는 어댑터 0에 없습니다:
-init_hw_device d3d11va=dx:<adapter> -filter_hw_device dx를-filter_complex의ddagrab=output_idx=<n>와 함께 사용하세요.rec.ps1 start는-Adapter와-Output을 인수로 받습니다. "Failed to enumerate DXGI output" 오류 발생 시 0/1을 시도해보세요. - MPEG-TS(
-f mpegts) 형식으로 기록하세요. 프로세스를 종료하여 녹화를 중단하면 MP4/MKV는 헤더가 손실됩니다. - 자연스러운 중단점(설정 / 사용자 입력 / 긴 대기)에서 클립을 분할합니다. 느린 프로세스의 긴 테이크는 괜찮습니다. 편집 시 대기 구간을 빠르게 합니다.
- 사용자가 조작하는 동안, 각 백그라운드 단계에서 보고하는 내용과 다음에 눌러야 할 것을 간략히 전달합니다.
4. 순간 찾기
비디오를 스크러빙하지 마세요. 타임스탬프가 있는 콘택트 시트를 생성하여 읽습니다:
python scripts/sheets.py <clip.ts> --every 10 (전체 클립), 그 다음 각 클릭 주변에서 --from 170 --to 236 --every 2 --crop 900:560:1020:0로 제안이 나타나거나, 버튼이 눌리거나, 페이지가 로드되는 정확한 초를 찾습니다.
각 단계에 대해 (클립, 시작, 종료)를 기록하고, 대기 구간도 표시합니다.
5. 내레이션
lines.txt: 각 장면(스토리의 한 단계)당 한 줄씩, 자막 텍스트로 작성합니다. 구어체 영어, 짧은 문장, '무엇' 뿐만 아니라 '이유'를 설명합니다. voice.py에는 기호를 어떻게 발음할지(#92 → "ninety-two", /goal-new → "goal new", CI → "C I") 매핑된 SAY 맵이 있습니다. 자막은 원본을 유지합니다. 기본 음성은 en-US-AndrewNeural (+4%). 음성 목록은 python -m edge_tts --list-voices로 확인합니다. 특정 줄만 다시 음성화하려면 --only N을 사용합니다.
6. 빌드
scripts/build.py: SCENES는 장면 목록이며, 각 장면은 세그먼트 (clip, start, end, speed)의 목록입니다:
- 사용자의 클릭은 1–2배속; 브라우저 페이지는 2–4배속; 머신 작업은 6–40배속으로,
▶▶ N×배지 표시(속도가 3 이상일 때 그려짐); LEAD + 해당 줄 길이 + TAIL보다 짧은 장면은 마지막 프레임을 유지(tpad)하여 음성이 넘치지 않도록 합니다;- 출력물:
youtube/<이름>-youtube.mp4(비디오 + 음성,-c copy),youtube/<이름>-youtube.en.srt(각 줄이 약 70자 단위로 분할되어 문자 비율로 시간 조정), 썸네일. --burn플래그를 사용하면<이름>-captioned.mp4에 자막이 포함된 버전도 생성합니다.- 목표 길이는 1.5–3.5분입니다. 내레이션 사이에 긴 침묵이 생기면 단어를 늘리는 대신 장면 속도를 높이세요.
7. GIF
GIF는 비디오를 그대로 축소한 것이 아닙니다. 핵심 단계만 포함합니다. scripts/gif.py: HIGHLIGHTS = (clip, start, end, speed, crop), 각각 3–7초, 크롭(프레임의 1280×720 영역: 창, 웹 페이지, 메뉴) 후 960×540, 8fps, 단일 팔레트(palettegen stats_mode=diff, paletteuse dither=none diff_mode=rectangle). 자막, 배지 없음. 10MB(GitHub 이미지 제한) 이하, 약 60초 이내로 유지합니다. 각 하이라이트의 마지막 프레임을 타일로 배열하여 이미지를 읽어 확인합니다.
8. 전달
비디오 폴더에 README.md를 작성합니다: 비디오 내용, 출력물 표, 각 소스/스크립트 설명, 녹화자의 프레임 및 캡처 관련 특이사항, 재빌드 방법(음성 재생성 → 빌드 → gif)을 포함합니다. 폴더 위치를 기억에 저장하겠다고 제안합니다.