# Template: vertical cut with captions

> The starter for a short vertical video: one clip of footage and word-highlighted captions.

Source: https://alexgalhardo.github.io/vukem-video/docs/guide/template-vertical-cut/

## You will learn

- what the starter holds;
- how to fill its two slots;
- how to adapt the caption look.

## The idea

**Vertical cut with captions** is a 1080 x 1920 project (9:16) with a black background, a `Video` track with one clip slot of 15 seconds, and a `Captions` track whose style is bold, upper case, centred at the bottom, with the spoken word highlighted. Its template colours are `ink` (`#FFFFFF`) and `highlight` (`#FFE600`).

| Slot | Kind | What goes in it |
| --- | --- | --- |
| `clip` | media, duration policy `fit` | the vertical footage to cut |
| `subtitles` | caption | the words shown over the clip |

## Quick start

1. List the templates and note the id of `Vertical cut with captions`.
2. Create the project, filling `clip` with your asset.
3. Transcribe the asset and make the captions from it.

**CLI**

```bash
vukem-video template:list
echo '{"clip": {"asset_id": "ast_4h6j8k2m3n"}}' > fill.json
vukem-video template:new tpl_5n8b2v6c1x --name "Short 01" --fill fill.json
vukem-video transcribe --project prj_7k2m9x4q1b --asset ast_4h6j8k2m3n
vukem-video edit --project prj_7k2m9x4q1b caption.from_transcript \
  clip_item_id=itm_m1n2p3q4r5 track_id=trk_f6g7h8j9k0
```

**MCP**

`template` with `{"action": "new", "template_id": "tpl_5n8b2v6c1x", "name": "Short 01", "fill": {"clip": {"asset_id": "ast_4h6j8k2m3n"}}}`, then `job_start` with `"kind": "transcribe"` and `edit` with `caption.from_transcript`.

The template holds one placeholder caption with the text `Your words appear here as the clip speaks`; `caption.from_transcript` with `replace` set to true (the default) removes the captions linked to the clip first. Change the look of every caption with `track.set_caption_style`, and use the template colours as `$highlight` and `$ink`.

## Common mistakes

- Filling `clip` with an asset shorter than 15 seconds: `E_SLOT`. Use the policy `stretch_timeline` on a copy of the template, or a longer asset.
- Letting captions go below the safe area. The style keeps them at the bottom inside it; check with the [safe area](/docs/guide/safe-area) guide.

## Next steps

- [Transcription](/docs/guide/transcription)
- [Exporting](/docs/guide/exporting)
