george-blaze/srtc

SRTC — Screen Recording To Claude (Bildschirmaufnahme für Claude)

SKILL_DIR ist das Verzeichnis, das diese SKILL.md enthält (normalerweise ~/.claude/skills/srtc). Jeder folgende Befehl wird von dort aus ausgeführt. Das Tool ist python3 "$SKILL_DIR/vtc.py"; die Aufbereitungs-Engine ist python3 "$SKILL_DIR/screencast/screencast.py".

Was es tut

• ⌃⌘S startet/stoppt eine Bildschirm- + Mikrofonaufnahme (Menüleisten-Agent vtc-hotkey). Esc bricht ab. 10-Minuten-Begrenzung mit einem 20-Sekunden-Countdown-Ton + rotem Panel.
• Beim Stoppen: 1 fps Abtastung → unveränderte Sekunden weglassen → 2×2 zeitgestempelte Sheets; Mausprotokoll → gezoomte „Pointer-Sheets" für eingekreiste / verweilte / angeklickte Stellen; Whisper (lokal, streamend während der Aufnahme) → zeitgestempeltes Transkript.
• Zustellung: bringt Claude in den Vordergrund und fügt Bilder gefolgt vom Prompt in den offenen Chat ein (Benutzer drückt Enter).
• Eine Regel in ~/.claude/CLAUDE.md (installiert aus claude-rule.md) macht die Erzählung zur Anfrage.

Befehle

Frage	Ausführung
Status / Läuft eine Aufnahme?	python3 "$SKILL_DIR/vtc.py" status
Vorhandene Aufnahme aufbereiten (beliebige .mov/.mp4)	python3 "$SKILL_DIR/screencast/screencast.py" digest "<datei>" → dann Lies das ausgegebene DIGEST.md, dann jedes Blatt in sheets/ und pointer/
Speichernutzung	python3 "$SKILL_DIR/vtc.py" usage
Alte Aufnahmen bereinigen / Alles bereinigen	python3 "$SKILL_DIR/vtc.py" clean / python3 "$SKILL_DIR/vtc.py" clean --all
Tastaturkürzel / Mikrofon / Begrenzung / Aufbewahrung ändern	Bearbeite ~/.config/vtc.json (Schlüssel: hotkey, mic, cap_seconds, warn_seconds, keep_days, deliver, auto_send, asr), dann launchctl kickstart -k gui/$(id -u)/com.srtc.hotkey
Installieren / Neuinstallieren	"$SKILL_DIR/install.sh" (der Benutzer muss es ausführen: es registriert einen Login-Agenten und ein Schlüsselbund-Zertifikat)

Wenn der Benutzer eine Frage zu einer gerade gemachten Aufnahme stellt, befindet sich der Aufbereitungsordner unter recordings/<datum>.digest/ neben dem Video (Standard ~/Movies/SRTC/, oder recordings in ~/.config/vtc.json): lies zuerst DIGEST.md, dann die darin aufgeführten Blätter.

Fehlerbehebung (in dieser Reihenfolge prüfen)

1. Tastaturkürzel tot, Menüleiste sagt „Hotkey blocked: password field" → Eine App hält die sichere Tastatureingabe (ein fokussiertes Passwortfeld, oft im Browser). Klicke aus ihr heraus. ioreg -l -w 0 | grep -o '"kCGSSessionSecureInputPID"=[0-9]*' nennt die PID.
2. Tastaturkürzel tot, Log sagt „not trusted" (~/Library/Application Support/VideoToClaude/hotkey.log) → Berechtigung für Bedienungshilfen verloren (passiert nach einem Neubau ohne sign.sh). Systemeinstellungen → Datenschutz & Sicherheit → Bedienungshilfen: entferne vtc-hotkey (−), füge es wieder hinzu (+ oder ziehe die Binärdatei hinein). Der Agent bewaffnet sich innerhalb von 2 s.
3. „Nothing was recorded" → Bildschirmaufnahme- oder Mikrofonberechtigung für vtc-hotkey fehlt; Bildschirmaufnahme gilt erst nach launchctl kickstart -k gui/$(id -u)/com.srtc.hotkey.
4. Transkript leer oder Müll → Prüfe die Zeile „audio peak / average" im Digest; unter −40 dB Durchschnitt bedeutet falsches Mikrofon. mic in ~/.config/vtc.json ist eine Prioritätenliste; python3 "$SKILL_DIR/screencast/screencast.py" devices listet Geräte auf.
5. Transkript OK aber spät → Whisper-Modell fehlt (models/whisper-large-v3-turbo/weights.safetensors); siehe README. Logs: ~/Library/Application Support/VideoToClaude/{hotkey,runner,asr,recorder-ffmpeg}.log.

Führe niemals install.sh, sign.sh oder launchctl bootstrap selbst aus; zeige den Befehl an und lass den Benutzer ihn ausführen.