schnippo 0.11.0__tar.gz

schnippo-0.11.0/PKG-INFO

@@ -0,0 +1,208 @@
+Metadata-Version: 2.4
+Name: schnippo
+Version: 0.11.0
+Summary: KI-Rohschnitt für DaVinci Resolve: MCP-Server für Rohschnitte per Chat
+Keywords: mcp,davinci resolve,video editing,rough cut,transcript
+Author: Seitz Dominik Visuals
+License-Expression: MIT
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: MacOS X
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Natural Language :: German
+Classifier: Operating System :: MacOS
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Multimedia :: Video :: Non-Linear Editor
+Requires-Dist: httpx>=0.28.1
+Requires-Dist: mcp[cli]>=2.3.0
+Requires-Dist: numpy>=2.5.4
+Requires-Dist: opencv-python-headless>=4.10,<5
+Requires-Dist: pillow>=13.0.0
+Requires-Dist: portable-ffmpeg-full==0.5.0
+Requires-Dist: pydantic>=2.14.2
+Requires-Dist: python-docx>=1.2.0
+Requires-Dist: rapidfuzz>=3.14.6
+Requires-Dist: playwright==1.64.1 ; extra == 'motion'
+Requires-Python: >=3.14, <3.16
+Project-URL: Homepage, https://schnippo.com
+Project-URL: Repository, https://github.com/Seitzdominik/schnippo
+Project-URL: Issues, https://github.com/Seitzdominik/schnippo/issues
+Provides-Extra: motion
+Description-Content-Type: text/markdown
+
+# Schnippo
+
+**KI-Rohschnitt für DaVinci Resolve.** Beta.
+
+<!-- Bild oder GIF mit freigegebenem Material folgt: docs/bilder/schnippo.gif -->
+
+## Was ist Schnippo?
+
+Schnippo baut per Chat aus deinen Takes einen Rohschnitt in DaVinci Resolve Studio: Du sagst Claude, welchen Ordner es schneiden soll, und bekommst eine fertige Timeline aus deinen Originalclips. Schnippo misst Sprache, Pausen, Versprecher und Ton, Claude trifft die redaktionellen Entscheidungen, und du behältst in Resolve das letzte Wort. Auf Wunsch kommen B-Roll, Zooms, Grafiken, Sound-Effekte und Reels aus dem langen Video dazu, alles nicht-destruktiv.
+
+## Voraussetzungen
+
+- Mac mit Apple Silicon (Windows folgt)
+- DaVinci Resolve Studio 21.1 oder neuer, unter Preferences → System → General „External scripting using“ auf **Local** (die kostenlose Version kann kein externes Scripting)
+- Claude Desktop
+- Eigener [Gladia-Key](https://www.gladia.io) für die Transkription
+
+**Kosten:** Schnippo ist kostenlos. Gladia rechnet direkt mit dir ab, grob 0,61 USD je Stunde Audio. Vor jeder Transkription nennt Schnippo die Schätzung. Dazu kommt dein Claude-Abo.
+
+## Installation in 4 Schritten
+
+1. **Download:** Lade die neueste `schnippo-<version>.mcpb` von der [Releases-Seite](https://github.com/Seitzdominik/schnippo/releases).
+2. **Doppelklick:** Die Datei öffnet sich in Claude Desktop. Bestätige die Installation.
+3. **Key:** Trage deinen Gladia-Key in den Einstellungen der Erweiterung ein.
+4. **Claude vollständig neu starten:** Beende Claude über die Menüleiste (Claude → Beenden). Das Fenster zu schließen reicht nicht.
+
+Neue Versionen installierst du genauso. Schnippo weist dich darauf hin und aktualisiert sich nie selbst.
+
+## Erster Schnitt
+
+Starte einen neuen Chat und schreibe **„Richte mich ein“**. Das Onboarding prüft Resolve und den Key, fragt deine Vorlieben ab und legt auf Wunsch einen Projektordner an:
+
+```text
+2026-11-07_Mein_Film/
+├── A-Roll/      Takes mit Sprache
+├── B-Roll/      Bildmaterial ohne Sprache
+├── Bilder/      Standbilder, Logos
+├── Skript/      Skript, falls vorhanden
+├── brief.md     Worum es geht, Format, Länge, Zielgruppe
+└── glossar.txt  Namen in richtiger Schreibweise
+```
+
+Spickzettel für den Chat:
+
+| Du schreibst | Schnippo macht |
+|---|---|
+| „Schneide Mein_Film“ | Rough Cut als neue Timeline, danach Rückfragen zu Grenzfällen |
+| „Weiter“ | Nächster Durchgang: Fine Cut, B-Roll, Polish |
+| „Mach aus dem Video 3 Reels“ | Hochformat-Reels aus den stärksten Stellen |
+| „Füge dezente Sound-Effekte hinzu“ | Eigene Spur mit Effekten |
+| „Hilfe“ | Überblick über alles Weitere |
+
+Jeder Durchgang bekommt eine eigene Timeline. Schnippo überschreibt nichts und verändert deine Originaldateien nie. Alle Tools stehen in der [Referenz](docs/REFERENZ.md).
+
+## Aufnahme-Tipps
+
+- **Für Reels in 4K filmen:** Dann bleibt beim Zuschnitt von 16:9 auf 9:16 genug Auflösung.
+- **Versprecher:** Kurz stoppen, deutlich „nochmal“ sagen oder einmal klatschen und den ganzen Satz neu beginnen.
+- **Bild:** Vor dem Sprechen 1 Sekunde ruhig in die Kamera schauen. Alle Takes mit derselben Framerate. B-Roll gern mit doppelter Rate, dann ist Zeitlupe möglich.
+- **Ton:** Ruhiger Raum, 2–3 Sekunden Raumton am Anfang. Im Interview ein Mikro pro Person auf eigenem Kanal.
+- **Namen:** Schreibweisen in die `glossar.txt`, dann stimmen sie schon im Transkript.
+
+Mehr dazu in der [Referenz](docs/REFERENZ.md#so-nimmst-du-für-schnippo-auf), eigene Sound-Effekte aufnehmen: [docs/AUFNAHMEN.md](docs/AUFNAHMEN.md).
+
+## Bekannte Grenzen
+
+- **Nur Mac.** Windows folgt.
+- **Karten in Claude Desktop:** Claude Desktop zeigt die interaktiven Karten lokaler Erweiterungen derzeit nicht an. Schnippo fragt deshalb als Text im Chat.
+- **Gemischte Framerates in der A-Roll:** Die Timeline übernimmt die Rate des Hauptmaterials, Takes mit anderer Rate sind nicht erprobt. B-Roll darf abweichen.
+- **Lange Videos und kleine Claude-Abos:** Ein Interview mit gut 10 Minuten Sprache braucht etwa 9.200 Token für den ganzen Text, die Übersicht etwa 620. Hochgerechnet sind das bei einer Stunde Sprache rund 50.000 Token je Durchgang, dazu kommen Kontaktabzüge. Schnippo liest lange Takes deshalb seitenweise. Bei kleinen Abos kann die Nutzungsgrenze trotzdem mitten im Schnitt erreicht werden. Die Token sind gemessen, wie schnell ein bestimmtes Abo an seine Grenze kommt, ist nicht gemessen.
+- **Noch nicht mit echtem Material erprobt:** Dreh nach Skript, Rohmaterial über 30 Minuten, sehr leise Aufnahmen. Hochformat-Quellen sind nur mit einem einzelnen Clip erprobt.
+- **Seltener Resolve-Absturz:** Beim Einfügen von Grafiken ist Resolve 21.1.2 in Tests mehrfach abgestürzt. Die Ursache ist nicht geklärt. Die Reihenfolge beim Bau wurde angepasst, seitdem trat der Fehler in Tests nicht mehr auf. Speichere dein Projekt vor dem Bau.
+- **Andere KI-Modelle:** Die Schnittqualität hängt vom Modell ab. Erprobt ist Schnippo nur mit Claude, das Modell braucht Bildverständnis.
+
+## Andere Programme
+
+Für Claude Desktop ist die `.mcpb` der einfachste Weg. Andere MCP-fähige Programme starten Schnippo über [uv](https://docs.astral.sh/uv/) mit `uvx schnippo`. Du brauchst nur den Startbefehl und deinen `GLADIA_API_KEY`.
+
+**Claude Code**
+
+```bash
+claude mcp add schnippo -e GLADIA_API_KEY=dein-key -- uvx schnippo
+```
+
+**Cursor** (`~/.cursor/mcp.json`)
+
+```json
+{"mcpServers": {"schnippo": {"command": "uvx", "args": ["schnippo"], "env": {"GLADIA_API_KEY": "dein-key"}}}}
+```
+
+**OpenAI Codex** (`~/.codex/config.toml`)
+
+```toml
+[mcp_servers.schnippo]
+command = "uvx"
+args = ["schnippo"]
+env = { GLADIA_API_KEY = "dein-key" }
+```
+
+**VS Code mit Copilot** (`.vscode/mcp.json`)
+
+```json
+{
+  "inputs": [{"type": "promptString", "id": "gladia", "description": "Gladia-Key", "password": true}],
+  "servers": {"schnippo": {"type": "stdio", "command": "uvx", "args": ["schnippo"], "env": {"GLADIA_API_KEY": "${input:gladia}"}}}
+}
+```
+
+Den Key kannst du stattdessen im macOS-Schlüsselbund ablegen: Sag im Chat „Speichere meinen Gladia-Key“, dann öffnet sich ein Eingabefenster und der Key läuft nicht durch den Chat. Plugin für Claude: [plugin/](plugin/).
+
+## FAQ
+
+**Verändert Schnippo meine Dateien?** Nein. Timelines verweisen auf deine Originalclips, nichts wird neu gerendert oder gelöscht.
+
+**Geht das mit der kostenlosen Resolve-Version?** Nein, sie unterstützt kein externes Scripting.
+
+**Bleibt mein Key beim Update erhalten?** Ja, Claude Desktop speichert Key und Einstellungen pro Erweiterung, und die Kennung bleibt von Version zu Version gleich. Von der internen Vorversion „Resolve Cut“ musst du den Key einmal neu eintragen.
+
+**Ich kannte Resolve Cut. Was passiert mit meinen Daten?** Schnippo übernimmt beim ersten Start Einstellungen, Glossare und Cache aus den alten Ordnern. Alte `resolve-cut-export/`-Ordner liest es weiter.
+
+**Wie schalte ich den Update-Hinweis ab?** In den Einstellungen der Erweiterung, oder mit `SCHNIPPO_UPDATE_CHECK=0`.
+
+## Datenschutz
+
+Keine Telemetrie, kein Schnippo-Server. Schnippo läuft auf deinem Rechner.
+
+| Daten | Wohin | Wann |
+|---|---|---|
+| Originalmedien, Cache, Einstellungen | bleiben lokal | immer |
+| Tonspur (16 kHz, mono, ohne Metadaten) | Gladia, `api.gladia.io` | beim Transkribieren |
+| Transkripte, Schnittkontext, Einzelbilder und Kontaktabzüge | das KI-Modell deines Chats, zum Beispiel Claude | während des Schnitts |
+| Suchbegriff oder Beschreibung | Freesound, ElevenLabs | nur mit eigenem Key und auf Wunsch |
+| Keine Daten, nur die Abfrage der neuesten Version | GitHub, `api.github.com` | höchstens einmal am Tag, abschaltbar |
+
+Nutze Schnippo nur mit Material, das du diesen Diensten geben darfst.
+
+### Privacy Policy
+
+Vollständige Fassung: [docs/PRIVACY.md](docs/PRIVACY.md), online unter https://schnippo.com/privacy.
+
+- **Datenerhebung:** Schnippo erhebt keine Daten und betreibt keinen eigenen Server.
+- **Nutzung und Speicherung:** Transkripte, Analysen und Einstellungen liegen lokal in `~/Library/Caches/schnippo` und `~/.config/schnippo`.
+- **Weitergabe an Dritte:** nur an die Dienste aus der Tabelle, mit deinem eigenen Konto.
+- **Aufbewahrung:** Lokale Daten löschst du jederzeit mit `clear_cache` oder im Finder. Bei Gladia und deinem KI-Anbieter gelten deren Bedingungen.
+- **Kontakt:** Seitz Dominik Visuals, https://sdv.design
+
+## Lizenzen
+
+Schnippo steht unter der [MIT-Lizenz](LICENSE), © Seitz Dominik Visuals. Fremde Bestandteile: [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md).
+
+DaVinci Resolve ist eine Marke von Blackmagic Design. Schnippo ist ein unabhängiges Projekt und nicht mit Blackmagic Design verbunden.
+
+## Mitmachen
+
+Fehler und Wünsche gern als [Issue](https://github.com/Seitzdominik/schnippo/issues/new/choose). Bitte hänge nie echtes Material oder Keys an.
+
+```bash
+uv sync
+uv run pytest
+git config core.hooksPath .githooks
+```
+
+Der Hook startet `tools/check_public.py`. Technische Erkenntnisse stehen in [docs/ENTWICKLUNG.md](docs/ENTWICKLUNG.md).
+
+---
+
+## English summary
+
+**Schnippo** is an AI rough-cut assistant for DaVinci Resolve Studio. Tell Claude which folder to cut and get a non-destructive timeline built from your original clips, with optional B-roll, punch-ins, graphics, sound effects and reels. The interface and guides are in German; English footage works too.
+
+**Requirements:** Apple Silicon Mac, DaVinci Resolve Studio 21.1+ with external scripting set to Local, Claude Desktop, your own Gladia key (roughly USD 0.61 per hour of audio).
+
+**Install:** download the `.mcpb` from [Releases](https://github.com/Seitzdominik/schnippo/releases), double-click it, enter your key, then fully quit and reopen Claude from the menu bar. Say „Richte mich ein“ in a new chat. Other MCP clients can run `uvx schnippo` with `GLADIA_API_KEY` set.
+
+**Privacy:** no telemetry and no Schnippo server. Audio goes to Gladia, transcripts and frames go to your AI model, and the update check asks GitHub once a day (optional). See [docs/PRIVACY.md](docs/PRIVACY.md).
+
+**Licence:** MIT, © Seitz Dominik Visuals. DaVinci Resolve is a trademark of Blackmagic Design. This project is independent of Blackmagic Design.

schnippo-0.11.0/README.md

@@ -0,0 +1,177 @@
+# Schnippo
+
+**KI-Rohschnitt für DaVinci Resolve.** Beta.
+
+<!-- Bild oder GIF mit freigegebenem Material folgt: docs/bilder/schnippo.gif -->
+
+## Was ist Schnippo?
+
+Schnippo baut per Chat aus deinen Takes einen Rohschnitt in DaVinci Resolve Studio: Du sagst Claude, welchen Ordner es schneiden soll, und bekommst eine fertige Timeline aus deinen Originalclips. Schnippo misst Sprache, Pausen, Versprecher und Ton, Claude trifft die redaktionellen Entscheidungen, und du behältst in Resolve das letzte Wort. Auf Wunsch kommen B-Roll, Zooms, Grafiken, Sound-Effekte und Reels aus dem langen Video dazu, alles nicht-destruktiv.
+
+## Voraussetzungen
+
+- Mac mit Apple Silicon (Windows folgt)
+- DaVinci Resolve Studio 21.1 oder neuer, unter Preferences → System → General „External scripting using“ auf **Local** (die kostenlose Version kann kein externes Scripting)
+- Claude Desktop
+- Eigener [Gladia-Key](https://www.gladia.io) für die Transkription
+
+**Kosten:** Schnippo ist kostenlos. Gladia rechnet direkt mit dir ab, grob 0,61 USD je Stunde Audio. Vor jeder Transkription nennt Schnippo die Schätzung. Dazu kommt dein Claude-Abo.
+
+## Installation in 4 Schritten
+
+1. **Download:** Lade die neueste `schnippo-<version>.mcpb` von der [Releases-Seite](https://github.com/Seitzdominik/schnippo/releases).
+2. **Doppelklick:** Die Datei öffnet sich in Claude Desktop. Bestätige die Installation.
+3. **Key:** Trage deinen Gladia-Key in den Einstellungen der Erweiterung ein.
+4. **Claude vollständig neu starten:** Beende Claude über die Menüleiste (Claude → Beenden). Das Fenster zu schließen reicht nicht.
+
+Neue Versionen installierst du genauso. Schnippo weist dich darauf hin und aktualisiert sich nie selbst.
+
+## Erster Schnitt
+
+Starte einen neuen Chat und schreibe **„Richte mich ein“**. Das Onboarding prüft Resolve und den Key, fragt deine Vorlieben ab und legt auf Wunsch einen Projektordner an:
+
+```text
+2026-11-07_Mein_Film/
+├── A-Roll/      Takes mit Sprache
+├── B-Roll/      Bildmaterial ohne Sprache
+├── Bilder/      Standbilder, Logos
+├── Skript/      Skript, falls vorhanden
+├── brief.md     Worum es geht, Format, Länge, Zielgruppe
+└── glossar.txt  Namen in richtiger Schreibweise
+```
+
+Spickzettel für den Chat:
+
+| Du schreibst | Schnippo macht |
+|---|---|
+| „Schneide Mein_Film“ | Rough Cut als neue Timeline, danach Rückfragen zu Grenzfällen |
+| „Weiter“ | Nächster Durchgang: Fine Cut, B-Roll, Polish |
+| „Mach aus dem Video 3 Reels“ | Hochformat-Reels aus den stärksten Stellen |
+| „Füge dezente Sound-Effekte hinzu“ | Eigene Spur mit Effekten |
+| „Hilfe“ | Überblick über alles Weitere |
+
+Jeder Durchgang bekommt eine eigene Timeline. Schnippo überschreibt nichts und verändert deine Originaldateien nie. Alle Tools stehen in der [Referenz](docs/REFERENZ.md).
+
+## Aufnahme-Tipps
+
+- **Für Reels in 4K filmen:** Dann bleibt beim Zuschnitt von 16:9 auf 9:16 genug Auflösung.
+- **Versprecher:** Kurz stoppen, deutlich „nochmal“ sagen oder einmal klatschen und den ganzen Satz neu beginnen.
+- **Bild:** Vor dem Sprechen 1 Sekunde ruhig in die Kamera schauen. Alle Takes mit derselben Framerate. B-Roll gern mit doppelter Rate, dann ist Zeitlupe möglich.
+- **Ton:** Ruhiger Raum, 2–3 Sekunden Raumton am Anfang. Im Interview ein Mikro pro Person auf eigenem Kanal.
+- **Namen:** Schreibweisen in die `glossar.txt`, dann stimmen sie schon im Transkript.
+
+Mehr dazu in der [Referenz](docs/REFERENZ.md#so-nimmst-du-für-schnippo-auf), eigene Sound-Effekte aufnehmen: [docs/AUFNAHMEN.md](docs/AUFNAHMEN.md).
+
+## Bekannte Grenzen
+
+- **Nur Mac.** Windows folgt.
+- **Karten in Claude Desktop:** Claude Desktop zeigt die interaktiven Karten lokaler Erweiterungen derzeit nicht an. Schnippo fragt deshalb als Text im Chat.
+- **Gemischte Framerates in der A-Roll:** Die Timeline übernimmt die Rate des Hauptmaterials, Takes mit anderer Rate sind nicht erprobt. B-Roll darf abweichen.
+- **Lange Videos und kleine Claude-Abos:** Ein Interview mit gut 10 Minuten Sprache braucht etwa 9.200 Token für den ganzen Text, die Übersicht etwa 620. Hochgerechnet sind das bei einer Stunde Sprache rund 50.000 Token je Durchgang, dazu kommen Kontaktabzüge. Schnippo liest lange Takes deshalb seitenweise. Bei kleinen Abos kann die Nutzungsgrenze trotzdem mitten im Schnitt erreicht werden. Die Token sind gemessen, wie schnell ein bestimmtes Abo an seine Grenze kommt, ist nicht gemessen.
+- **Noch nicht mit echtem Material erprobt:** Dreh nach Skript, Rohmaterial über 30 Minuten, sehr leise Aufnahmen. Hochformat-Quellen sind nur mit einem einzelnen Clip erprobt.
+- **Seltener Resolve-Absturz:** Beim Einfügen von Grafiken ist Resolve 21.1.2 in Tests mehrfach abgestürzt. Die Ursache ist nicht geklärt. Die Reihenfolge beim Bau wurde angepasst, seitdem trat der Fehler in Tests nicht mehr auf. Speichere dein Projekt vor dem Bau.
+- **Andere KI-Modelle:** Die Schnittqualität hängt vom Modell ab. Erprobt ist Schnippo nur mit Claude, das Modell braucht Bildverständnis.
+
+## Andere Programme
+
+Für Claude Desktop ist die `.mcpb` der einfachste Weg. Andere MCP-fähige Programme starten Schnippo über [uv](https://docs.astral.sh/uv/) mit `uvx schnippo`. Du brauchst nur den Startbefehl und deinen `GLADIA_API_KEY`.
+
+**Claude Code**
+
+```bash
+claude mcp add schnippo -e GLADIA_API_KEY=dein-key -- uvx schnippo
+```
+
+**Cursor** (`~/.cursor/mcp.json`)
+
+```json
+{"mcpServers": {"schnippo": {"command": "uvx", "args": ["schnippo"], "env": {"GLADIA_API_KEY": "dein-key"}}}}
+```
+
+**OpenAI Codex** (`~/.codex/config.toml`)
+
+```toml
+[mcp_servers.schnippo]
+command = "uvx"
+args = ["schnippo"]
+env = { GLADIA_API_KEY = "dein-key" }
+```
+
+**VS Code mit Copilot** (`.vscode/mcp.json`)
+
+```json
+{
+  "inputs": [{"type": "promptString", "id": "gladia", "description": "Gladia-Key", "password": true}],
+  "servers": {"schnippo": {"type": "stdio", "command": "uvx", "args": ["schnippo"], "env": {"GLADIA_API_KEY": "${input:gladia}"}}}
+}
+```
+
+Den Key kannst du stattdessen im macOS-Schlüsselbund ablegen: Sag im Chat „Speichere meinen Gladia-Key“, dann öffnet sich ein Eingabefenster und der Key läuft nicht durch den Chat. Plugin für Claude: [plugin/](plugin/).
+
+## FAQ
+
+**Verändert Schnippo meine Dateien?** Nein. Timelines verweisen auf deine Originalclips, nichts wird neu gerendert oder gelöscht.
+
+**Geht das mit der kostenlosen Resolve-Version?** Nein, sie unterstützt kein externes Scripting.
+
+**Bleibt mein Key beim Update erhalten?** Ja, Claude Desktop speichert Key und Einstellungen pro Erweiterung, und die Kennung bleibt von Version zu Version gleich. Von der internen Vorversion „Resolve Cut“ musst du den Key einmal neu eintragen.
+
+**Ich kannte Resolve Cut. Was passiert mit meinen Daten?** Schnippo übernimmt beim ersten Start Einstellungen, Glossare und Cache aus den alten Ordnern. Alte `resolve-cut-export/`-Ordner liest es weiter.
+
+**Wie schalte ich den Update-Hinweis ab?** In den Einstellungen der Erweiterung, oder mit `SCHNIPPO_UPDATE_CHECK=0`.
+
+## Datenschutz
+
+Keine Telemetrie, kein Schnippo-Server. Schnippo läuft auf deinem Rechner.
+
+| Daten | Wohin | Wann |
+|---|---|---|
+| Originalmedien, Cache, Einstellungen | bleiben lokal | immer |
+| Tonspur (16 kHz, mono, ohne Metadaten) | Gladia, `api.gladia.io` | beim Transkribieren |
+| Transkripte, Schnittkontext, Einzelbilder und Kontaktabzüge | das KI-Modell deines Chats, zum Beispiel Claude | während des Schnitts |
+| Suchbegriff oder Beschreibung | Freesound, ElevenLabs | nur mit eigenem Key und auf Wunsch |
+| Keine Daten, nur die Abfrage der neuesten Version | GitHub, `api.github.com` | höchstens einmal am Tag, abschaltbar |
+
+Nutze Schnippo nur mit Material, das du diesen Diensten geben darfst.
+
+### Privacy Policy
+
+Vollständige Fassung: [docs/PRIVACY.md](docs/PRIVACY.md), online unter https://schnippo.com/privacy.
+
+- **Datenerhebung:** Schnippo erhebt keine Daten und betreibt keinen eigenen Server.
+- **Nutzung und Speicherung:** Transkripte, Analysen und Einstellungen liegen lokal in `~/Library/Caches/schnippo` und `~/.config/schnippo`.
+- **Weitergabe an Dritte:** nur an die Dienste aus der Tabelle, mit deinem eigenen Konto.
+- **Aufbewahrung:** Lokale Daten löschst du jederzeit mit `clear_cache` oder im Finder. Bei Gladia und deinem KI-Anbieter gelten deren Bedingungen.
+- **Kontakt:** Seitz Dominik Visuals, https://sdv.design
+
+## Lizenzen
+
+Schnippo steht unter der [MIT-Lizenz](LICENSE), © Seitz Dominik Visuals. Fremde Bestandteile: [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md).
+
+DaVinci Resolve ist eine Marke von Blackmagic Design. Schnippo ist ein unabhängiges Projekt und nicht mit Blackmagic Design verbunden.
+
+## Mitmachen
+
+Fehler und Wünsche gern als [Issue](https://github.com/Seitzdominik/schnippo/issues/new/choose). Bitte hänge nie echtes Material oder Keys an.
+
+```bash
+uv sync
+uv run pytest
+git config core.hooksPath .githooks
+```
+
+Der Hook startet `tools/check_public.py`. Technische Erkenntnisse stehen in [docs/ENTWICKLUNG.md](docs/ENTWICKLUNG.md).
+
+---
+
+## English summary
+
+**Schnippo** is an AI rough-cut assistant for DaVinci Resolve Studio. Tell Claude which folder to cut and get a non-destructive timeline built from your original clips, with optional B-roll, punch-ins, graphics, sound effects and reels. The interface and guides are in German; English footage works too.
+
+**Requirements:** Apple Silicon Mac, DaVinci Resolve Studio 21.1+ with external scripting set to Local, Claude Desktop, your own Gladia key (roughly USD 0.61 per hour of audio).
+
+**Install:** download the `.mcpb` from [Releases](https://github.com/Seitzdominik/schnippo/releases), double-click it, enter your key, then fully quit and reopen Claude from the menu bar. Say „Richte mich ein“ in a new chat. Other MCP clients can run `uvx schnippo` with `GLADIA_API_KEY` set.
+
+**Privacy:** no telemetry and no Schnippo server. Audio goes to Gladia, transcripts and frames go to your AI model, and the update check asks GitHub once a day (optional). See [docs/PRIVACY.md](docs/PRIVACY.md).
+
+**Licence:** MIT, © Seitz Dominik Visuals. DaVinci Resolve is a trademark of Blackmagic Design. This project is independent of Blackmagic Design.

schnippo-0.11.0/pyproject.toml

@@ -0,0 +1,61 @@
+[project]
+name = "schnippo"
+version = "0.11.0"
+description = "KI-Rohschnitt für DaVinci Resolve: MCP-Server für Rohschnitte per Chat"
+license = "MIT"
+readme = "README.md"
+keywords = [
+    "mcp",
+    "davinci resolve",
+    "video editing",
+    "rough cut",
+    "transcript",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: MacOS X",
+    "Intended Audience :: End Users/Desktop",
+    "Natural Language :: German",
+    "Operating System :: MacOS",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Multimedia :: Video :: Non-Linear Editor",
+]
+requires-python = ">=3.14,<3.16"
+dependencies = [
+    "httpx>=0.28.1",
+    "mcp[cli]>=2.3.0",
+    "numpy>=2.5.4",
+    "opencv-python-headless>=4.10,<5",
+    "pillow>=13.0.0",
+    "portable-ffmpeg-full==0.5.0",
+    "pydantic>=2.14.2",
+    "python-docx>=1.2.0",
+    "rapidfuzz>=3.14.6",
+]
+
+[[project.authors]]
+name = "Seitz Dominik Visuals"
+
+[project.urls]
+Homepage = "https://schnippo.com"
+Repository = "https://github.com/Seitzdominik/schnippo"
+Issues = "https://github.com/Seitzdominik/schnippo/issues"
+
+[project.optional-dependencies]
+motion = ["playwright==1.64.1"]
+
+[project.scripts]
+schnippo = "schnippo.server:main"
+
+[build-system]
+requires = ["uv_build>=0.13.7,<0.14.0"]
+build-backend = "uv_build"
+
+[dependency-groups]
+dev = [
+    "playwright==1.64.1",
+    "pytest>=9.2.0",
+]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

schnippo-0.11.0/pyproject.toml.orig

@@ -0,0 +1,56 @@
+[project]
+name = "schnippo"
+version = "0.11.0"
+description = "KI-Rohschnitt für DaVinci Resolve: MCP-Server für Rohschnitte per Chat"
+license = "MIT"
+readme = "README.md"
+authors = [
+    { name = "Seitz Dominik Visuals" }
+]
+keywords = ["mcp", "davinci resolve", "video editing", "rough cut", "transcript"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: MacOS X",
+    "Intended Audience :: End Users/Desktop",
+    "Natural Language :: German",
+    "Operating System :: MacOS",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Multimedia :: Video :: Non-Linear Editor",
+]
+requires-python = ">=3.14,<3.16"  # tested with Resolve 21.1.2 fusionscript: 3.14 (default via .python-version) and 3.15
+dependencies = [
+    "httpx>=0.28.1",
+    "mcp[cli]>=2.3.0",
+    "numpy>=2.5.4",
+    "opencv-python-headless>=4.10,<5",
+    "pillow>=13.0.0",
+    "portable-ffmpeg-full==0.5.0",
+    "pydantic>=2.14.2",
+    "python-docx>=1.2.0",
+    "rapidfuzz>=3.14.6",
+]
+
+[project.urls]
+Homepage = "https://schnippo.com"
+Repository = "https://github.com/Seitzdominik/schnippo"
+Issues = "https://github.com/Seitzdominik/schnippo/issues"
+
+[project.optional-dependencies]
+# installed on first use of motion graphics (motion_setup), not with the extension
+motion = ["playwright==1.64.1"]
+
+[project.scripts]
+schnippo = "schnippo.server:main"
+
+[build-system]
+requires = ["uv_build>=0.13.7,<0.14.0"]
+build-backend = "uv_build"
+
+[dependency-groups]
+dev = [
+    "playwright==1.64.1",
+    "pytest>=9.2.0",
+]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

schnippo-0.11.0/src/schnippo/__init__.py

@@ -0,0 +1,3 @@
+"""schnippo: AI rough-cut MCP server for DaVinci Resolve Studio."""
+
+__version__ = "0.11.0"

schnippo-0.11.0/src/schnippo/acoustic.py

@@ -0,0 +1,166 @@
+"""Acoustic analysis of the 16 kHz mono WAV (numpy, no Torch).
+
+* RMS envelope (25 ms window, 10 ms hop) in dBFS.
+* Noise floor = low percentile of the envelope; activity threshold = floor + delta.
+  This replaces the Phase-1 rule max(-35 dB, mean-18 dB), which on a quiet recording with a very low
+  room noise put the threshold *above* half of the speech frames.
+* Voicing per frame = peak of the normalised autocorrelation in the 75–400 Hz lag range (40 ms window).
+  Voiced sounds ("äh", "hm", vowels) have a clear periodicity, breaths/clicks do not.
+
+Regions of activity are classified as ``voiced`` (filler candidate), ``breath`` (unvoiced, breath-like
+duration) or ``click`` (very short transient).
+"""
+
+from __future__ import annotations
+
+import wave
+from dataclasses import dataclass, field
+from pathlib import Path
+
+import numpy as np
+
+SR = 16000
+HOP = 160  # 10 ms
+WIN = 400  # 25 ms
+VWIN = 640  # 40 ms voicing window
+LAG_MIN, LAG_MAX = SR // 400, SR // 75  # 40 .. 213 samples
+
+
+@dataclass
+class AcousticParams:
+    floor_percentile: float = 10.0
+    delta_db: float = 25.0  # activity threshold above the noise floor
+    min_threshold_db: float = -60.0  # never below this (digital silence / heavy denoise)
+    max_threshold_db: float = -30.0
+    min_region_s: float = 0.06
+    merge_gap_s: float = 0.08
+    voiced_corr: float = 0.6  # frame is voiced if autocorrelation peak >= this
+    voiced_min_s: float = 0.15  # region needs at least this much voiced material (calibrated on real take)
+    voiced_ratio: float = 0.6  # ... and this share of its active frames voiced
+    click_max_s: float = 0.08
+
+    def key(self) -> list:
+        return [self.floor_percentile, self.delta_db, self.min_threshold_db, self.max_threshold_db, self.min_region_s,
+                self.merge_gap_s, self.voiced_corr, self.voiced_min_s, self.voiced_ratio, self.click_max_s, 2]
+
+
+@dataclass
+class Acoustic:
+    env_db: np.ndarray  # per 10 ms frame
+    voicing: np.ndarray  # per 10 ms frame, 0..1
+    floor_db: float
+    threshold_db: float
+    duration_s: float
+    params: AcousticParams = field(default_factory=AcousticParams)
+
+    # ---- frame helpers ----
+    def _sl(self, t0: float, t1: float) -> slice:
+        return slice(max(0, int(round(t0 * 100))), max(0, int(round(t1 * 100))))
+
+    def active(self, t0: float, t1: float) -> np.ndarray:
+        return self.env_db[self._sl(t0, t1)] > self.threshold_db
+
+    def regions(self, t0: float, t1: float) -> list[tuple[float, float]]:
+        """Active (non-silent) sub-intervals of [t0, t1]."""
+        act = self.active(t0, t1)
+        base = int(round(t0 * 100))
+        out: list[list[float]] = []
+        i = 0
+        while i < len(act):
+            if act[i]:
+                j = i
+                while j < len(act) and act[j]:
+                    j += 1
+                a, b = (base + i) / 100, (base + j) / 100
+                if out and a - out[-1][1] <= self.params.merge_gap_s:
+                    out[-1][1] = b
+                else:
+                    out.append([a, b])
+                i = j
+            else:
+                i += 1
+        return [(max(a, t0), min(b, t1)) for a, b in out if b - a >= self.params.min_region_s]
+
+    def classify(self, t0: float, t1: float) -> dict:
+        sl = self._sl(t0, t1)
+        env, voi = self.env_db[sl], self.voicing[sl]
+        act = env > self.threshold_db
+        voiced = (voi >= self.params.voiced_corr) & act
+        vs = float(voiced.sum()) / 100
+        ratio = float(voiced.sum()) / max(1, int(act.sum()))
+        dur = t1 - t0
+        if vs >= self.params.voiced_min_s and ratio >= self.params.voiced_ratio:
+            cls = "voiced"
+        elif dur <= self.params.click_max_s:
+            cls = "click"
+        else:
+            cls = "breath"
+        return {"class": cls, "peak_db": round(float(env.max()) if len(env) else -120.0, 1),
+                "voiced_s": round(vs, 2), "voiced_ratio": round(ratio, 2)}
+
+    def silent_runs(self, t0: float, t1: float, min_s: float) -> list[tuple[float, float]]:
+        act = self.active(t0, t1)
+        base = int(round(t0 * 100))
+        out, i = [], 0
+        while i < len(act):
+            if not act[i]:
+                j = i
+                while j < len(act) and not act[j]:
+                    j += 1
+                if (j - i) / 100 >= min_s:
+                    out.append(((base + i) / 100, (base + j) / 100))
+                i = j
+            else:
+                i += 1
+        return out
+
+    # ---- persistence ----
+    def save(self, path: Path) -> None:
+        np.savez_compressed(path, env=self.env_db.astype(np.float32), voi=self.voicing.astype(np.float16),
+                            meta=np.array([self.floor_db, self.threshold_db, self.duration_s]),
+                            key=np.array(self.params.key(), dtype=float))
+
+    @classmethod
+    def load(cls, path: Path, params: AcousticParams) -> "Acoustic | None":
+        if not path.exists():
+            return None
+        d = np.load(path)
+        if list(d["key"]) != [float(x) for x in params.key()]:
+            return None
+        floor, thr, dur = (float(x) for x in d["meta"])
+        return cls(d["env"].astype(np.float64), d["voi"].astype(np.float64), floor, thr, dur, params)
+
+
+def read_wav(path: Path) -> np.ndarray:
+    with wave.open(str(path)) as w:
+        if w.getframerate() != SR or w.getnchannels() != 1 or w.getsampwidth() != 2:
+            raise ValueError("expected 16 kHz mono 16-bit WAV")
+        return np.frombuffer(w.readframes(w.getnframes()), dtype=np.int16).astype(np.float64) / 32768.0
+
+
+def _frames(xp: np.ndarray, win: int, i0: int, i1: int) -> np.ndarray:
+    """Frames i0..i1 (hop 10 ms) of the padded signal xp (padded by win//2 in front)."""
+    idx = np.arange(win)[None, :] + (np.arange(i0, i1) * HOP)[:, None]
+    return xp[idx]
+
+
+def analyze_wav(path: Path, params: AcousticParams | None = None) -> Acoustic:
+    params = params or AcousticParams()
+    x = read_wav(path)
+    n = 1 + max(0, (len(x) - 1) // HOP)
+    xp_e = np.pad(x, (WIN // 2, WIN))
+    xp_v = np.pad(x, (VWIN // 2, VWIN))
+    env = np.empty(n)
+    voi = np.empty(n)
+    nfft, hann = 1024, np.hanning(VWIN)[None, :]
+    for i0 in range(0, n, 4096):  # chunked: bounded memory for hour-long material
+        i1 = min(n, i0 + 4096)
+        fe = _frames(xp_e, WIN, i0, i1)
+        env[i0:i1] = 10 * np.log10(np.mean(fe * fe, axis=1) + 1e-12)
+        fv = _frames(xp_v, VWIN, i0, i1)
+        fv = (fv - fv.mean(axis=1, keepdims=True)) * hann
+        ac = np.fft.irfft(np.abs(np.fft.rfft(fv, nfft)) ** 2, nfft)[:, :LAG_MAX + 1]
+        voi[i0:i1] = np.clip(ac[:, LAG_MIN:LAG_MAX + 1].max(axis=1) / (ac[:, 0] + 1e-12), 0, 1)
+    floor = float(np.percentile(env, params.floor_percentile))
+    thr = float(np.clip(floor + params.delta_db, params.min_threshold_db, params.max_threshold_db))
+    return Acoustic(env, voi, floor, thr, len(x) / SR, params)