# --navigator-video-shows-captions

Source: https://zshot-cli.com/reference/flags/navigator/navigator-video-shows-captions/
Markdown: https://zshot-cli.com/reference/flags/navigator/navigator-video-shows-captions/index.md
Section: [Reference](https://zshot-cli.com/reference/) › [Flags](https://zshot-cli.com/reference/flags/) › [Navigator](https://zshot-cli.com/reference/flags/navigator/)
CLI: `--navigator-video-shows-captions` · REST: [`navigator_video_shows_captions`](https://zshot-cli.com/reference/server/api/schema/#navigator_video_shows_captions)
License: [Pro](https://zshot-cli.com/support/licenses/pro)

Tells the navigator that you asked for captions in the [`--navigator-captures-video`](/reference/flags/navigator/navigator-captures-video) recording. When the navigator judges that the reason for an action helps explain how it is reaching your goal, it writes a caption, which is drawn onto the video under the action as the page names it, such as `Click “Sign in”`, and held before the action runs. The caption is in the language of your goal, as is the action line in English, German, Spanish, French, Italian, Portuguese, Japanese, Korean, Chinese and Arabic; other languages get an English action line. Filled values stay out of both. Routine steps carry no caption and no hold.

Each caption is held for one second to notice it plus the time an adult takes to read it silently, from 2 to 15 seconds: English at 238 words a minute, with longer words and numbers taking longer, and Japanese, Chinese, Korean and Arabic at their own measured rates. A caption too long for its place scrolls through its hold.

Captions are drawn with the Noto fonts that ship with zshot, so they read the same on every host, in Latin, Cyrillic, Greek, Arabic, Japanese, Korean and Chinese scripts. [`--navigator-video-captions-position`](/reference/flags/navigator/navigator-video-captions-position) places them. A [`typesafe`](/reference/llm_connections/typesafe) navigator writes no captions.

## Example

**CLI**

```sh
zshot -f pipeline.png \
  --navigator-type "anthropic://YOUR_API_KEY@" \
  --navigate "Open the pipeline" \
  --navigator-captures-video session.webm \
  --navigator-video-shows-captions \
  https://zshot-cli.com/example_assets/zrm/
```

**JSON** — `POST /` body for the [API](/reference/server/api), Pro license

```json
{
  "url": "https://zshot-cli.com/example_assets/zrm/",
  "output_type": "png",
  "navigate": "Open the pipeline",
  "with_navigator_video": true,
  "navigator_video_shows_captions": true,
  "navigator_type": ["anthropic://YOUR_API_KEY@"]
}
```

**curl**

```sh
curl -X POST http://127.0.0.1:3000/ \
  -H "Content-Type: application/json" \
  -d '{"url":"https://zshot-cli.com/example_assets/zrm/","output_type":"png","navigate":"Open the pipeline","with_navigator_video":true,"navigator_video_shows_captions":true,"navigator_type":["anthropic://YOUR_API_KEY@"]}' \
  -D - -o pipeline.png
```

## Related

Flags:

- [`--navigator-captures-video`](https://zshot-cli.com/reference/flags/navigator/navigator-captures-video/)
- [`--navigator-video-captions-position`](https://zshot-cli.com/reference/flags/navigator/navigator-video-captions-position/)
- [`--navigator-video-shows-pointer`](https://zshot-cli.com/reference/flags/navigator/navigator-video-shows-pointer/)

## Navigation

- [Examples](https://zshot-cli.com/examples/)
- [Download](https://zshot-cli.com/download/)
- [Purchase](https://zshot-cli.com/purchase/)
- [Reference](https://zshot-cli.com/reference/)
  - [Formats](https://zshot-cli.com/reference/formats/)
  - [Flags](https://zshot-cli.com/reference/flags/)
    - [Common](https://zshot-cli.com/reference/flags/common/)
    - [Agents](https://zshot-cli.com/reference/flags/agents/)
    - [Archive](https://zshot-cli.com/reference/flags/archive/)
    - [Browser](https://zshot-cli.com/reference/flags/browser/)
    - [Diagnostics](https://zshot-cli.com/reference/flags/diagnostics/)
    - [Document](https://zshot-cli.com/reference/flags/document/)
    - [Image](https://zshot-cli.com/reference/flags/image/)
    - [Navigator](https://zshot-cli.com/reference/flags/navigator/)
      - [--navigate](https://zshot-cli.com/reference/flags/navigator/navigate/)
      - [--navigator-allow-url](https://zshot-cli.com/reference/flags/navigator/navigator-allow-url/)
      - [--navigator-captures-playwright](https://zshot-cli.com/reference/flags/navigator/navigator-captures-playwright/)
      - [--navigator-captures-puppeteer](https://zshot-cli.com/reference/flags/navigator/navigator-captures-puppeteer/)
      - [--navigator-captures-video](https://zshot-cli.com/reference/flags/navigator/navigator-captures-video/)
      - [--navigator-credential](https://zshot-cli.com/reference/flags/navigator/navigator-credential/)
      - [--navigator-credential-env](https://zshot-cli.com/reference/flags/navigator/navigator-credential-env/)
      - [--navigator-credential-helper](https://zshot-cli.com/reference/flags/navigator/navigator-credential-helper/)
      - [--navigator-credential-helper-env](https://zshot-cli.com/reference/flags/navigator/navigator-credential-helper-env/)
      - [--navigator-credential-helper-timeout](https://zshot-cli.com/reference/flags/navigator/navigator-credential-helper-timeout/)
      - [--navigator-credential-origin](https://zshot-cli.com/reference/flags/navigator/navigator-credential-origin/)
      - [--navigator-credential-secret](https://zshot-cli.com/reference/flags/navigator/navigator-credential-secret/)
      - [--navigator-data](https://zshot-cli.com/reference/flags/navigator/navigator-data/)
      - [--navigator-data-json](https://zshot-cli.com/reference/flags/navigator/navigator-data-json/)
      - [--navigator-escalation-max](https://zshot-cli.com/reference/flags/navigator/navigator-escalation-max/)
      - [--navigator-file](https://zshot-cli.com/reference/flags/navigator/navigator-file/)
      - [--navigator-file-size-limit](https://zshot-cli.com/reference/flags/navigator/navigator-file-size-limit/)
      - [--navigator-file-timeout](https://zshot-cli.com/reference/flags/navigator/navigator-file-timeout/)
      - [--navigator-goal](https://zshot-cli.com/reference/flags/navigator/navigator-goal/)
      - [--navigator-initial-scope](https://zshot-cli.com/reference/flags/navigator/navigator-initial-scope/)
      - [--navigator-max-steps](https://zshot-cli.com/reference/flags/navigator/navigator-max-steps/)
      - [--navigator-stall-escalation](https://zshot-cli.com/reference/flags/navigator/navigator-stall-escalation/)
      - [--navigator-step-timeout](https://zshot-cli.com/reference/flags/navigator/navigator-step-timeout/)
      - [--navigator-type](https://zshot-cli.com/reference/flags/navigator/navigator-type/)
      - [--navigator-video-captions-position](https://zshot-cli.com/reference/flags/navigator/navigator-video-captions-position/)
      - [--navigator-video-height](https://zshot-cli.com/reference/flags/navigator/navigator-video-height/)
      - **--navigator-video-shows-captions**
      - [--navigator-video-shows-pointer](https://zshot-cli.com/reference/flags/navigator/navigator-video-shows-pointer/)
      - [--navigator-video-width](https://zshot-cli.com/reference/flags/navigator/navigator-video-width/)
    - [Security](https://zshot-cli.com/reference/flags/security/)
    - [Server](https://zshot-cli.com/reference/flags/server/)
    - [Video](https://zshot-cli.com/reference/flags/video/)
  - [Agents](https://zshot-cli.com/reference/agents/)
  - [Configuration](https://zshot-cli.com/reference/configuration/)
  - [Crawling](https://zshot-cli.com/reference/crawling/)
  - [Docker](https://zshot-cli.com/reference/docker/)
  - [Exit Codes](https://zshot-cli.com/reference/exit_codes/)
  - [Linux](https://zshot-cli.com/reference/linux/)
  - [LLM Connections](https://zshot-cli.com/reference/llm_connections/)
  - [LLM Formatting](https://zshot-cli.com/reference/llm_formatting/)
  - [Local Inputs](https://zshot-cli.com/reference/inputs/)
  - [Navigator](https://zshot-cli.com/reference/navigator/)
  - [Security](https://zshot-cli.com/reference/security/)
  - [Server](https://zshot-cli.com/reference/server/)
  - [Shell completions](https://zshot-cli.com/reference/shell_completions/)
  - [Storage](https://zshot-cli.com/reference/storage/)
  - [Timeouts](https://zshot-cli.com/reference/timeouts/)
  - [Web Bot Auth](https://zshot-cli.com/reference/web_bot_auth/)
- [Support](https://zshot-cli.com/support/)
- [Changelog](https://zshot-cli.com/changelog/)

Site index: https://zshot-cli.com/llms.txt