SRTC — Screen Recording To Claude
SKILL_DIR은 이 SKILL.md가 있는 디렉토리입니다 (일반적으로 ~/.claude/skills/srtc).
아래 모든 명령어는 해당 디렉토리에서 실행됩니다. 도구는 python3 "$SKILL_DIR/vtc.py"이며,
다이제스트 엔진은 python3 "$SKILL_DIR/screencast/screencast.py"입니다.
기능
⌃⌘S를 누르면 화면 + 마이크 녹화가 토글됩니다 (메뉴바 에이전트vtc-hotkey).Esc는 취소합니다. 10분 제한이 있으며, 20초 카운트다운 소리 + 빨간 패널이 나타납니다.- 중단 시: 1fps 샘플링 → 변경되지 않은 초는 제거 → 2×2 타임스탬프 시트; 마우스 로그 → 원형/머무른/클릭한 지점의 확대된 "포인터 시트"; Whisper (로컬, 녹화 중 스트리밍) → 타임스탬프 트랜스크립트.
- 전달: Claude를 전면으로 가져와서 이미지, 이어서 프롬프트를 열린 채팅에 붙여넣습니다 (사용자가 Enter 누름).
~/.claude/CLAUDE.md에 있는 규칙 (claude-rule.md에서 설치)이 내레이션을 요청으로 만듭니다.
명령어
| 질문 | 실행 명령어 |
|---|---|
| 상태 / 녹화 중인가요 | python3 "$SKILL_DIR/vtc.py" status |
| 기존 녹화물 다이제스트 (모든 .mov/.mp4) | python3 "$SKILL_DIR/screencast/screencast.py" digest "<파일>" → 출력된 DIGEST.md를 Read한 다음, sheets/와 pointer/의 각 시트를 읽으세요 |
| 저장 공간 사용량 | python3 "$SKILL_DIR/vtc.py" usage |
| 오래된 녹화물 정리 / 전체 정리 | python3 "$SKILL_DIR/vtc.py" clean / python3 "$SKILL_DIR/vtc.py" clean --all |
| 단축키 / 마이크 / 제한 시간 / 보존 기간 변경 | ~/.config/vtc.json 편집 (키: hotkey, mic, cap_seconds, warn_seconds, keep_days, deliver, auto_send, asr), 그 다음 launchctl kickstart -k gui/$(id -u)/com.srtc.hotkey 실행 |
| 설치 / 재설치 | "$SKILL_DIR/install.sh" (사용자가 직접 실행해야 함: 로그인 에이전트와 키체인 인증서 등록) |
사용자가 방금 만든 녹화에 대해 질문할 때, 다이제스트 폴더는 비디오 옆 recordings/<날짜>.digest/에 있습니다 (기본 경로 ~/Movies/SRTC/ 또는 ~/.config/vtc.json의 recordings): 먼저 DIGEST.md를 읽고, 그 다음 나열된 시트들을 읽으세요.
문제 해결 (이 순서대로 확인하세요)
- 단축키가 작동 안 함, 메뉴바에 "hotkey blocked: password field" → 어떤 앱이 보안 키보드 입력을 잡고 있음 (비밀번호 입력창, 주로 브라우저). 그 창에서 포커스를 벗어나세요.
ioreg -l -w 0 | grep -o '"kCGSSessionSecureInputPID"=[0-9]*'가 PID를 알려줍니다. - 단축키가 작동 안 함, 로그에 "not trusted" (
~/Library/Application Support/VideoToClaude/hotkey.log) → 손상된 접근성 권한 (sign.sh없이 다시 빌드한 후 발생). 시스템 설정 → 개인정보 보호 및 보안 → 손쉬운 사용:vtc-hotkey를 제거한 후 (−), 다시 추가하세요 (+ 또는 바이너리를 드래그). 에이전트는 2초 안에 활성화됩니다. - "Nothing was recorded" →
vtc-hotkey에 대한 화면 기록 또는 마이크 권한이 없음; 화면 기록은launchctl kickstart -k gui/$(id -u)/com.srtc.hotkey이후에만 적용됩니다. - 트랜스크립트가 비어 있거나 이상함 → 다이제스트의 "audio peak / average" 줄 확인; 평균이 −40dB 미만이면 잘못된 마이크입니다.
~/.config/vtc.json의mic은 우선순위 목록입니다;python3 "$SKILL_DIR/screencast/screencast.py" devices로 장치를 확인하세요. - 트랜스크립트는 정상이지만 늦게 나옴 → Whisper 모델 누락 (
models/whisper-large-v3-turbo/weights.safetensors); README 참조. 로그:~/Library/Application Support/VideoToClaude/{hotkey,runner,asr,recorder-ffmpeg}.log.
install.sh, sign.sh 또는 launchctl bootstrap을 직접 실행하지 마세요; 명령어를 보여주고 사용자가 실행하도록 하세요.