---
title: "Plugin per DaVinci Resolve"
description: "Porta il montaggio di un episodio in DaVinci Resolve come timeline, e rimanda il tuo render come versione successiva di una versione di montaggio."
url: https://www.filmsquare.ai/docs/it/plugins/resolve/
lang: it
section: plugins
updated: 2026-11-16
---

# Plugin per DaVinci Resolve

Il plugin Filmsquare per DaVinci Resolve porta il montaggio di un episodio in Resolve come timeline: ogni
inquadratura in ordine di board che riproduce il suo ciak scelto, con le rifilature di **Edit → Cut**. Quando l'hai
montato, lo renderizzi e lo rimandi come versione successiva di una versione di montaggio con nome. Le note aperte
della versione precedente passano con esso, e vedi quante sono aperte con un link a **Review**.

Il plugin è in beta. Niente al suo interno cambia il montaggio in Filmsquare: la fonte resta l'hub, e ciò che
torna è un render.

## Cosa ti serve

| | Menu Scripts | Riga di comando |
| --- | --- | --- |
| Resolve Studio 18.5 o successivo | Sì | Sì |
| Resolve gratuito da 18.5 a 21.0 | Sì | Sì |
| Resolve gratuito 21.1 o successivo | No | Sì |
| Python | 3.10 o successivo | 3.10 o successivo |

Resolve 21.1 ha spostato lo scripting Python su Studio. Nel Resolve gratuito 21.1 e successivi lo script non compare
nel menu **Workspace → Scripts**, quindi usi la riga di comando: fa lo stesso lavoro fuori da Resolve, e importi la
timeline e renderizzi tu.

Ti serve anche una chiave personale: in Filmsquare apri **Settings → Claude**, scegli **Use a personal key
instead**, poi **Create a personal key**. La chiave funziona come te, con il tuo ruolo, in quello spazio di lavoro.
Copiala quando viene mostrata: non la rivedrai. Puoi incollare l'intero comando che mostra Filmsquare; il plugin ne
estrae la chiave.

## Installazione

1. Scarica `resolve.zip` e scompattalo. Ti servono due dei suoi file: `Filmsquare.py` e `filmsquare_resolve.pyz`.
2. Copia entrambi i file nella cartella degli script di Resolve per tutte le pagine:
   - 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. Riavvia Resolve. **Workspace → Scripts → Filmsquare** apre il plugin.

Per la riga di comando ti serve solo `filmsquare_resolve.pyz`; tienilo dove vuoi.

## Aggiornamenti

Quando apri la finestra, il plugin cerca una versione più nuova, al massimo una volta al giorno. Se c'è, la finestra mostra `Version 0.3.0 is ready.` con **Update**. **Update** scarica la nuova versione, la controlla con l'impronta pubblicata insieme a lei e mette i file nuovi al posto dei vecchi nella cartella degli script. Poi chiudi la finestra di Filmsquare e riaprila. **Update** aspetta finché è in corso un import, un render o un retake.

Dalla riga di comando:

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

Se il plugin non può scrivere nella cartella degli script (per esempio quella per tutti gli utenti), **Update** diventa **Download**: scompatta il nuovo `resolve.zip` e copia i due file, come all'installazione.

Uno studio self-hosted che tiene una propria copia del plugin pubblica `resolve.json` accanto al suo `resolve.zip` e ci indirizza il plugin con `FILMSQUARE_UPDATE_URL`, oppure con `"update_url"` in `resolve-update.json`, accanto a `resolve.json`.

## Portare il montaggio in Resolve

Nella finestra del menu Scripts:

1. Inserisci il server, l'indirizzo con cui apri lo studio nel browser (`https://app.filmsquare.ai`), e la tua
   chiave, e scegli **Sign in**. La finestra porta poi il nome di quello studio.
2. Scegli la **Production** e l'**Episode**.
3. Scegli **Import cut**.

Il plugin scarica i ciak scelti in `Filmsquare/Resolve` nella tua cartella home e importa il montaggio come timeline
nel progetto aperto, con il nome dell'episodio (`EP01 cut`). Un'inquadratura senza ancora nulla di scelto diventa un
vuoto della sua durata. Uno still resta per il suo tempo di tenuta.

Ogni nota aperta sul montaggio diventa un marker sulla timeline: al suo timecode quando ce l'ha, altrimenti sul primo
fotogramma dell'inquadratura. Il marker contiene l'autore, la nota e un link all'episodio in **Review → Player**.
Una nota sull'intero episodio sta sul primo fotogramma. Le note sullo stesso fotogramma condividono un marker. Le
note risolte restano fuori.

Da riga di comando:

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

`pull` chiede la produzione e l'episodio, e scrive i media e un file `.otio` con le note come marker. In Resolve
scegli **File → Import → Timeline** e scegli quel file.

## Scelte più recenti e l'inquadratura selezionata

La finestra ha due tab.

**Cut** contiene l'importazione, il render e le scelte più recenti. Quando qualcuno imposta in Filmsquare una scelta più recente dopo la tua importazione, il tab mostra un conteggio (`Cut · 2`) ed elenca le inquadrature. Scegli **Use picks** e ogni scelta più recente finisce sulla stessa clip, nello stesso punto e con la stessa lunghezza; il ciak vecchio resta nel Take Selector di Resolve, così puoi tornare indietro da lì. Una scelta più corta della tua rifilatura resta senza spunta, con il motivo.

**Shot** segue la clip che selezioni sulla timeline. Mostra i ciak dell'inquadratura e un saldo nell'intestazione:

- **Retake** crea un nuovo ciak dell'inquadratura, **More** ci applica uno strumento, per esempio un upscale a 4K. Il prezzo è mostrato in crediti e in euro prima di confermare, e puoi chiudere la finestra mentre il ciak viene creato.
- **Use take** mette un ciak pronto sulla stessa clip; il ciak vecchio resta nel Take Selector, così puoi tornare indietro.
- Sotto ci sono le note aperte dell'inquadratura, ognuna con **Go to** (sposta la testina), **Reply**, **Resolve** e **Fix this note**. **Fix this note** crea un retake che parte dalla nota. Quando è pronto, **Use take** lo mette sulla clip e compila la risposta; non viene inviato nulla finché non scegli **Send reply**.

Con pochi crediti, **Retake** è disattivato e **Top up** apre Filmsquare nel browser. Una chiave da spettatore non ha né Retake né More.

## Rimandare una versione

Nella finestra del menu Scripts, scegli una **Edit** dell'episodio (oppure **New edit…**) e scegli **Render and
send**. Il plugin renderizza la timeline attuale in un unico file H.264 (MP4, o MOV dove Resolve non offre MP4), lo
carica e lo aggiunge come versione successiva di quella versione di montaggio.

Da riga di comando, renderizza prima nella pagina **Deliver**, poi:

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

`push` chiede la versione di montaggio, o ne crea una nuova. I file oltre 64 MB vengono caricati a parti, fino a 5
GB. La prima volta che mandi un file, Filmsquare ti chiede una volta sola di dichiarare di avere i diritti su di
esso.

Dopo l'invio vedi il numero di versione e le note aperte che porta con sé, e **Open in Review** apre la versione in
**Review → Player**, dove la troupe la guarda e lascia note sul timecode. Vedi
[note e revisione](https://www.filmsquare.ai/docs/it/working-together/notes-and-review/) e [il montaggio](https://www.filmsquare.ai/docs/it/working-together/the-cut/).

## Limiti noti

- La finestra richiede Resolve Studio. Il Resolve gratuito 21.1 e successivi non ha una finestra di script, quindi usa la riga di comando.
- I marker vanno in una sola direzione, dall'hub alla timeline. I marker che aggiungi in Resolve non vengono rimandati indietro.
- I due tab sono stati provati contro l'hub, non ancora su un Resolve vero.
- Se una build di Resolve non ha i tab, la finestra mostra tutto in un'unica colonna.
- Senza un timer di script, la finestra non si aggiorna da sola: scegli **Refresh**.
- **Update** è stato provato fuori da Resolve, non ancora su un Resolve vero.

## Dove viene conservata la tua chiave

La chiave è conservata solo per te, fuori da qualsiasi progetto Resolve:

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

Viene inviata solo al server a cui hai effettuato l'accesso, via https (http semplice solo verso un server sul tuo
computer). **Sign out** (o `python filmsquare_resolve.pyz logout`) la rimuove da questo computer. Per fermare la
chiave ovunque, scollegala sotto **Settings → Claude**.
