Skip to content

Repository files navigation

ScriptScreen

Write your screenplay on a board of plot cards.

ScriptScreen is a free, open-source desktop app for writing screenplays. Every scene is a plot card on an infinite board: its place is set by the card's own index attribute; tag it with characters, locations, story details and time of action, then click a tag to filter the board down to a single thread. Scene text is written in a built-in rich-text editor, and can be dictated — speech recognition runs locally on your machine. Export the finished script to PDF.

Linux and Windows. English and Russian interface. Apache 2.0.

🇷🇺 Русская версия: README.ru.md

Features

  • Plot cards on an infinite board — zoom and pan; Shift+Click to add a scene.
  • Scene order is a card attribute — the card's index field sets its place on the board and in the finished script; to move a scene, change the number.
  • Four tag dimensions — Roles, Locations, Details and Action Times, attached to any scene.
  • One-click filtering — click a tag chip to show only the scenes carrying it; tags combine.
  • Built-in script editor — full rich-text editing of scene bodies, saved automatically.
  • Offline dictation — transcribe audio files or live microphone input via whisper.cpp, locally.
  • Front matter — title page, logline and synopsis kept with the script.
  • Text import — bring in a script written elsewhere: mark the flat text with a handful of tags and it becomes cards, roles, locations, details and action times.
  • PDF export — the assembled screenplay with title page and table of contents, scenes in index order.
  • Your files stay yours — a project is plain JSON plus HTML scene files on your disk; changing the name or version keeps a separate version of the script instead of overwriting the previous one.
  • No account, no cloud, no telemetry.

Installation

Open the releases page, download the archive for your platform, unpack it and run the install script. Everything is installed under your user account — no administrator rights are required. In the file names below <version> is the version of the release you picked.

ArchiveWhat it isInstall command
scriptscreen-<version>-linux.tar.gzLinux, x86-64. Speech is transcribed on the CPU — works on any machine, no video card needed../install.sh
scriptscreen-<version>-linux-gpu-vulkan.tar.gzThe same Linux build, but the speech models run on a Vulkan-capable GPU: dictation, live transcription especially, is noticeably faster../install.sh
scriptscreen-<version>-windows.zipWindows 10/11, x86-64. Speech is transcribed on the CPU — works on any machine, no video card needed.right-click install.ps1Run with PowerShell
scriptscreen-<version>-windows-gpu-vulkan.zipThe same Windows build with speech models running on a Vulkan-capable GPU — faster dictation.right-click install.ps1Run with PowerShell

If you are unsure which one to take, take the plain (CPU) archive: it works everywhere, and the GPU one only changes how fast dictation is, not what the app can do.

The installer also sets up the components used for dictation: whisper.cpp speech models and ffmpeg, placed under ~/whisper.cpp.

macOS is supported by the code but not published as a build yet — build it from source with dist/make-dist.sh --platform macos (see DISTRIBUTION.md).

Full installation, uninstallation and troubleshooting instructions: DISTRIBUTION.md (ru). The same guide ships inside every archive as INSTALL.md / INSTALL.ru.md.

Documentation

Getting started

  1. Open the app and create a project (Project panel ▸ menu ▸ New Project).
  2. Go to the Cards panel and Shift+Click the board to add your first plot card.
  3. Add characters, locations, details and action times in their own panels, then tag the card with them.
  4. Select the card and write the scene in the editor — or dictate it.
  5. Export the finished script to PDF from the Project panel.

License

Apache License 2.0.

Support Me

ETH: 0xD28545A4a16C0857cD8af84185CcaAa9Bbef675e
BTC: bc1q20nv9jj0zt04e0sa4h6s8xgyur70e48ue2de5r
SOL: 596MbbR8XGhFbCHzhWGgJEmPe42VjT7bSpMbUPBV41TU
TRX: TSKCpMdPswcqRbBEmnq2cseQ6zr9XiwdDX

About

Screenplay writing on a board of plot cards: tag scenes with characters, locations, details and time, filter the board, write in a built-in rich-text editor, dictate offline with whisper.cpp, export to PDF. Free and open source for Linux and Windows.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages