Quickstart

This quickstart walks you through connecting to a relay, discovering tracks, and viewing live data — all in about 5 minutes.

Prerequisites

• moqtap CLI installed (or the desktop app)
• A running MoQT relay (or use a public test relay)

Option A: CLI quickstart

Step 1: Probe the relay

moqtap peek moqt://relay.example.com

This auto-detects the transport (QUIC or WebTransport), negotiates the draft version, and shows you the relay’s capabilities.

Step 2: Discover namespaces

moqtap peek moqt://relay.example.com namespaces

Step 3: List tracks

moqtap peek moqt://relay.example.com tracks live

Step 4: Fetch data

# Fetch the latest data from a track
moqtap peek moqt://relay.example.com data live video latest

# Stream data with JSON output
moqtap peek moqt://relay.example.com data live video -j

Step 5: Intercept traffic

# Start a transparent proxy, record to a trace file
moqtap intercept -u moqt://relay.example.com -o session.moqtrace

# Point your app at localhost:4443 instead of the real relay

Option B: Desktop app quickstart

Step 1: Connect

Enter your relay URL and click Connect. For development relays with self-signed certificates, enable Accept any certificate.

Step 2: Discover namespaces

Click Discover and enter a namespace prefix (or leave empty to discover all). moqtap sends a SUBSCRIBE_NAMESPACE message and displays discovered namespaces as they arrive.

Step 3: Subscribe to a track

Select a track from the namespace browser, or enter a namespace and track name manually. Choose a filter type:

Filter	Description
LatestObject	Start from the most recent object
NextGroupStart	Start from the next group boundary
AbsoluteStart	Start from the beginning
AbsoluteRange	Specific group/object range

Click Subscribe and watch objects arrive in real-time.

Step 4: Inspect

• Click any control message in the log to see parsed fields and raw hex
• Switch to the Object Viewer to see payload content (auto-detected as text, JSON, or binary)
• Check QUIC Stats for transport-level metrics

Step 5: Export

Click Export Trace to save the session as a .moqtrace file. Share it with your team or replay it later with moqtap trace session.moqtrace.