Live View

Live View is the human window into an API session — a real-time 60fps WebRTC feed in the Console. It’s how owners supervise agents and how you debug loops.

Open it

Go to Console → Sessions, find your session by id, and click the Eye icon. You’ll see the live feed plus telemetry (ping, delay, signal).

session = gw.create_session(rig_id=rig.id, mode="desktop")
print("Watch:", session.session_id)
# Console → Sessions → Eye on that id

Programmatic stream

To render the feed in your own surface, get WebRTC signaling credentials:

creds = gw.stream(sid)   # WebRTC signaling credentials for a live feed

The on-host indicator

While the session is active, the host displays an “API session active” indicator on the physical machine. Live View and this indicator together mean an agent’s actions are always observable — see Safety and consent.

Color / HDR

Live View is an SDR H.264 stream. If Windows HDR / Advanced Color is on, the DXGI capture path can look washed or dull even when screenshots look fine.

What happens	Detail
Auto-disable	API session start turns off primary-display HDR
Restore	Session end, disconnect, and crash recovery restore it
Console	Amber HDR on badge under Rigs if HDR is still active
Opt-out	`CAPTURE_ALLOW_HDR=1` on the host (dev only)

If colors still look wrong after a session starts, turn off Settings → System → Display → HDR on the rig manually. See Troubleshooting.

Keep Live View open while developing an agent loop. Watching the real machine react in real time is the fastest way to catch mis-grounded clicks. For a full human-in-the-loop / allowlist / budget checklist, see Safe agent sessions.

Get started

Setup

Concepts

Guides

Examples

Help

Open it

Programmatic stream

The on-host indicator

Color / HDR

​Open it

​Programmatic stream

​The on-host indicator

​Color / HDR

Open it

Programmatic stream

The on-host indicator

Color / HDR