whatisgithub

What is blockout?

wassermanproductions/blockout — explained in plain English

Analysis updated 2026-05-18

90TypeScriptAudience · generalComplexity · 3/5LicenseSetup · easy

In one sentence

A desktop app for staging camera moves and character blocking in a rough 3D scene, exporting a precise motion reference for AI video generators.

Mindmap

mindmap
  root((Blockout))
    What it does
      Stages grey box scenes
      Choreographs camera and cast
      Exports motion reference packages
    Tech stack
      TypeScript
      Desktop app
      MCP server
    Workflow
      Stage environment
      Shoot with marks
      Deliver export package
    Use cases
      AI video previs
      Crowd choreography
      Agent driven scene staging
    Audience
      Filmmakers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Plan a precise camera move and actor blocking before generating a shot with an AI video tool.

USE CASE 2

Stage a choreographed crowd scene like a dance number, fight, or chase with a single click.

USE CASE 3

Export a motion reference package tailored to a specific AI video generator like Veo or Kling.

USE CASE 4

Let an AI coding agent stage and shoot a scene automatically through the bundled MCP server.

What is it built with?

TypeScriptElectronMCP

How does it compare?

wassermanproductions/blockoutstephenleo/openmicrov9ai/ai-engineer-roadmap
Stars909090
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyeasymoderatemoderate
Complexity3/52/53/5
Audiencegeneraldeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 30min

Available as a downloadable desktop app for macOS and Windows from the project's releases page.

Use freely for any purpose, including commercial use, as long as you keep the required copyright and license notices.

So what is it?

Blockout is a desktop app for planning film shots before you actually film them or generate them with AI video tools. It lets you build a rough grey box version of a scene, using simple mannequin style people, vehicles, and props placed at real world scale, then move the camera and cast through the shot exactly the way a real film crew blocks out a scene on set. The point is not to make something pretty, it is to make a reference so clear that an AI video generator cannot misinterpret what you want. You work in three stages. In the Stage step, you drop in one of more than fifty ready made environments, such as a downtown street, supermarket, or backyard, and place people, animals, vehicles, and props from a built in library, labeling each subject so it stays easy to track. In the Shoot step, you select an actor, click the floor to drop numbered marks showing where they walk, and do the same for the camera, choosing a rig style such as dolly, steadicam, handheld, crane, or drone, with real lens and sensor settings modeled on actual film cameras. In the Deliver step, you pick which AI video generator you plan to use, among supported options like Seedance, Veo, Kling, LTX, and Wan, and export a full package: a reference video, a depth map video, still frames, a text prompt written from your actual blocking, and a ready to use ComfyUI workflow file. Beyond single shots, Blockout can stage whole choreographed crowds, such as a dance number, a fight, or a chase, by picking a size and style and clicking where you want the group to appear, and it includes a library of premade character motions and camera moves you can apply with one click. You can also import a 3D scan of a real location, made from your phone or another photo to 3D tool, and stage action inside it, though the scan itself is only used inside the editor and never appears in the final export. Every export is deterministic, meaning the same project always renders identical frames. A bundled MCP server also lets AI coding agents like Claude Code stage and shoot a scene automatically. The app runs on macOS and Windows and is released under the Apache 2.0 license.

Copy-paste prompts

Prompt 1
Walk me through staging a simple scene in Blockout and exporting a shot package for Kling.
Prompt 2
Explain how Blockout's Stage, Shoot, and Deliver workflow maps to how a real film crew blocks a scene.
Prompt 3
Show me how to use Blockout's one-click crowd feature to stage a chase sequence.
Prompt 4
Help me connect Blockout's MCP server to Claude Code so it can stage a shot for me.

Frequently asked questions

What is blockout?

A desktop app for staging camera moves and character blocking in a rough 3D scene, exporting a precise motion reference for AI video generators.

What language is blockout written in?

Mainly TypeScript. The stack also includes TypeScript, Electron, MCP.

What license does blockout use?

Use freely for any purpose, including commercial use, as long as you keep the required copyright and license notices.

How hard is blockout to set up?

Setup difficulty is rated easy, with roughly 30min to a first successful run.

Who is blockout for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.