Filmsquare HelpDocs

2.0 How a film is organised2.1 Productions, episodes, scenes and shots

Productions, episodes, scenes and shots

How Filmsquare organises a film or series: production, episode, optional scene, shot, and the takes and picks on each shot.

Updated 3 min read.md

On this page
  1. Production
  2. Episode
  3. Scene
  4. Shot
  5. Picks
  6. Your sketchbook
  7. Nothing is deleted
  8. With your own Claude

Everything in Filmsquare hangs on one structure: a production has episodes, an episode has shots, and shots can be grouped in scenes. Each shot gets takes, and one take per layer is picked.

Production (series or film)
└── Episode (its own departments, its own cut)
    ├── Scene (optional)
    │   └── Shot → takes per layer → one pick per layer
    └── Shot (straight in the episode, no scene needed)

Production #

A production is a series or a film: its episodes, shots, cast, sets and the crew that signs them off. Its format is set when it is made:

FormatLaid out as
Series episodeEpisodes, each with its own departments and cut. An Episode picker sits under the production; every feature shows that episode
Short film, Feature, TrailerOne film, with no picker: every feature shows it

A production also holds its elements (cast, sets, props, styles), its folders, its canvases and its crew with their sign-off rules.

Productions are never hard-deleted. Delete production… in the production's Settings takes it out of every list for the whole crew; its takes, costs and sign-offs stay on record.

To keep a finished production without it filling your lists, Archive it from its card menu, the sidebar or its Settings. It leaves Home, the sidebar and Productions for the whole crew and shows under Productions → Archived. It still opens and works as always, and Restore brings it back. An archived production still counts toward the productions of the Free plan.

Episode #

An episode is the unit that moves through the departments. Each episode has:

  • its own nine departments and their sign-offs;
  • its own script and script revisions;
  • its own cut: its shots back to back, in cut order;
  • its own finals gate.

A film has one episode, with no picker. A producer or owner adds episodes with New episode, or a script import makes them.

Scene #

A scene groups shots: a place and a time, such as INT. KITCHEN – NIGHT. Scenes are optional. A shot can sit straight in an episode; Filmsquare then keeps it in the episode's default scene. A script breakdown makes scenes for you. Some takes live on a scene rather than a shot: dialogue (one voice take per character per scene) and music.

Shot #

A shot is one camera set-up in the film. It has a code (such as S2-03, the third shot of scene S2), a description, acting notes, a length, and the camera: size, angle and movement. It uses elements: the cast members, set and props in it, called by their @handle.

A shot has layers, and each layer has its own takes:

LayerWhat it is
KeyframeA still: the frame the shot is built on, and what the animatic shows
VideoThe moving shot, as a draft or a final
DialogueThe spoken lines
Sound (sfx)Sound effects
MusicMusic, usually per scene

Making shots and scenes needs the director role or higher. See Takes, drafts and finals.

Picks #

On each layer you pick one take: that is what the animatic, the cut and the finals use. Picking needs the director role or higher. A pick is recorded with who made it and when, and is never overwritten: picking another take adds a new pick. A new pick can make a signed-off department stale, see When a sign-off goes stale.

Your sketchbook #

Create gives every director a private sketchbook: shots that belong to no production yet. Nobody else sees them. Use in a production turns a take into a new shot in an episode, with the take picked.

Nothing is deleted #

Shots, scenes, episodes, elements and folders are archived, not deleted. Versions of assets and elements never change once made, and picks, sign-offs and costs are only ever added to. That is what makes every final traceable: who signed off what, with which model, references and version.

With your own Claude #

list_productions lists the productions and their episodes; get_episode gives an episode's scenes and shots in cut order, every department step and whether the finals can render. See What Claude can do.

With Claude

MCP

Your own Claude does this over MCP, in your name and with your role:

  • list_productions

    Lists the productions in your workspace with their episodes.

    Ask: Which productions and episodes do we have in Filmsquare?

  • get_episode

    Shows an episode's scenes and shots in cut order, every department step, and whether finals can render.

    Ask: Where does episode 2 stand, and who is each step waiting on?

Connect Claude 5.1

This page as Markdown: /docs/concepts/structure.md