dsh-cdp-live-view

Your Chromium runs on a remote server or inside a container, yet you want to see the page, click around, and type directly from the DSH Web GUI instead of spinning up a VNC client or hand-crafting CDP calls in a terminal. dsh-cdp-live-view projects the external browser as a live JPEG pixel stream onto a sidebar canvas while the host process keeps the single CDP connection. The browser side never learns the CDP address, so no arbitrary CDP passthrough is possible, giving you a clean security boundary with a simple deployment.

Interaction flows through a strict zod allow-list: mouse clicks, drags, wheel events, keyboard input, IME composition commits, paste, page navigation, and tab management are all predefined commands with no arbitrary CDP escape hatch. A two-level gate enforces the boundary: a settings-level master switch decides whether the view may accept control at all, and a per-view checkbox in the header toggles the current session. Both must be on for interactive mode, and the host validates the ticket on every command, so an unauthorized or forged client cannot emit a single control instruction.

The CDP endpoint, frame quality, capture interval, and maximum dimensions are configured and persisted from the Web settings page. Saving a new address tears down the old connection and live views reconnect automatically. Frame width and height are projection caps only and never override the remote Chromium true viewport layout.

Ideal for visualising remote or headless browsers in real time, supervising an agent-driven browser inside a DSH session, projecting a test browser to colleagues with permission-scoped navigation and clicks, or any scenario where a browser-only remote view with zero client installs is all you need.