Hallo zusammen,
ich möchte ein Tool vorstellen, das ich für die Verwaltung von Text+-Untertiteln in DaVinci Resolve entwickelt habe. Ausgangspunkt war eine Bereinigung und Erweiterung von Sergey Knyazkovs Text+ to Subtitle Tool (das Text+-Clips als SRT exportierte). Daraus ist ein vollständiger Roundtrip-Workflow geworden — exportieren, extern übersetzen lassen, und den übersetzten Text zurück in die bestehenden Text+-Clips schreiben.
Das Tool wurde in Zusammenarbeit mit Anthropic's Claude AI entwickelt — ich habe die Workflow-Anforderungen definiert, in Resolve getestet und iterativ Feedback gegeben; Claude hat die Architektur, den Code und das Debugging übernommen. Das Ergebnis ist ein einzelnes Python-Script, das innerhalb von Resolves Scripting-Umgebung läuft und keine externen Abhängigkeiten hat.
Was das Tool kann
Das Tool hat zwei Modi, umschaltbar über einen Selector oben im UI:
Export-Modus
- Scannt ausgewählte Video-Tracks nach Text+-Clips (mit Checkboxen pro Track)
- Export als SRT, WebVTT oder CSV
- CSV enthält Roundtrip-Spalten (Original + Translation) für den direkten Einsatz im Übersetzungs-Workflow
- Optionales JSON-Roundtrip-Manifest für SRT/VTT-Exporte — speichert frame-genaue Positionen und Track-Zuordnungen für präzisen Re-Import
- Duplikaterkennung — erkennt identischen Text auf mehreren Tracks mit überlappenden Zeitbereichen (z.B. Titel + Drop Shadow) und fasst sie zusammen
- Merge Adjacent — verbindet aufeinanderfolgende Clips mit identischem Text, die ≤2 Frames auseinander liegen (verhindert Flackern bei der Wiedergabe)
- Vorschau aller gesammelten Untertitel bevor eine Datei geschrieben wird
- Optional wird die SRT direkt auf einen neuen Subtitle-Track in der Timeline angewendet
- Dateinamen-Templates mit Variablen: {timeline}, {project}, {fps}, {date}, {time}, {tracks} — mit speicherbaren User-Presets
- Lädt eine übersetzte SRT-, VTT- oder CSV-Datei
- Erkennt automatisch das JSON-Roundtrip-Manifest, falls es neben der Untertitel-Datei liegt
- Scannt die Timeline und matcht die importierten Einträge mit den bestehenden Text+-Clips — frame-genau (mit Manifest/CSV) oder über Timecode-Nähe (ohne Manifest)
- Match-Qualitätsstufen: exact (±0 Frames), close (±3), tolerant (±10), unmatched
- Partieller Import — nur sichere Matches (exact/close) werden geschrieben; unsichere werden übersprungen
- Detaillierte Match-Vorschau mit "Original → Neu" und Qualitätsbewertung pro Eintrag, bevor Änderungen vorgenommen werden
- Optionales Backup-CSV aller aktuellen Texte vor dem Ersetzen
- Rollback-Button — stellt alle Texte aus dem Backup mit einem Klick wieder her
- Optionales Fusion Undo pro Clip (registriert Änderungen in Fusions Undo-Stack für einzelnes Ctrl+Z auf der Fusion-Page)
- Export: Timeline scannen, Vorschau prüfen, als CSV exportieren (für Übersetzung in der Tabellenkalkulation) oder als SRT/VTT mit Manifest (für Übersetzung im Untertitel-Editor)
- Übersetzen: Translation-Spalte im CSV ausfüllen, oder die SRT/VTT im Untertitel-Editor bearbeiten
- Import: In den Import-Modus wechseln, übersetzte Datei laden, Match-Vorschau prüfen, "Replace Text" klicken
- Falls nötig: Rollback klicken um die Originaltexte aus dem Backup wiederherzustellen
Installation
Schritt 1 — Python
DaVinci Resolve bringt keinen eigenen Python-Interpreter mit. Es sucht auf dem System nach einer Standard-Python-Installation und verwendet diese für Scripts. Unser Script läuft intern über Workspace → Scripts (nicht als externes Script), daher sind keine Umgebungsvariablen oder Modul-Importe nötig — aber Resolve muss trotzdem eine Python-Installation finden.
- Windows: Python 3.10 oder 3.11 von python.org herunterladen und installieren. Während der Installation unbedingt "Add Python to PATH" aktivieren. Nicht die Windows-Store-Version verwenden — Resolve findet sie nicht. Python 3.10 ist die sicherste Wahl über Resolve 18/19/20 hinweg. Einige User berichten von Problemen mit Python 3.12+ unter Windows 11.
- macOS: Python 3 ist seit Monterey typischerweise vorinstalliert. Falls nicht, von python.org installieren. Nicht Homebrew oder pyenv verwenden — Resolve erkennt diese Installationen möglicherweise nicht.
- Linux: Python 3 ist üblicherweise vorinstalliert. Falls nicht, über den Paketmanager installieren.
Schritt 2 — Resolve Preferences
Unter Preferences → System → General die Einstellung "External scripting using" auf "Local" setzen. Unser Script läuft zwar intern und benötigt diese Einstellung streng genommen nicht, aber "None" kann zu unerwarteten Problemen führen. Nach der Änderung Resolve neu starten.
Schritt 3 — Script platzieren
Die .py-Datei in den Utility-Scripts-Ordner kopieren. Damit erscheint das Script unter Workspace → Scripts auf allen Pages.
- Windows (aktueller User):
Diesen Pfad direkt in die Adressleiste des Windows Explorers einfügen.
Code: Alles auswählen
%AppData%\Blackmagic Design\DaVinci Resolve\Support\Fusion\Scripts\Utility - Windows (alle User):
Code: Alles auswählen
%ProgramData%\Blackmagic Design\DaVinci Resolve\Fusion\Scripts\Utility - macOS (aktueller User):
Im Finder Shift+Command+G drücken und einfügen:Code: Alles auswählen
~/Library/Application Support/Blackmagic Design/DaVinci Resolve/Fusion/Scripts/Utility - macOS (alle User):
Code: Alles auswählen
/Library/Application Support/Blackmagic Design/DaVinci Resolve/Fusion/Scripts/Utility - Linux (aktueller User):
Code: Alles auswählen
~/.local/share/DaVinciResolve/Fusion/Scripts/Utility - Linux (alle User):
Code: Alles auswählen
/opt/resolve/Fusion/Scripts/Utility
(Script-Ordner-Pfade basierend auf Roger Magnussons Referenz-Post im BMD-Forum)
Schritt 4 — Starten
Eine Timeline mit Text+-Clips öffnen, dann Workspace → Scripts → Text+ Subtitle Tool. Das Script-Fenster erscheint.
Voraussetzungen
- DaVinci Resolve Studio 19+ (zwingend erforderlich — in der Free-Version sind die UIManager-Scripting-Funktionen seit Resolve 19 deaktiviert)
- Python 3.10 oder 3.11 von python.org installiert (siehe Installation oben)
- Keine externen Python-Pakete nötig — verwendet ausschließlich Standard-Library-Module und Resolves eingebauten fusion.UIManager
- Das UI friert während des Scannens bei großen Timelines kurz ein — das ist systembedingt durch Resolves single-threaded UIManager und lässt sich von der Scripting-Seite nicht umgehen
- Drop-Frame-Timecode (29.97/59.94 DF) wird als Non-Drop-Frame angenähert; vollständige DF-Unterstützung ist nicht implementiert
- Track-Checkboxen werden beim Start erzeugt — wenn Video-Tracks hinzugefügt oder entfernt werden, muss das Script geschlossen und neu gestartet werden
- Der Rollback-Button funktioniert nur innerhalb derselben Session nach einem Replace mit aktiviertem Backup
- Ursprüngliches Konzept: RMT Text Index Tool von Sergey Knyazkov
- Erweitert und neu aufgebaut von Robert Niessner / LAUFBILDkommission in Zusammenarbeit mit Anthropic Claude (KI-gestützte Entwicklung)
- Lizenz: MIT — verwenden, modifizieren, weitergeben
Das Script zum Runterladen: Feedback, Fehlermeldungen und Feature-Wünsche sind willkommen. Bei Problemen bitte Resolve-Studio-Version, Betriebssystem und Timeline-Framerate angeben — das sind die drei Variablen, die erfahrungsgemäß am meisten ausmachen.
