Filmsquare HelpDocs

8.0 Plugins8.3 Filmsquare for Blender

Filmsquare for Blender

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.

Updated 3 min read.md

On this page
  1. Install
  2. Sign in with a personal key
  3. Pick a shot
  4. Bring the elements and still in
  5. Send a still back
  6. Send a playblast back
  7. What stays in Filmsquare

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.

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:

OptionWhat you get
EmptiesImage empties: light, not rendered.
PlanesImage 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 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.

This page as Markdown: /docs/plugins/blender.md