O que SRTC — Gravação de Tela para Claude faz?
SKILL_DIR é o diretório que contém este SKILL.md (normalmente ~/.claude/skills/srtc). Todo comando abaixo é executado a partir daí. A ferramenta é python3 "$SKILL_DIR/vtc.py"; o motor de digestão é python3 "$SKILL_DIR/screencast/screencast.py".
O que faz
⌃⌘Salterna uma gravação de tela + microfone (agente da barra de menuvtc-hotkey).Esccancela. Limite de 10 minutos com um som de contagem regressiva de 20 segundos + painel vermelho.- Ao parar: amostragem de 1 fps → segundos inalterados descartados → folhas com timestamps 2×2; log do mouse → folhas de "ponteiro" ampliadas para pontos circulados / parados / clicados; Whisper (local, streaming durante a gravação) → transcrição com timestamps.
- Entrega: traz o Claude para frente e cola as imagens e depois o prompt no chat aberto (o usuário pressiona Enter).
- Uma regra em
~/.claude/CLAUDE.md(instalada a partir declaude-rule.md) faz a narração ser a solicitação.
Comandos
| Pergunta | Execute |
|---|---|
| status / está gravando | python3 "$SKILL_DIR/vtc.py" status |
| digerir uma gravação existente (qualquer .mov/.mp4) | python3 "$SKILL_DIR/screencast/screencast.py" digest "<arquivo>" → depois Leia o DIGEST.md impresso, em seguida cada folha em sheets/ e pointer/ |
| uso de armazenamento | python3 "$SKILL_DIR/vtc.py" usage |
| limpar gravações antigas / limpar tudo | python3 "$SKILL_DIR/vtc.py" clean / python3 "$SKILL_DIR/vtc.py" clean --all |
| alterar atalho / microfone / limite / retenção | edite ~/.config/vtc.json (chaves: hotkey, mic, cap_seconds, warn_seconds, keep_days, deliver, auto_send, asr), depois launchctl kickstart -k gui/$(id -u)/com.srtc.hotkey |
| instalar / reinstalar | "$SKILL_DIR/install.sh" (o usuário deve executar: registra um agente de login e um certificado no keychain) |
Quando o usuário fizer uma pergunta sobre uma gravação que acabou de fazer, a pasta de digestão é recordings/<data>.digest/ ao lado do vídeo (padrão ~/Movies/SRTC/, ou recordings em ~/.config/vtc.json): leia DIGEST.md primeiro, depois as folhas que ele lista.
Solução de problemas (verifique nesta ordem)
- Atalho não funciona, barra de menu diz "hotkey blocked: password field" → algum aplicativo mantém entrada de teclado segura (um campo de senha focado, geralmente um navegador). Clique fora dele.
ioreg -l -w 0 | grep -o '"kCGSSessionSecureInputPID"=[0-9]*'mostra o pid. - Atalho não funciona, log diz "not trusted" (
~/Library/Application Support/VideoToClaude/hotkey.log) → permissão de Acessibilidade perdida (acontece após reconstruir semsign.sh). Ajustes do Sistema → Privacidade e Segurança → Acessibilidade: removavtc-hotkey(−), adicione novamente (+ ou arraste o binário). O agente se ativa em 2 s. - "Nada foi gravado" → Permissão de Gravação de Tela ou Microfone ausente para
vtc-hotkey; Gravação de Tela só se aplica apóslaunchctl kickstart -k gui/$(id -u)/com.srtc.hotkey. - Transcrição vazia ou com lixo → verifique a linha "audio peak / average" do digest; média abaixo de −40 dB significa microfone errado.
micem~/.config/vtc.jsoné uma lista de prioridades;python3 "$SKILL_DIR/screencast/screencast.py" deviceslista dispositivos. - Transcrição OK mas atrasada → modelo Whisper ausente (
models/whisper-large-v3-turbo/weights.safetensors); veja o README. Logs:~/Library/Application Support/VideoToClaude/{hotkey,runner,asr,recorder-ffmpeg}.log.
Nunca execute install.sh, sign.sh ou launchctl bootstrap você mesmo; mostre o comando e deixe o usuário executar.