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

# ralphy compose

> Timeline-aware composer. Reads artifacts/ + scenario.json + scribe captions, builds a Timeline, optionally re-flows after structural edits, and renders a single

## Summary

```bash theme={"dark"}
ralphy compose [options] <projectId>
```

**Common flags**

| Flag                      | Description                                                                                 |
| ------------------------- | ------------------------------------------------------------------------------------------- |
| `--remove-segment <slot>` | Drop the segment with this slot id and re-flow VO + captions + music. Repeatable.           |
| `--out <path>`            | Output path (default: \<project>/render/compose.mp4). Collisions auto-bump to -v2, -v3, ... |
| `--dry-run`               | Print the resolved timeline + filter graph; do not spawn ffmpeg.                            |

<Expandable title="Full reference">
  **Flags**

  | Flag                      | Description                                                                                 |
  | ------------------------- | ------------------------------------------------------------------------------------------- |
  | `--remove-segment <slot>` | Drop the segment with this slot id and re-flow VO + captions + music. Repeatable.           |
  | `--out <path>`            | Output path (default: \<project>/render/compose.mp4). Collisions auto-bump to -v2, -v3, ... |
  | `--dry-run`               | Print the resolved timeline + filter graph; do not spawn ffmpeg.                            |
  | `-h, --help`              | display help for command                                                                    |
</Expandable>