Que fait SRTC — Enregistrement d'écran pour Claude ?
SKILL_DIR est le répertoire contenant ce SKILL.md (normalement ~/.claude/skills/srtc). Toutes les commandes ci-dessous s'exécutent depuis ce répertoire. L'outil est python3 "$SKILL_DIR/vtc.py" ; le moteur de digestion est python3 "$SKILL_DIR/screencast/screencast.py".
Ce qu'il fait
⌃⌘Sactive/désactive un enregistrement d'écran + microphone (agent de la barre de menusvtc-hotkey).Escannule. Limite de 10 minutes avec un signal sonore de 20 secondes et un panneau rouge.- À l'arrêt : échantillonnage à 1 ips → secondes inchangées supprimées → feuilles horodatées 2×2 ; journal de souris → "feuilles de pointeur" zoomées pour les zones entourées/survolées/cliquées ; Whisper (local, streaming pendant l'enregistrement) → transcription horodatée.
- Livraison : amène Claude au premier plan et colle les images puis la requête dans la conversation ouverte (l'utilisateur appuie sur Entrée).
- Une règle dans
~/.claude/CLAUDE.md(installée depuisclaude-rule.md) fait de la narration la requête.
Commandes
| Demande | Exécutez |
|---|---|
| statut / est-ce que ça enregistre | python3 "$SKILL_DIR/vtc.py" status |
| digérer un enregistrement existant (tout .mov/.mp4) | python3 "$SKILL_DIR/screencast/screencast.py" digest "<fichier>" → puis Lisez le DIGEST.md imprimé, puis chaque feuille dans sheets/ et pointer/ |
| utilisation du stockage | python3 "$SKILL_DIR/vtc.py" usage |
| nettoyer les anciennes prises / tout nettoyer | python3 "$SKILL_DIR/vtc.py" clean / python3 "$SKILL_DIR/vtc.py" clean --all |
| changer le raccourci / micro / limite / conservation | éditez ~/.config/vtc.json (clés : hotkey, mic, cap_seconds, warn_seconds, keep_days, deliver, auto_send, asr), puis launchctl kickstart -k gui/$(id -u)/com.srtc.hotkey |
| installer / réinstaller | "$SKILL_DIR/install.sh" (l'utilisateur doit l'exécuter : il enregistre un agent de connexion et un certificat de trousseau) |
Quand l'utilisateur pose une question sur un enregistrement qu'il vient de faire, le dossier de digestion est recordings/<date>.digest/ à côté de la vidéo (par défaut ~/Movies/SRTC/, ou recordings dans ~/.config/vtc.json) : lisez DIGEST.md d'abord, puis les feuilles qu'il liste.
Dépannage (vérifiez dans cet ordre)
- Raccourci mort, la barre de menus indique "hotkey blocked: password field" → une application détient la saisie clavier sécurisée (un champ de mot de passe focalisé, souvent un navigateur). Cliquez en dehors.
ioreg -l -w 0 | grep -o '"kCGSSessionSecureInputPID"=[0-9]*'donne le pid. - Raccourci mort, le journal indique "not trusted" (
~/Library/Application Support/VideoToClaude/hotkey.log) → l'autorisation d'accessibilité a été perdue (arrive après reconstruction sanssign.sh). Paramètres système → Confidentialité et sécurité → Accessibilité : supprimezvtc-hotkey(−), ajoutez-le à nouveau (+ ou glissez le binaire). L'agent s'arme en 2 s. - "Rien n'a été enregistré" → Autorisation d'enregistrement d'écran ou de microphone manquante pour
vtc-hotkey; l'enregistrement d'écran ne s'applique qu'aprèslaunchctl kickstart -k gui/$(id -u)/com.srtc.hotkey. - Transcription vide ou erronée → vérifiez la ligne "audio peak / average" du digest ; en dessous de −40 dB en moyenne signifie le mauvais micro.
micdans~/.config/vtc.jsonest une liste de priorité ;python3 "$SKILL_DIR/screencast/screencast.py" devicesliste les périphériques. - Transcription OK mais tardive → modèle Whisper manquant (
models/whisper-large-v3-turbo/weights.safetensors) ; voir le README. Journaux :~/Library/Application Support/VideoToClaude/{hotkey,runner,asr,recorder-ffmpeg}.log.
N'exécutez jamais install.sh, sign.sh ou launchctl bootstrap vous-même ; montrez la commande et laissez l'utilisateur l'exécuter.