whatisgithub

What is scriptbreak?

wassermanproductions/scriptbreak — explained in plain English

Analysis updated 2026-05-18

33HTMLAudience · writerComplexity · 2/5LicenseSetup · easy

In one sentence

A desktop app that breaks a screenplay into scenes, characters, and shot lists, then exports prompt packs for any AI chat tool.

Mindmap

mindmap
  root((repo))
    What it does
      Parses screenplay files
      Builds scene breakdown
      Creates shot lists and timeline
    Tech stack
      Rust
      Tauri
      HTML
    Use cases
      Script breakdown
      Character and prop bibles
      AI prompt pack export
    Audience
      Screenwriters
      Directors
      Film production staff

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

Import a screenplay in Fountain, Final Draft, PDF, or text format and get an automatic scene and element breakdown.

USE CASE 2

Generate character, location, and prop bibles pulled directly from the script for consistent AI prompts.

USE CASE 3

Export self-executing prompt packs to paste into ChatGPT, Claude, or Gemini for video and image generation.

What is it built with?

RustTauriHTML

How does it compare?

wassermanproductions/scriptbreaknodejs/nodejs-trthanhtran-165/vimovietnam
Stars333333
LanguageHTMLHTMLHTML
Last pushed2021-05-18
MaintenanceDormant
Setup difficultyeasyeasymoderate
Complexity2/51/52/5
Audiencewriterdeveloperresearcher

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

How do you get it running?

Difficulty · easy Time to first run · 5min

One-line installer on macOS, Windows and Linux installers come from Releases, no account or API key needed.

Free to use, modify, and distribute, including commercially, under the Apache 2.0 license.

So what is it?

ScriptBreak is a desktop app for filmmakers that reads a screenplay and turns it into an organized production breakdown, without sending anything to the cloud. A writer or director loads a script file, in formats like Fountain, Final Draft, PDF, or plain text, and the app automatically splits it into scenes and picks out details such as characters, locations, props, and costumes. It also builds starter shot lists from any camera directions the writer already wrote into the script, and creates a timeline showing the whole film as one strip, colored by location or by day and night. The app keeps a small bible of facts about each character, location, and important prop, pulled straight from how they are first described in the script, and lets a user add a mood board or pitch deck PDF so its notes on framing, camera, lighting, and music get folded into that bible too. Everything the tool detects can be edited or removed by hand, and a project can hold several drafts so a user can compare what changed between them, including which scenes were added, cut, or rewritten. What makes ScriptBreak different is how it connects to AI. Rather than calling an AI service directly, which would mean handing over an API key and sending the script to someone else's server, it exports what it calls prompt packs: plain text files that bundle the scene, character, and shot information together with instructions for an AI model. A user pastes one of these files into any chat based AI they already use, such as ChatGPT, Claude, or Gemini, and that AI carries out the analysis using its own account and terms. The tool itself never talks to a model provider or uploads the script anywhere, so the export is the entire integration. ScriptBreak installs as a desktop app on Mac, Windows, or Linux, with no server or account required to get started, and it is built using the Tauri framework with a Rust based wrapper. It is aimed at screenwriters, directors, and other film production staff who want organized breakdowns and AI assisted planning without giving up control of their script.

Copy-paste prompts

Prompt 1
Help me set up ScriptBreak on my Mac to break down my screenplay.
Prompt 2
Explain how ScriptBreak's prompt pack exports work with Claude or ChatGPT.
Prompt 3
Walk me through building ScriptBreak from source using Tauri and Rust.

Frequently asked questions

What is scriptbreak?

A desktop app that breaks a screenplay into scenes, characters, and shot lists, then exports prompt packs for any AI chat tool.

What language is scriptbreak written in?

Mainly HTML. The stack also includes Rust, Tauri, HTML.

What license does scriptbreak use?

Free to use, modify, and distribute, including commercially, under the Apache 2.0 license.

How hard is scriptbreak to set up?

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

Who is scriptbreak for?

Mainly writer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.