---
title: "Plugin DaVinci Resolve"
description: "Importez le montage d'un épisode dans DaVinci Resolve sous forme de timeline, et renvoyez votre rendu comme nouvelle version de montage."
url: https://www.filmsquare.ai/docs/fr/plugins/resolve/
lang: fr
section: plugins
updated: 2026-11-16
---

# Plugin DaVinci Resolve

Le plugin Filmsquare pour DaVinci Resolve importe le montage d'un épisode dans Resolve sous forme de timeline : chaque plan
dans l'ordre du storyboard joue sa prise retenue, avec les ajustements de **Edit → Cut**. Une fois le montage fait, vous en faites le rendu
et le renvoyez comme nouvelle version d'une version de montage nommée. Les notes ouvertes de la version précédente suivent, et vous
voyez combien sont encore ouvertes, avec un lien vers **Review**.

Le plugin est en bêta. Rien dans le plugin ne modifie le montage dans Filmsquare : le hub reste la source, et ce qui
revient est un rendu.

## Ce qu'il vous faut

| | Menu Scripts | Ligne de commande |
| --- | --- | --- |
| Resolve Studio 18.5 ou plus récent | Oui | Oui |
| Resolve gratuit 18.5 à 21.0 | Oui | Oui |
| Resolve gratuit 21.1 ou plus récent | Non | Oui |
| Python | 3.10 ou plus récent | 3.10 ou plus récent |

Resolve 21.1 a déplacé le scripting Python dans Studio. Dans Resolve gratuit 21.1 et plus récent, le script n'apparaît pas
dans le menu **Workspace → Scripts** : utilisez donc la ligne de commande. Elle fait le même travail en dehors de Resolve ;
vous importez la timeline et lancez le rendu vous-même.

Il vous faut aussi une clé personnelle : dans Filmsquare, ouvrez **Settings → Claude**, choisissez **Use a personal key
instead**, puis **Create a personal key**. La clé agit comme vous, avec votre rôle, dans cet espace de travail. Copiez-la
quand elle s'affiche : vous ne la reverrez plus. Vous pouvez coller la commande complète que Filmsquare affiche ; le
plugin extrait la clé lui-même.

## Installer

1. Téléchargez `resolve.zip` et décompressez-le. Vous avez besoin de deux de ses fichiers : `Filmsquare.py` et `filmsquare_resolve.pyz`.
2. Copiez les deux fichiers dans le dossier de scripts de Resolve, pour toutes les pages :
   - 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. Redémarrez Resolve. **Workspace → Scripts → Filmsquare** ouvre le plugin.

Pour la ligne de commande, il suffit de `filmsquare_resolve.pyz` ; gardez-le où vous voulez.

## Mises à jour

Quand vous ouvrez la fenêtre, le plugin cherche une version plus récente, au plus une fois par jour. S'il y en a une, la fenêtre affiche `Version 0.3.0 is ready.` avec **Update**. **Update** télécharge la nouvelle version, la vérifie avec l'empreinte publiée avec elle et remplace les anciens fichiers par les nouveaux dans le dossier de scripts. Fermez ensuite la fenêtre Filmsquare et rouvrez-la. **Update** attend tant qu'un import, un rendu ou un retake est en cours.

En ligne de commande :

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

Si le plugin ne peut pas écrire dans le dossier de scripts (celui de tous les utilisateurs, par exemple), **Update** devient **Download** : décompressez le nouveau `resolve.zip` et copiez-y les deux fichiers, comme à l'installation.

Un studio auto-hébergé qui garde sa propre copie du plugin publie `resolve.json` à côté de son `resolve.zip` et y renvoie le plugin avec `FILMSQUARE_UPDATE_URL`, ou avec `"update_url"` dans `resolve-update.json`, à côté de `resolve.json`.

## Importer le montage dans Resolve

Dans la fenêtre du menu Scripts :

1. Saisissez le serveur, l'adresse à laquelle vous ouvrez le studio dans votre navigateur (`https://app.filmsquare.ai`), et votre clé, puis choisissez **Sign in** (se connecter). La fenêtre porte ensuite le nom de ce studio.
2. Choisissez la **Production** et l'**Episode**.
3. Choisissez **Import cut**.

Le plugin télécharge les prises retenues dans `Filmsquare/Resolve`, dans votre dossier personnel, et importe le montage comme
timeline dans le projet ouvert, nommée d'après l'épisode (`EP01 cut`). Un plan sans rien de retenu devient un trou de sa
durée. Une image fixe tient pendant sa durée de maintien.

Chaque note ouverte sur le montage devient un marqueur sur la timeline : à son timecode si elle en a un, sinon sur la
première image du plan. Le marqueur contient l'auteur, la note et un lien vers l'épisode dans **Review → Player**. Une
note sur l'épisode entier se place sur la première image. Les notes sur la même image partagent un marqueur. Les notes
marquées comme traitées sont exclues.

En ligne de commande :

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

`pull` demande la production et l'épisode, puis écrit les médias et un fichier `.otio` avec les notes en marqueurs. Dans
Resolve, choisissez **File → Import → Timeline** et sélectionnez ce fichier.

## Nouvelles prises retenues et plan sélectionné

La fenêtre a deux onglets.

**Cut** contient l'import, le rendu et les nouvelles prises retenues. Si quelqu'un retient une prise plus récente dans
Filmsquare après votre import, l'onglet affiche un nombre (`Cut · 2`) et liste les plans. Choisissez **Use picks** : chaque
prise plus récente se place sur le même clip, au même endroit et à la même durée ; l'ancienne prise reste dans le Take
Selector de Resolve, vous pouvez donc y revenir. Une prise plus courte que votre découpe
reste décochée, avec la raison.

**Shot** suit le clip que vous sélectionnez sur la timeline. Il montre les prises du plan et, en haut, votre solde :

- **Retake** crée une nouvelle prise du plan, **More** lui applique un outil, par exemple un upscale en 4K. Le prix est
  indiqué d'avance en crédits et en euros, et vous pouvez fermer la fenêtre pendant que la prise se fait.
- **Use take** place une prise prête sur le même clip ; l'ancienne prise reste dans le Take Selector, vous pouvez donc
  y revenir.
- En dessous, les notes ouvertes du plan, chacune avec **Go to** (place la tête de lecture), **Reply**, **Resolve** et
  **Fix this note**. **Fix this note** lance un retake à partir de la note. Quand il est prêt, **Use take** le place sur le
  clip et remplit la réponse ; rien n'est envoyé tant que vous ne choisissez pas **Send reply**.

Avec trop peu de crédits, **Retake** est désactivé et **Top up** ouvre Filmsquare dans votre navigateur. Une clé de
lecture (viewer) n'a ni Retake ni More.

## Renvoyer une version

Dans la fenêtre du menu Scripts, choisissez un **Edit** de l'épisode (ou **New edit…**) et choisissez **Render and send**.
Le plugin rend la timeline courante en un seul fichier H.264 (MP4, ou MOV si Resolve ne propose pas le MP4), l'envoie et
l'ajoute comme version suivante de cette version de montage.

En ligne de commande, lancez d'abord le rendu sur la page **Deliver**, puis :

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

`push` demande la version de montage, ou en crée une nouvelle. Les fichiers de plus de 64 Mo sont envoyés par morceaux, jusqu'à 5 Go. La
première fois que vous envoyez un fichier, Filmsquare vous demande une fois de confirmer que vous en avez les droits.

Après l'envoi, vous voyez le numéro de version et les notes ouvertes qu'elle contient. **Open in Review** ouvre la version
dans **Review → Player**, où l'équipe la regarde et laisse des notes au timecode. Voir
[notes, repères et revue](https://www.filmsquare.ai/docs/fr/working-together/notes-and-review/) et [le montage](https://www.filmsquare.ai/docs/fr/working-together/the-cut/).

## Limites connues

- La fenêtre demande Resolve Studio. Resolve gratuit 21.1 et plus récent n'a pas de fenêtre de script : utilisez la
  ligne de commande.
- Les marqueurs vont dans un seul sens, du hub vers la timeline. Les marqueurs que vous ajoutez dans Resolve ne sont pas
  renvoyés.
- Les deux onglets ont été testés avec le hub, pas encore dans un vrai Resolve.
- Si une version de Resolve n'a pas d'onglets, la fenêtre affiche tout dans une seule colonne.
- Sans minuteur de script, la fenêtre ne se met pas à jour seule : choisissez **Refresh**.
- **Update** a été testé hors de Resolve, pas encore dans un vrai Resolve.

## Où est conservée votre clé

La clé n'est conservée que pour vous, en dehors de tout projet Resolve :

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

Elle n'est envoyée qu'au serveur auquel vous êtes connecté, en https (http en clair seulement vers un serveur sur votre
propre ordinateur). **Sign out** (ou `python filmsquare_resolve.pyz logout`) la supprime de cet ordinateur. Pour arrêter
la clé partout, déconnectez-la sous **Settings → Claude**.
