> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lettherebe.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Take one line of screenplay through every stage of LTB — beat, shot, video, and share — in about 10 minutes with this end-to-end tutorial.

Write one line. Generate one shot. Animate that shot into an 8-second video. This guide walks the shortest path through LTB and ends with a public share link. Defaults are enough — no configuration needed.

<Frame caption="The shortest path — line to beat to shot to video to link">
  {/* TODO: embed finished 8-second sample (Kling 3.0 Pro, 1080p, autoplay/loop) */}
</Frame>

## What LTB produces

LTB treats each line of your screenplay as a **beat** — one unit of staging. Each beat gets one **shot image**. Each chosen shot becomes the **first frame of a video clip**.

```
Line → Beat → Shot → Video
```

The first frame controls tone, composition, and identity. Spend more effort on the shot than on the prompt — animation amplifies whatever the frame already shows.

## Before you start

You need three things ready. None of them require setup beyond signup.

* A verified account with dashboard access
* A free plan with `30 tokens/month` — roughly one `1080p` `8s` video
* Chrome, Edge, Safari, or Firefox on a current version

Total time runs about 10 minutes. Hands-on work is around 4 minutes; the rest is model wait time.

## Six steps

<Steps>
  <Step title="Create a project">
    Click `New project` on the dashboard. Name it anything — you can rename it later.

    <Frame caption="Naming is free-form and editable later">
      <img src="https://mintcdn.com/lettherebe/E_AEVPp8svVTgFNI/images/quickstart/new-project-modal.png?fit=max&auto=format&n=E_AEVPp8svVTgFNI&q=85&s=71372693af78cb52666581cdf9459179" alt="New project modal" width="1440" height="900" data-path="images/quickstart/new-project-modal.png" />
    </Frame>

    <Warning>
      Project deletion is permanent. LTB has no trash or restore — once you confirm, the project and every shot inside it are gone.
    </Warning>
  </Step>

  <Step title="Write your first line">
    One line is enough to start.

    ```
    A woman stands on the pier at sunset.
    ```

    LTB reads this as one beat. One beat produces one shot. Add more lines later — each line becomes its own beat. Block syntax and `@` mentions are covered in [Scenario](/workflows/scenario).

    <Frame caption="One line equals one beat">
      <img src="https://mintcdn.com/lettherebe/E_AEVPp8svVTgFNI/images/quickstart/first-line.png?fit=max&auto=format&n=E_AEVPp8svVTgFNI&q=85&s=ccd3a9c116907d3cb62ea510fc395b9d" alt="First line in the scenario editor" width="1440" height="900" data-path="images/quickstart/first-line.png" />
    </Frame>
  </Step>

  <Step title="Register the people and places you want to keep consistent">
    Type `@` inside a line to register or recall a **Character** or **Subject**. Press `/` and pick `Background` to define a place.

    Skipping this step is fine for a single shot. Across multiple shots, the same face will drift unless you register the character first.

    <Frame caption="The `@` autocomplete creates or recalls an asset">
      <img src="https://mintcdn.com/lettherebe/E_AEVPp8svVTgFNI/images/quickstart/subject-girls-basket.png?fit=max&auto=format&n=E_AEVPp8svVTgFNI&q=85&s=b82172c84d4d4635dfa9908ceb55b9a8" alt="Subject registration via @ mention" width="1999" height="1282" data-path="images/quickstart/subject-girls-basket.png" />
    </Frame>

    Full reference: [Assets](/assets/characters).
  </Step>

  <Step title="Generate shots for each beat">
    Select a beat. The generation panel opens at the bottom. Click `Create` to produce up to 9 candidate shots in one batch.

    <Frame caption="`Create` generates up to 9 candidate shots per beat">
      <img src="https://mintcdn.com/lettherebe/E_AEVPp8svVTgFNI/images/quickstart/create-scene-modal.png?fit=max&auto=format&n=E_AEVPp8svVTgFNI&q=85&s=5d19f602cbc75c73dbf14db478741a4a" alt="Create scene panel" width="1450" height="562" data-path="images/quickstart/create-scene-modal.png" />
    </Frame>

    Candidates land in the **beat gallery**. Press `↑` on a shot to promote it to the **shot gallery**. Press `↓` to archive it.

    <Frame caption="`↑` promotes a candidate, `↓` archives it">
      <img src="https://mintcdn.com/lettherebe/E_AEVPp8svVTgFNI/images/quickstart/variation-grid.png?fit=max&auto=format&n=E_AEVPp8svVTgFNI&q=85&s=595d04da9aa767977d8dd62ad19d576f" alt="Beat gallery grid" width="1444" height="1622" data-path="images/quickstart/variation-grid.png" />
    </Frame>

    Promoted shots feed the video stage as first frames. Refine a promoted shot with [Edit, Upscale, or Cinematic Shots](/image-mode/create#refine-before-animating) before moving on.

    <Tip>
      Refine the first frame before animating. A weak frame yields a weak video, and video generation costs more tokens than a re-edit.
    </Tip>
  </Step>

  <Step title="Animate the shot">
    Open the video panel from a promoted shot. `Kling 3.0 Pro` runs by default. Generation typically takes 1–3 minutes.

    The model takes the promoted shot as its first frame and fills in motion. Composition, lighting, and character identity carry over directly from the still.

    <Frame caption="An 8-second clip generated from the promoted shot" />

    Model comparisons live at [Video models](/models/video).
  </Step>

  <Step title="Share">
    Click `Share` on the finished clip. LTB returns a public URL and an embed snippet. Recipients view without signing in.

    <Frame caption="Public link plus embed snippet">
      <img src="https://mintcdn.com/lettherebe/E_AEVPp8svVTgFNI/images/quickstart/share-modal.png?fit=max&auto=format&n=E_AEVPp8svVTgFNI&q=85&s=83fd02fa0f128ada1b397f8a96293efb" alt="Share modal" width="1440" height="900" data-path="images/quickstart/share-modal.png" />
    </Frame>

    <Note>
      Share links stay live until you unpublish. There is no automatic expiry. To revoke, open the share modal again and toggle off.
    </Note>
  </Step>
</Steps>

## Where to go next

You finished the shortest path. Extend the work along any of these branches.

<CardGroup cols={2}>
  <Card title="Plan with Summary" icon="lightbulb" href="/workflows/summary">
    Define period, logline, and three acts before writing scenes.
  </Card>

  <Card title="Master Scenario" icon="pen-line" href="/workflows/scenario">
    Learn the four block types, beats, and scene division.
  </Card>

  <Card title="Refine in Image mode" icon="image" href="/image-mode/create">
    Use Create, Cinematic Shots, Edit, and Upscale.
  </Card>

  <Card title="Compare video models" icon="film" href="/models/video">
    Twelve models, side by side, with pricing.
  </Card>
</CardGroup>

## Common snags

Three issues come up most often on the first run.

**The `Create` button is gray.** The line is empty or unsaved. Type one character and the autosave activates the button.

**The same character looks different across shots.** Register the person as a Character asset, then reference them with `@name` in every line. Identity holds from the next generation onward.

**Video generation hangs past 3 minutes.** Open the bell icon in the header. A `failed` entry means the upstream model dropped — retry from the same shot. Failed runs refund tokens automatically.

## When you are stuck

Email [contact@lettherebe.app](mailto:contact@lettherebe.app) with your project URL. We reply within 24 hours.
