www.orgo.ai. Any websockify-compatible VNC client connects to it, so you need no Orgo package to embed one. The orgo-vnc React component is a convenience wrapper over the same URL.
The connection URL
Both endpoints need your API key, so call them from your server.
Two credentials, and which one goes in the browser
Your server holds the API key, reads the password with it, and returns only the password to your page.
Embed from any domain
There is no origin allowlist on this path and nothing to register with us. The per-computer password is the credential, and it is the only thing that decides whether a connection is allowed.Embed with noVNC
Two files. First a server route that trades your API key for the two values the browser needs.app/api/computer/route.ts
Browser
disconnect event does not carry the close code. It is what orgo-vnc does too.
A failed embed is a black screen
The proxy rejects a connection by accepting the WebSocket upgrade and then closing it. noVNC therefore sees an ordinary disconnect, raises nothing, and the canvas stays black. The close code is the only way to tell a bad password from a stopped computer.
Anything outside 4000-4599 is a standard WebSocket code, not ours.
4003, 4007, 4008, 4500 and 4502 are worth retrying. The rest need an input changed first.
Every long-lived embed eventually hits
4008. After 30 minutes with no human input the proxy closes the connection. The timer measures keyboard, pointer and clipboard input from your page, not pixels, so a computer an agent is driving with nobody watching still counts as idle. Treat 4008 as a clean close and reconnect on the next user action.The React component
app/screen.tsx
onError is the reason to use the package: it decodes every close code above into a message. Handle it, or a rejected connection is invisible again.
Props
Imperative handle
buildWsUrl(host, instanceId, password) to build the URL for you, and describeCloseCode(code) and closeCodeMessage(code) to render the table above yourself.
Next steps
Quickstart
Full SDK setup
API reference
Control computers programmatically