Connecting from mobile

Porthole prints a QR code with every session, so opening a shared terminal on a phone takes a couple of seconds.

Scan to connect

1. Run porthole host on your machine.
2. Point your phone's camera at the QR code in the terminal output.
3. Tap the link — the viewer opens in your mobile browser.

That's it. The viewer is built for touch, so you can read output comfortably and, when the session isn't read-only, bring up the keyboard to type.

Hide the QR code

If you're sharing a recording or don't need the QR, suppress it:

porthole host --no-qr

The link and code are still printed — only the QR is omitted.

Tips

• The phone needs network access to the signaling server to complete the handshake; after that the connection is peer-to-peer.
• For a phone that should only watch, combine with read-only.