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, Microsoft Edge, Brave, Opera, Naver Whale, Yandex Browser, Chromium, Patchright, Rebrowser.
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 unless you add "record": false. See Live view.
Used in
- Case 82: Kept downloads in practice: a person in Launch interactive and an AI agent over MCP
- Case 58: Do it by hand in live view, then let your code finish in the same browser
- Headless Chrome a person can watch and take over
- Open a page on the server, take over in live view, then join from code
- Record a headless session and get the video
All options: launch options.