Namespace Discovery

Overview

Namespace discovery lets you find out what tracks a relay has available. The mechanism varies by draft version:

• Draft-14+: SUBSCRIBE_NAMESPACE / PUBLISH_NAMESPACE
• Draft-07: SUBSCRIBE_ANNOUNCES (different message, same concept)
• Draft-17: Adds NAMESPACE and NAMESPACE_DONE messages for richer discovery

Using the CLI

The fastest way to discover namespaces is moqtap peek:

# Discover all published namespaces
moqtap peek moqt://relay.example.com namespaces

# List tracks in a specific namespace
moqtap peek moqt://relay.example.com tracks live

# JSON output
moqtap peek moqt://relay.example.com namespaces -j

The peek command auto-detects the relay’s draft version and uses the appropriate discovery mechanism.

Using the browser extension

The browser extension passively decodes namespace discovery messages from your application’s WebTransport connections. Open the DevTools panel to see SUBSCRIBE_NAMESPACE and PUBLISH_NAMESPACE messages with full field display.

Stopping discovery

Send UNSUBSCRIBE_NAMESPACE (draft-14) to stop receiving namespace announcements. In draft-17, the consolidated response pattern handles this differently.

Note

Not all relays support namespace discovery. Check your relay’s documentation for supported features.