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

# PDF to Narrated Video — Convert Slides with Origami AI

> Convert any PDF into a narrated MP4 video with AI scripts, Kokoro TTS audio, and cinematic transitions — rendered entirely in your browser.

Upload a PDF deck and Origami AI turns each slide into a fully narrated video — no cloud rendering, no subscriptions. The AI drafts natural speech for every slide, Kokoro.js synthesizes the audio directly in your browser, and FFmpeg.wasm composes everything into a polished 720p or 1080p MP4 you can download and share.

## How It Works

<Steps>
  <Step title="Upload your PDF">
    Drag your presentation file onto the upload area or click to browse. Origami AI extracts slide images and reads the text from every page automatically — no manual copy-pasting needed.
  </Step>

  <Step title="Generate narration scripts">
    Click **Generate Narration** and the AI drafts a natural, conversational script for each slide. You can use a local model (WebLLM, runs entirely on your device) or a cloud API you've connected in **⚙️ Settings → API** — whichever you prefer.
  </Step>

  <Step title="Synthesize voice audio">
    Origami AI uses Kokoro.js to convert every script into high-quality speech audio — no server round-trip, no file uploads. Choose from multiple voices in **Settings → General** or directly in the Slide Editor.
  </Step>

  <Step title="Edit in the visual editor">
    Fine-tune anything before you export: rewrite individual scripts, adjust audio timing and post-slide delays, pick transition effects between slides, set your preferred aspect ratio, and add background music with automatic ducking under the narration.
  </Step>

  <Step title="Export the video">
    Click **Render Video** to compose all your slides, audio tracks, music, and transitions into a finished MP4 — entirely in your browser. Choose 720p for faster rendering or 1080p for the highest quality.
  </Step>
</Steps>

## Key Controls

The **Slide Editor** gives you per-slide control over every aspect of your video:

| Control              | What it does                                                                                                                                   |
| -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| **Script editor**    | Edit the AI-generated narration for any individual slide. Changes are reflected immediately when you re-generate audio for that slide.         |
| **Voice selection**  | Pick from multiple Kokoro voices (e.g. `af_heart`, `af_bella`, `am_adam`, `am_michael`) to match the tone of your presentation.                |
| **Audio timing**     | Set a post-audio delay per slide so each screen breathes before advancing. Adjust globally in **⚙️ Settings → General** or override per slide. |
| **Transition type**  | Choose how one slide transitions to the next: **None**, **Fade**, **Slide**, or **Zoom**. Set a project-wide default or vary it per slide.     |
| **Background music** | Upload a music file or choose from the built-in library. Auto-ducking lowers the music under narration so your voice always stays clear.       |

## Aspect Ratios

Origami AI supports four aspect ratios so you can match your output to any platform or screen:

<CardGroup cols={2}>
  <Card title="16:9 — Widescreen" icon="monitor">
    The standard for presentations, YouTube, and desktop viewing. Best choice for most PDF decks originally designed in landscape.
  </Card>

  <Card title="9:16 — Vertical" icon="mobile">
    Portrait format optimised for YouTube Shorts, Instagram Reels, and TikTok. Great for repurposing slide content as social video.
  </Card>

  <Card title="4:3 — Classic" icon="square">
    Traditional presentation format. Useful when your slides were designed for an older 4:3 projector ratio.
  </Card>

  <Card title="1:1 — Square" icon="circle">
    Equal width and height for Instagram feed posts and multi-platform sharing.
  </Card>
</CardGroup>

Set your preferred aspect ratio in **⚙️ Settings → General** before rendering.

## Export Options

When you're ready to export, Origami AI gives you two resolution choices:

<CardGroup cols={2}>
  <Card title="720p MP4" icon="film">
    Faster to render and smaller in file size. A great choice for drafts, social sharing, or machines with limited resources.
  </Card>

  <Card title="1080p MP4" icon="clapperboard">
    Full HD output for polished presentations, uploads to YouTube or LinkedIn, and anywhere quality matters most.
  </Card>
</CardGroup>

You can also export your entire project as a `.origami` archive (**File → Export Project**). This portable ZIP contains all slides, audio blobs, scripts, and settings — import it on any device running Origami AI to pick up exactly where you left off.

<Tip>
  On a slower machine, switch the TTS quantization to **q4** in **⚙️ Settings → TTS Model**. The `q4` model processes audio significantly faster with only a small reduction in voice quality — ideal for drafting or long decks. Switch to **q8** when you need the highest audio fidelity for your final render.
</Tip>

<Note>
  The first time you use a feature that requires an AI model (narration generation or TTS), Origami AI downloads the required model to your browser's local cache. This one-time download can range from a few hundred MB to a couple of GB depending on the model. After that, everything runs offline with no further downloads needed.
</Note>