Characters Overview

A Character in CSF is a named person in your project — with a description, portrait, scene appearances, and page-eighth stats. Characters are created automatically when you import a screenplay, or you can add them by hand from the Characters tab.

What Is a Character?

Each character record stores a name and an optional description (physical appearance, personality notes). The tab also surfaces computed stats for every character — a scene count and a total measured in page eighths — derived from where the character appears in the script. Characters can also carry one or more AI-generated or uploaded portraits.

Two Ways to Create Characters

Characters appear in your project through two paths:

Auto-parsed from a Script Import

When you import a screenplay, the parser detects every character name in the dialogue blocks and creates a character record automatically — already linked to the scenes it appears in.

Manual “+ Add Character”

Use the + Add Character button at the top of the Characters tab to create a character from scratch with a name and an optional description.

How Characters Connect to Everything

Characters sit at the center of your project data and flow into several downstream systems:

1Script — The screenplay you import

2Characters + Scenes — Parsed from dialogue and scene headings, linked scene-by-scene

3Wardrobes — A default wardrobe is created for each character on import, ready for per-scene costume designs

4Portraits — AI-generated or uploaded images, stored against the active production design

5Storyboards — Visual panels that reference character portraits and descriptions

Because portraits attach to the active production design, switching designs gives each character a fresh visual identity while keeping the same underlying character record and stats.

Characters and Sides

Once your project has a full screenplay, each character row can generate Sides — an audition script containing only the scenes where that character has dialogue. Sides are saved as their own script and open in the project’s script editor. Regenerating replaces the existing sides for that character.

The Characters Tab

The Characters tab in your project dashboard is where you manage your entire cast. Each row shows a portrait thumbnail, the character’s name, scene and page-eighth stats, and an editable description. From here you can add, describe, generate portraits, produce sides, and run bulk operations across any number of characters.