# Storyboard Shot Builder

> Turn a timed shot list into an editable storyboard with simple staging sketches. Plan boards with action, dialogue, scene, shot size and camera notes. Quantize durations to frames, add optional stick-figure staging, and download an editable Flipline Story Desk project, shot list and dialogue subtitles.

Part of usefulweb.site (https://usefulweb.site/). Results are deterministic calculations from the inputs and the listed assumptions; the API returns exactly what the web page shows.

## Use it
- Human interface: https://fliplinestoryboardbuilder.usefulweb.site/ (interactive tool at https://fliplinestoryboardbuilder.usefulweb.site/tool)
- JSON API: POST https://fliplinestoryboardbuilder.usefulweb.site/api/v1/calculate with a JSON object of inputs (schema: https://fliplinestoryboardbuilder.usefulweb.site/api/v1/tool)
- OpenAPI: https://fliplinestoryboardbuilder.usefulweb.site/openapi.json
- MCP (Streamable HTTP): https://fliplinestoryboardbuilder.usefulweb.site/mcp - tool `flipline_storyboard_builder`

## Inputs
- shots (textarea): Shots: Title | Seconds | Action | Dialogue | Scene | Shot size | Camera
- name (text): Storyboard name
- fps (integer): Storyboard frame rate (FPS)
- aspect (select): Storyboard aspect ratio
- staging (boolean): Add editable staging sketches

## Method
- Each nonblank line uses Title | Seconds | Action | Dialogue, optionally followed by Scene | Shot size | Camera. Pipes cannot appear inside fields. Shot sizes: wide, medium, close, detail, over-shoulder. Camera labels: static, pan-left, pan-right, tilt-up, tilt-down, push-in, pull-out, handheld.
- Seconds are rounded to the nearest whole frame, with a minimum of one frame. Board intervals are half-open; timecodes are non-drop-frame at integer 1–30 FPS. Maximum 48 boards, 120 seconds per board and ten minutes total.
- Staging sketches are original, deterministic stick figures and a ground line. They are editable drawing marks, not AI-generated images or 3D camera simulations. No Storyboarder project, Fountain screenplay or NLE timeline import is provided.