Getting Started

This guide covers how to build scenes with LeetDreamer.

Prerequisites

• Python 3.10+
• FFmpeg (at ~/.local/bin/ffmpeg)
• OpenAI API key (for TTS)

Building a Scene

Run the build script with a scene specification:

python build.py scenes/two_pointers/scene.json -v

The -v flag enables verbose output to see pipeline progress.

Creating a Scene Spec

Scene specifications live in scenes/ and define:

{
  "title": "Two Sum II",
  "template": "two_pointers",
  "steps": [
    {
      "narration": "We start with two pointers.",
      "state": {
        "left": 0,
        "right": 6
      }
    }
  ]
}

Narration Guidelines

• One small phrase per step
• Be specific: "move the right pointer left" not "move right again"
• Keep pace comfortable for comprehension

Output

Generated videos are saved to output/ with the scene name and timestamp.