---
title: "DaVinci Resolve 플러그인"
description: "에피소드의 편집본을 DaVinci Resolve에서 타임라인으로 가져오고, 렌더한 결과를 편집 버전의 다음 버전으로 되돌려 보내요."
url: https://www.filmsquare.ai/docs/ko/plugins/resolve/
lang: ko
section: plugins
updated: 2026-11-16
---

# DaVinci Resolve 플러그인

DaVinci Resolve용 Filmsquare 플러그인은 에피소드의 편집본을 타임라인으로 가져와요. 모든 컷이 보드 순서대로 OK컷을 재생하고, **Edit → Cut**의 트림이 들어와요. 편집이 끝나면 렌더해서 이름 붙은 편집 버전의 다음 버전으로 되돌려 보내요. 이전 버전의 열린 코멘트는 따라가고, 몇 개가 열려 있는지와 **Review** 링크가 보여요.

플러그인은 베타예요. 플러그인에서 하는 일은 Filmsquare의 편집본을 바꾸지 않아요. 기준은 계속 허브이고, 돌아오는 것은 렌더 결과예요.

## 필요한 것

| | Scripts 메뉴 | 명령줄 |
| --- | --- | --- |
| Resolve Studio 18.5 이상 | 가능 | 가능 |
| 무료 Resolve 18.5에서 21.0 | 가능 | 가능 |
| 무료 Resolve 21.1 이상 | 불가 | 가능 |
| Python | 3.10 이상 | 3.10 이상 |

Resolve 21.1부터 Python 스크립팅이 Studio로 옮겨 갔어요. 무료 Resolve 21.1 이상에서는 스크립트가 **Workspace → Scripts** 메뉴에 나타나지 않아서 명령줄을 써요. Resolve 밖에서 같은 일을 하고, 타임라인 가져오기와 렌더는 직접 해요.

개인 키도 필요해요. Filmsquare에서 **Settings → Claude**를 열고 **Use a personal key instead**, 그다음 **Create a personal key**를 선택하세요. 키는 그 워크스페이스에서 내 역할로, 내 이름으로 일해요. 키가 보일 때 복사해 두세요. 다시 볼 수 없어요. Filmsquare가 보여 주는 명령 전체를 붙여넣어도 돼요. 플러그인이 거기서 키만 꺼내요.

## 설치

1. `resolve.zip`을 내려받아 풀어요. 파일 두 개가 필요해요. `Filmsquare.py`와 `filmsquare_resolve.pyz`예요.
2. 두 파일을 모든 페이지용 Resolve 스크립트 폴더에 복사해요.
   - 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. Resolve를 다시 시작해요. **Workspace → Scripts → Filmsquare**가 플러그인을 열어요.

명령줄에는 `filmsquare_resolve.pyz`만 있으면 돼요. 아무 데나 두세요.

## 업데이트

창을 열면 플러그인이 더 새로운 버전이 있는지 확인해요. 확인은 하루에 한 번까지예요. 새 버전이 있으면 창에 `Version 0.3.0 is ready.`와 **Update**가 보여요. **Update**는 새 버전을 내려받아 함께 공개된 지문으로 확인하고, 스크립트 폴더의 이전 파일을 새 파일로 바꿔요. 그다음 Filmsquare 창을 닫았다가 다시 여세요. 가져오기, 렌더, 리테이크가 진행 중이면 **Update**는 끝날 때까지 기다려요.

명령줄에서는 이렇게 해요.

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

플러그인이 스크립트 폴더에 쓸 수 없으면(예를 들어 모든 사용자용 폴더) **Update**가 **Download**로 바뀌어요. 새 `resolve.zip`을 풀고, 설치할 때처럼 두 파일을 복사하세요.

플러그인 사본을 따로 두는 자체 호스팅 스튜디오는 `resolve.zip` 옆에 `resolve.json`을 공개하고, `FILMSQUARE_UPDATE_URL`이나 `resolve.json` 옆의 `resolve-update.json`에 있는 `"update_url"`로 플러그인이 그곳을 보게 해요.

## 편집본을 Resolve로 가져오기

Scripts 메뉴 창에서 이렇게 해요.

1. 서버, 즉 브라우저에서 스튜디오를 여는 주소(`https://app.filmsquare.ai`)와 키를 입력하고 **Sign in**을 선택해요. 그러면 창에 그 스튜디오의 이름이 나와요.
2. **Production**과 **Episode**를 골라요.
3. **Import cut**을 선택해요.

플러그인이 OK컷을 홈 폴더의 `Filmsquare/Resolve`로 내려받고, 편집본을 열려 있는 프로젝트에 에피소드 이름의 타임라인(`EP01 cut`)으로 가져와요. 아직 OK컷이 없는 컷은 그 길이의 빈 구간이 돼요. 스틸은 유지 시간만큼 머물러요.

편집본의 열린 코멘트는 모두 타임라인의 마커가 돼요. 타임코드가 있으면 그 위치에, 없으면 컷의 첫 프레임에 놓여요. 마커에는 작성자, 코멘트, **Review → Player**의 에피소드 링크가 들어 있어요. 에피소드 전체에 단 코멘트는 첫 프레임에 놓여요. 같은 프레임의 코멘트는 마커 하나를 같이 써요. 해결된 코멘트는 빠져요.

명령줄에서는 이렇게 해요.

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

`pull`은 작품과 에피소드를 묻고, 미디어와 코멘트가 마커로 들어간 `.otio` 파일을 써요. Resolve에서 **File → Import → Timeline**을 선택하고 그 파일을 고르세요.

## 더 새로운 OK컷과 선택한 샷

창에는 탭이 두 개 있어요.

**Cut**에는 가져오기, 렌더, 더 새로운 OK컷이 모여 있어요. 가져온 뒤에 누군가 Filmsquare에서 더 새로운 OK컷을 정하면 탭에 개수(`Cut · 2`)가 보이고 해당 샷이 나열돼요. **Use picks**를 선택하면 더 새로운 OK컷이 같은 클립의 같은 자리에 같은 길이로 들어가요. 이전 테이크는 Resolve의 Take Selector에 남아 있어서 거기서 되돌릴 수 있어요. 내 트림보다 짧은 OK컷은 체크가 해제된 채로 남고 이유가 표시돼요.

**Shot**은 타임라인에서 선택한 클립을 따라가요. 샷의 테이크와 헤더의 잔액이 보여요.

- **Retake**는 샷의 새 테이크를 만들고, **More**는 그 샷에 4K 업스케일 같은 도구를 실행해요. 확인하기 전에 가격이 크레딧과 유로로 보이고, 테이크가 만들어지는 동안 창을 닫아도 돼요.
- **Use take**는 준비된 테이크를 같은 클립에 넣어요. 이전 테이크는 Take Selector에 남아 있어서 되돌릴 수 있어요.
- 아래에는 샷의 열린 코멘트가 있고, 각각 **Go to**(재생 헤드 이동), **Reply**, **Resolve**, **Fix this note**가 있어요. **Fix this note**는 코멘트에서 출발하는 리테이크를 만들어요. 준비되면 **Use take**가 클립에 넣고 답글을 채워 줘요. **Send reply**를 선택하기 전에는 아무것도 전송되지 않아요.

크레딧이 부족하면 **Retake**가 꺼지고 **Top up**이 브라우저에서 Filmsquare를 열어요. 뷰어 키에는 Retake와 More가 없어요.

## 한 버전 되돌려 보내기

Scripts 메뉴 창에서 에피소드의 **Edit**를 고르고(또는 **New edit…**) **Render and send**를 선택해요. 플러그인이 현재 타임라인을 H.264 파일 하나(MP4, Resolve가 MP4를 지원하지 않으면 MOV)로 렌더하고, 업로드하고, 그 편집 버전의 다음 버전으로 추가해요.

명령줄에서는 먼저 **Deliver** 페이지에서 렌더한 다음 이렇게 해요.

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

`push`는 편집 버전을 묻거나 새로 만들어요. 64MB가 넘는 파일은 나눠서 올라가고, 최대 5GB예요. 파일을 처음 보낼 때 Filmsquare가 그 파일에 대한 권리가 있다는 걸 한 번 확인해요.

보낸 뒤에는 버전 번호와 그 버전이 이어받은 열린 코멘트가 보이고, **Open in Review**는 **Review → Player**에서 그 버전을 열어요. 거기서 스태프가 보고 타임코드로 코멘트를 남겨요. [코멘트와 리뷰](https://www.filmsquare.ai/docs/ko/working-together/notes-and-review/), [편집본](https://www.filmsquare.ai/docs/ko/working-together/the-cut/)을 보세요.

## 알려진 제한

- 이 창은 Resolve Studio가 필요해요. 무료 Resolve 21.1 이상에는 스크립트 창이 없으니 명령줄을 쓰세요.
- 마커는 허브에서 타임라인으로, 한 방향으로만 가요. Resolve에서 추가한 마커는 다시 전송되지 않아요.
- 두 탭은 허브를 대상으로 테스트했고, 실제 Resolve에서는 아직 해 보지 않았어요.
- 탭이 없는 Resolve 빌드에서는 창이 모든 것을 한 열로 보여 줘요.
- 스크립트 타이머가 없으면 창이 저절로 갱신되지 않아요. **Refresh**를 선택하세요.
- **Update**는 Resolve 밖에서 테스트했고, 실제 Resolve에서는 아직 테스트하지 않았어요.

## 키가 보관되는 곳

키는 나만 쓰도록 Resolve 프로젝트 밖에 보관돼요.

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

로그인한 서버로만, https로 전송돼요(내 컴퓨터의 서버로는 일반 http도 돼요). **Sign out**(또는 `python filmsquare_resolve.pyz logout`)은 이 컴퓨터에서 키를 지워요. 키를 어디서든 멈추려면 **Settings → Claude**에서 연결을 해제하세요.
