Guide
Live viewer
A remote browser you can watch and drive, embedded on every profile's detail page in the dashboard.
What it is
Start a profile and open it in the dashboard — the profile page embeds a live view of the real browser, streamed as ~10fps JPEG frames over a websocket at /viewer/<profile>. This is the actual Camoufox browser rendering the actual page, not a screenshot or a proxy render.
Take Control
Press Take Control and mouse, scroll, and keyboard go straight to the remote browser — log into a site by hand the way you would on your own machine, then press Release to hand it back to automation. Whatever you do while in control is written to the profile like any other session, so a manual login persists for later API, Playwright, and MCP use.
The URL bar
An editable URL bar sits above the viewport. Type a URL and submit to navigate the remote page directly — useful for jumping straight to a login page or a specific route without reaching for the API.
Fullscreen
The viewer can expand to fill the screen for a closer look at a dense page or a fiddly login flow.
The single-controller lock
Only one controller drives a profile at a time. The viewer always shows which:
- ● Automated — no human has taken control; the profile is free for the REST API, Playwright, or an MCP agent to drive.
- ● Human control — a human has pressed Take Control; input goes to them.
This lock is what keeps a human takeover and an in-flight automated session from fighting over the same mouse. Release control (or close the viewer) to hand the profile back.
Same profile, same identity