---
title: "DaVinci-Resolve-Plugin"
description: "Hol den Schnitt einer Folge als Timeline in DaVinci Resolve und schick dein Render als nächste Version einer Schnittfassung zurück."
url: https://www.filmsquare.ai/docs/de/plugins/resolve/
lang: de
section: plugins
updated: 2026-11-16
---

# DaVinci-Resolve-Plugin

Das Filmsquare-Plugin für DaVinci Resolve holt den Schnitt einer Folge als Timeline in Resolve: jede Einstellung in
Board-Reihenfolge, die ihren gewählten Take spielt, mit den Trims aus **Edit → Cut**. Hast du ihn geschnitten, renderst du
ihn und schickst ihn als nächste Version einer benannten Schnittfassung zurück. Die offenen Anmerkungen der Version davor kommen mit,
und du siehst, wie viele noch offen sind, mit einem Link zu **Review**.

Das Plugin ist in der Beta. Nichts darin ändert den Schnitt in Filmsquare: Der Hub bleibt die Quelle, und zurück kommt
ein Render.

## Was du brauchst

| | Scripts-Menü | Kommandozeile |
| --- | --- | --- |
| Resolve Studio 18.5 oder neuer | Ja | Ja |
| Kostenloses Resolve 18.5 bis 21.0 | Ja | Ja |
| Kostenloses Resolve 21.1 oder neuer | Nein | Ja |
| Python | 3.10 oder neuer | 3.10 oder neuer |

Resolve 21.1 hat die Python-Skripte in Studio verschoben. In kostenlosem Resolve 21.1 und neuer erscheint das Skript nicht
im Menü **Workspace → Scripts**, deshalb nutzt du die Kommandozeile. Sie macht dieselbe Arbeit außerhalb von Resolve, und
du importierst die Timeline und rendest selbst.

Du brauchst außerdem einen persönlichen Schlüssel: Öffne in Filmsquare **Settings → Claude**, wähle **Use a personal key
instead** und dann **Create a personal key**. Der Schlüssel arbeitet als du, mit deiner Rolle, in diesem Workspace.
Kopiere ihn, wenn er angezeigt wird: Du siehst ihn danach nicht mehr. Du kannst den ganzen Befehl einfügen, den
Filmsquare zeigt; das Plugin nimmt den Schlüssel selbst heraus.

## Installation

1. Lade `resolve.zip` herunter und entpacke ihn. Du brauchst zwei seiner Dateien: `Filmsquare.py` und `filmsquare_resolve.pyz`.
2. Kopiere beide Dateien in den Resolve-Skriptordner für alle Seiten:
   - Windows: `%APPDATA%\Blackmagic Design\DaVinci Resolve\Support\Fusion\Scripts\Utility`
   - macOS: `~/Library/Application Support/Blackmagic Design/DaVinci Resolve/Fusion/Scripts/Utility`
   - Linux: `~/.local/share/DaVinciResolve/Fusion/Scripts/Utility`
3. Starte Resolve neu. **Workspace → Scripts → Filmsquare** öffnet das Plugin.

Für die Kommandozeile brauchst du nur `filmsquare_resolve.pyz`; bewahre die Datei auf, wo du willst.

## Updates

Wenn du das Fenster öffnest, sucht das Plugin höchstens einmal am Tag nach einer neueren Version. Gibt es eine, zeigt das Fenster `Version 0.3.0 is ready.` mit **Update**. **Update** lädt die neue Version herunter, prüft sie gegen den mitveröffentlichten Fingerabdruck und ersetzt im Skriptordner die alten Dateien durch die neuen. Schließe danach das Filmsquare-Fenster und öffne es wieder. **Update** wartet, solange ein Import, ein Render oder ein Retake läuft.

Auf der Kommandozeile:

```bash
python filmsquare_resolve.pyz update
```

Kann das Plugin nicht in den Skriptordner schreiben (zum Beispiel in den für alle Benutzer), wird aus **Update** **Download**: Entpacke die neue `resolve.zip` und kopiere die zwei Dateien hinein, wie bei der Installation.

Ein selbst gehostetes Studio mit eigener Kopie des Plugins veröffentlicht `resolve.json` neben seiner `resolve.zip` und verweist das Plugin mit `FILMSQUARE_UPDATE_URL` darauf, oder mit `"update_url"` in `resolve-update.json` neben `resolve.json`.

## Den Schnitt nach Resolve holen

Im Fenster des Scripts-Menüs:

1. Trag den Server ein, die Adresse, unter der du das Studio im Browser öffnest (`https://app.filmsquare.ai`), dazu deinen Schlüssel, und wähle **Sign in**. Das Fenster trägt danach den Namen dieses Studios.
2. Wähle die **Production** und die **Episode** (Folge).
3. Wähle **Import cut**.

Das Plugin lädt die gewählten Takes nach `Filmsquare/Resolve` in deinem Home-Ordner und importiert den Schnitt als Timeline in das
offene Projekt, benannt nach der Folge (`EP01 cut`). Eine Einstellung, für die noch nichts gewählt ist, wird zu einer Lücke in
ihrer Länge. Ein Standbild hält für seine Haltezeit.

Jede offene Anmerkung am Schnitt wird ein Marker auf der Timeline: an ihrem Timecode, wenn sie einen hat, sonst am ersten
Frame der Einstellung. Der Marker enthält den Autor, die Anmerkung und einen Link zur Folge unter **Review → Player**. Eine Anmerkung
zur ganzen Folge liegt auf dem ersten Frame. Anmerkungen auf demselben Frame teilen sich einen Marker. Erledigte Anmerkungen
fallen weg.

Auf der Kommandozeile:

```bash
python filmsquare_resolve.pyz login
python filmsquare_resolve.pyz pull
```

`pull` fragt nach der Produktion und der Folge und schreibt die Medien sowie eine `.otio`-Datei mit den Anmerkungen als
Markern. Wähle in Resolve **File → Import → Timeline** und nimm diese Datei.

## Neuere Picks und der gewählte Shot

Das Fenster hat zwei Tabs.

**Cut** enthält den Import, das Rendern und die neueren Picks. Setzt jemand in Filmsquare nach deinem Import einen
neueren Pick, zeigt der Tab eine Zahl (`Cut · 2`) und listet die Shots auf. Wähle **Use picks**, und jeder neuere Pick
landet auf demselben Clip, an derselben Stelle und in derselben Länge; die alte Take bleibt im Take Selector von Resolve,
sodass du dort zurückwechseln kannst. Ein Pick, der kürzer ist als dein Trim, bleibt
abgewählt, mit dem Grund dazu.

**Shot** folgt dem Clip, den du auf der Timeline auswählst. Er zeigt die Takes des Shots und oben dein Guthaben:

- **Retake** macht eine neue Take des Shots, **More** lässt ein Werkzeug darüber laufen, etwa ein Upscale auf 4K. Der Preis
  steht vorab in Credits und in Euro, und du kannst das Fenster schließen, während die Take entsteht.
- **Use take** setzt eine fertige Take auf denselben Clip; die alte Take bleibt im Take Selector, du kannst also
  zurückschalten.
- Darunter stehen die offenen Notizen des Shots, jede mit **Go to** (setzt den Abspielkopf dorthin), **Reply**,
  **Resolve** und **Fix this note**. **Fix this note** macht einen Retake, der von der Notiz ausgeht. Ist er fertig, setzt
  **Use take** ihn auf den Clip und füllt die Antwort aus; gesendet wird erst, wenn du **Send reply** wählst.

Bei zu wenigen Credits ist **Retake** aus, und **Top up** öffnet Filmsquare im Browser. Ein Viewer-Schlüssel hat weder
Retake noch More.

## Eine Version zurückschicken

Im Fenster des Scripts-Menüs wählst du eine Schnittfassung (**Edit**) der Folge (oder **New edit…**) und dann **Render and send**.
Das Plugin rendert die aktuelle Timeline in eine H.264-Datei (MP4, bei Resolve ohne MP4-Angebot MOV), lädt sie hoch und
fügt sie als nächste Version dieser Schnittfassung hinzu.

Auf der Kommandozeile rendest du zuerst auf der Seite **Deliver**, dann:

```bash
python filmsquare_resolve.pyz push "EP01 cut.mp4"
```

`push` fragt nach der Schnittfassung oder legt eine neue an. Dateien über 64 MB gehen in Teilen hoch, bis 5 GB. Beim ersten
Versand einer Datei fragt Filmsquare dich einmal, ob du die Rechte daran hast.

Nach dem Versand siehst du die Versionsnummer und die offenen Anmerkungen, die sie trägt. **Open in Review** öffnet die Version
in **Review → Player**, wo das Crew-Mitglied sie ansieht und Anmerkungen auf Timecode hinterlässt. Siehe
[Anmerkungen, Pins und Review](https://www.filmsquare.ai/docs/de/working-together/notes-and-review/) und [Der Schnitt](https://www.filmsquare.ai/docs/de/working-together/the-cut/).

## Bekannte Grenzen

- Das Fenster braucht Resolve Studio. Kostenloses Resolve 21.1 und neuer hat kein Skriptfenster, nutze also die
  Kommandozeile.
- Marker laufen nur in eine Richtung, vom Hub zur Timeline. Marker, die du in Resolve setzt, gehen nicht zurück.
- Die zwei Tabs wurden gegen den Hub getestet, noch nicht in einem echten Resolve.
- Hat eine Resolve-Version keine Tabs, zeigt das Fenster alles in einer Spalte.
- Ohne Skript-Timer aktualisiert sich das Fenster nicht von selbst: Wähle **Refresh**.
- **Update** wurde außerhalb von Resolve getestet, noch nicht in einem echten Resolve.

## Wo dein Schlüssel liegt

Der Schlüssel wird nur für dich gespeichert, außerhalb jedes Resolve-Projekts:

- Windows: `%APPDATA%\Filmsquare\resolve.json`
- macOS: `~/Library/Application Support/Filmsquare/resolve.json`
- Linux: `~/.config/filmsquare/resolve.json`

Er geht nur an den Server, bei dem du angemeldet bist, über https (Klartext-http nur an einen Server auf deinem eigenen
Rechner). **Sign out** (oder `python filmsquare_resolve.pyz logout`) entfernt ihn von diesem Rechner. Um den Schlüssel
überall zu stoppen, trenne ihn unter **Settings → Claude**.
