[Launch options](https://cdpfleet.com/docs/options)

# `live_view`

Make a headless session watchable and controllable from outside.

**Use it for:** A person watching or taking over the session in the browser (a login, a 2FA step, a check that needs a human), or recording a headless session.

**Browsers:** [Google Chrome](https://cdpfleet.com/docs/browsers/chrome#opt-live_view), [Microsoft Edge](https://cdpfleet.com/docs/browsers/edge#opt-live_view), [Brave](https://cdpfleet.com/docs/browsers/brave#opt-live_view), [Opera](https://cdpfleet.com/docs/browsers/opera#opt-live_view), [Naver Whale](https://cdpfleet.com/docs/browsers/whale#opt-live_view), [Yandex Browser](https://cdpfleet.com/docs/browsers/yandex#opt-live_view), [Chromium](https://cdpfleet.com/docs/browsers/chromium#opt-live_view), [Patchright](https://cdpfleet.com/docs/browsers/patchright#opt-live_view), [Rebrowser](https://cdpfleet.com/docs/browsers/rebrowser#opt-live_view).

## Details

-   **Type:** `boolean`
-   **Default:** false (headful sessions are always watchable)
-   **Example:** `{"live_view":true}`

Headful sessions can always be watched or taken over (`POST /admin/session/live` → a VNC-over-WebSocket `live_url`, or the dashboard's Watch / Take control). Headless Chromium-based sessions need `"live_view": true` at launch; they are then streamed as JPEG frames (`"protocol": "screencast"`).

Headless Chromium-based browsers only (Camoufox, Firefox and WebKit are watchable when headful, their default). Doesn't give your code CDP access — add `"cdp": true` for that. The session is also [recorded](https://cdpfleet.com/docs/recordings) unless you add `"record": false`. See [Live view](https://cdpfleet.com/docs/live-view).

## Used in

-   [Case 82: Kept downloads in practice: a person in Launch interactive and an AI agent over MCP](https://cdpfleet.com/docs/cases/downloads-in-practice)
-   [Case 58: Do it by hand in live view, then let your code finish in the same browser](https://cdpfleet.com/docs/cases/launch-interactive-to-code)
-   [Headless Chrome a person can watch and take over](https://cdpfleet.com/docs/examples#chrome-headless-live-view)
-   [Open a page on the server, take over in live view, then join from code](https://cdpfleet.com/docs/examples#start-url-live)
-   [Record a headless session and get the video](https://cdpfleet.com/docs/examples#headless-recording)

All options: [launch options](https://cdpfleet.com/docs/options).

---
Source: https://cdpfleet.com/docs/options/live_view · Markdown: https://cdpfleet.com/docs/options/live_view.md · All docs for AI tools: https://cdpfleet.com/llms.txt