---
url: "https://docs.on-book.app/rehearsal/getting-started/first-script.md"
description: "From download to rehearsal in under five minutes."
status: "proposed"
---

# Adding Your First Script

> **Status: Proposed / pre-launch. On Book Rehearsal docs describe intended behavior and may not match a shipped app yet.**

> **From download to rehearsal in under five minutes.**

***

## Overview

On Book Rehearsal is pre-launch. This page describes the intended first-script flow once the app is available. Until release, treat app-store download steps and personal script processing as planned behavior.

***

## Step 1: Download & Install

1. Install the pre-release build or released app provided by the owner/operator.
2. Open the app.

***

## Step 2: Sign In

1. Tap **"Sign In"** on the welcome screen
2. Sign in with your **Google account** or **email and password**

::: tip Already use On Book Pro?
On Book Rehearsal shares the same account system as On Book Pro. If your stage manager has already added you to a production, you'll see your scripts automatically after signing in — no invite code needed.
:::

***

## Step 3: Add a Script

There are two ways to get a script into the app:

### Option A: Upload a PDF

1. Tap the **"+" button** on the script library screen
2. Select a PDF file from your device
3. The app sends your script to the cloud for AI processing

### Option B: Receive from Your Stage Manager

If your stage manager uses **On Book Pro**, they can push the production script directly to your app. Once you've been added to the production and the script has been imported:

* The script appears automatically in your library
* No action needed on your end

***

## Step 4: Wait for Processing

After uploading, the AI analyzes your script to extract:

* **Scene structure** (acts, scenes, and page ranges)
* **Character names** and their dialogue
* **Line assignments** for each character per scene

A progress indicator shows the current status. Processing typically takes **30–90 seconds** depending on the length of your script.

::: tip Supported Formats
Any PDF works — text-based or scanned. The AI uses OCR to read every page before extracting your script.
:::

***

## Step 5: Select Your Character and Scene

Once processing is complete:

1. Tap on your script in the library
2. **Choose your character** from the list of extracted roles
3. **Select the scene(s)** you want to rehearse
4. **Pick a rehearsal mode** — Voice Rehearsal, Italian Run, or Flashcard
5. Optionally, narrow the line range with the **A/B Loop slider**
6. Tap **Go** to start rehearsing

***

## What's Next?

Now that your script is loaded, explore the three rehearsal modes:

* [Voice Rehearsal](../modes/voice-rehearsal.md) — Full-duplex voice practice with an AI scene partner
* [Italian Run](../modes/italian-run.md) — Speed drills at 1.5–2× pace
* [Flashcard Mode](../modes/flashcard.md) — Text-based memorization with blur/reveal

***

## Related Guides

* [Scene & Character Selection](../guide/scene-selection.md)
* [Strictness Levels](../guide/strictness.md)
* [Troubleshooting](../reference/troubleshooting.md)

***

*Last updated: February 19, 2026*