# ShotTimeline

> Talos 0.6 · Since 0.6

Cinematic camera shots as data, played on sim time so recordings are reproducible.

## Fields

| Field | Type | Required | Default | Allowed values | Description |
|---|---|---|---|---|---|
| `shots` | `Shot[]` | yes |  |  | In order, back to back. At least one. |
| `loop` | `boolean` | no | `false` |  | Start again from the first shot when the last ends (a cut). Default false. |
| `end` | `ShotEnd` | no |  | `hold`, `release` | hold (the default): stay on the last pose. release: give the view back to the scene camera. Ignored when looping. |
| `doneEvent` | `string` | no | `shots-done` |  | Emitted once when the list ends, never while looping. Default `shots-done`; a recording made with `--record-until-event shots-done` ends there. |

## See also

- `Shot`
- `ShotEnd`