---
title: "Filmsquare for Blender"
description: "Bring a shot's elements and still into Blender for 3D blocking, and send a still or playblast back as a new version on the shot."
url: https://www.filmsquare.ai/docs/plugins/blender/
lang: en
section: plugins
updated: 2026-11-09
---

# Filmsquare for Blender

The Filmsquare add-on for Blender 4.2 and later brings a shot into your scene: the cast, locations and props it
uses, and its still. When the blocking is ready, it sends a still or a playblast back to the same shot as a new
version. The work shows up under **Storyboard → 3D** of the production.

The add-on is in beta. It is free and licensed under GPL-3.0-or-later.

## Install

1. Download `blender.zip` from the Plugins page.
2. In Blender, open **Edit → Preferences → Get Extensions**.
3. Open the menu at the top right and choose **Install from Disk**, then pick the zip.
4. In **Preferences → System**, turn on **Allow Online Access**. Without it the add-on does not connect.

## Sign in with a personal key

The add-on works in your name, with your role, in one workspace. It uses a personal key, the same kind you use for
Claude Code.

1. In Filmsquare, open **Settings → Claude** and choose **Use a personal key instead**.
2. Give it a **Name of the key** (for example "Blender on my workstation") and choose **Create a personal key**.
3. Copy the key. It starts with `fsk_` and is shown once.
4. In Blender, open **Edit → Preferences → Add-ons**, expand **Filmsquare** and paste the key into **Key**.
5. Choose **Test**. The add-on shows the workspace and your role.

The key is stored in your Blender preferences, on this computer only. Anyone with the key can work as you in this
workspace: disconnect it on **Settings → Claude** if it leaks.

> [!NOTE]
> Bringing a shot in needs any role. Sending work back needs the maker role or higher.

## Pick a shot

Open the sidebar in the 3D viewport (press `N`) and choose the **Filmsquare** tab. Pick, from top to bottom:

1. **Production**
2. **Episode**
3. **Scene**. A production without named scenes has one scene, **All shots**.
4. **Shot**

The refresh button reloads the list of productions.

## Bring the elements and still in

Under **Import**, choose how references arrive, then **Import elements and still**:

| Option | What you get |
| --- | --- |
| **Empties** | Image empties: light, not rendered. |
| **Planes** | Image planes with a material: they render. |

The add-on makes a collection `Filmsquare` with one collection per shot, holding **Cast**, **Locations**, **Props**
and **Stills**. Per element it takes the version the shot uses (the pinned version, or the current one) and the best
two references of it: the canonical ones first, then front or full body for cast, wide for locations. Style elements
are left out.

The still of the shot (the picked keyframe, or the newest one) also becomes the background of the scene camera.
With **Use shot lens** on, the camera takes the shot's focal length. Importing again adds only what is new.

## Send a still back

1. Frame the shot with the scene camera.
2. Under **Send**, choose **Still from**: **Render** (the render engine) or **Viewport** (fast, a viewport frame
   through the scene camera).
3. Optionally describe the camera **Move**, for example "slow push in".
4. Choose **Send still**.

The frame lands on the shot under **Storyboard → 3D** with the camera's focal length and height above the floor
(metres). Every still you send is a new version of the shot's blocking frame; the newest one counts. In Filmsquare,
a take can then be made from it with the frame as the structure reference.

The first time you send work, Filmsquare asks you once to state that you have the rights to your files. The add-on
then shows that statement under **Send** with **Confirm**. Choose **Confirm**, then send again.

## Send a playblast back

Choose **Send playblast**. The add-on renders the viewport animation of the scene's frame range to an MP4 and adds
it to the shot as a 3D clip under **Storyboard → 3D**. Sending again from the same shot makes a new version of that
clip. Files above 64 MB go up in parts, so a long playblast works too.

## What stays in Filmsquare

The add-on only calls the public [API](https://www.filmsquare.ai/docs/api/overview/) with your key. Element versions, picks, sign-off and
costs stay in Filmsquare; the add-on reads them and never changes them. It does not make takes and does not spend
credits.
