First Connection

Quick start with the CLI

The fastest way to test a connection:

# Probe a relay — auto-detects transport and draft version
moqtap peek moqt://relay.example.com

# Skip TLS verification for dev relays
moqtap peek moqt://localhost:4443 -k

You’ll see the negotiated draft version, relay role, and handshake result.

Connect with the desktop app

1. Launch moqtap Desktop
2. Enter a relay URL in the connection bar, e.g.:
   • https://relay.example.com/moq (WebTransport)
   • moqt://relay.example.com (native QUIC)
3. Select the draft version (supports drafts 07–17; default: latest)
4. Configure TLS if needed:
   • System trust store — for relays with valid certificates
   • Accept any certificate — for development relays with self-signed certs
   • Custom CA — provide a PEM file for private CAs
5. Click Connect

What you’ll see

Once connected, moqtap shows the full setup exchange:

TX  SETUP  versions=[0xff000011] path=/moq
RX  SETUP  version=0xff000011

Note

In draft-14 and earlier, the setup uses separate CLIENT_SETUP and SERVER_SETUP messages. In draft-17, these are unified into a single SETUP message.

The Session view displays:

• Control message log — every message in both directions with timestamps
• Session state — connected, setup complete, active, or closed
• QUIC stats — RTT, packet loss, congestion window

Inspect with the browser extension

If you’re debugging a web application:

1. Install the WebTransport Inspector extension
2. Open DevTools (F12) and navigate to the WebTransport Inspector panel
3. Load your page — MoQT connections are detected and decoded automatically

Next steps

• Subscribe to a track
• Discover namespaces
• Fetch historical data
• Intercept traffic between your app and a relay