# Screenwriter

An Obsidian plugin for developing screenplays: treatments, outlines, character arcs, scene cards, and beat sheets.

## Features

- **New Screenplay Project** — Creates a project folder with 5 pre-structured files: Treatment, Outline, Characters, Beat Sheet (Blake Snyder's 15 beats), and Notes
- **New Character** — Add a character entry (archetype, want, need, flaw, arc) to any project's Characters.md
- **New Scene Card** — Add a scene card (scene number, location, time of day, characters, action, purpose) to the project's Outline.md
- **Projects Sidebar** — Lists all projects with format badge, status badge, and scene count

## Usage

Open the command palette (`Ctrl/Cmd+P`) and search for:
- `Screenwriter: New Screenplay Project`
- `Screenwriter: New Character`
- `Screenwriter: New Scene Card`
- `Screenwriter: Open Screenwriter Sidebar`

## Project Structure

Each project creates:
```
Screenwriting/
  My Project/
    Treatment.md
    Outline.md
    Characters.md
    Beat Sheet.md   ← Blake Snyder's 15 beats pre-filled
    Notes.md
```

## Settings

| Setting | Default | Description |
|---------|---------|-------------|
| Projects Folder | `Screenwriting` | Root folder for all screenplay projects |

## License

MIT © 2026 Wesley Swart