mix moqx.inspect (moqx v0.7.1)

Copy Markdown View Source

Connects to a relay, loads a catalog when available, lets you choose a track, then prints live runtime stats (bandwidth, groups/s, objects/s, PRFT latency when present).

Usage

mix moqx.inspect [relay_url] [options]

Examples:

mix moqx.inspect
mix moqx.inspect --track 259
mix moqx.inspect --list-relay-presets
mix moqx.inspect --choose-relay --list-tracks-only
mix moqx.inspect --preset cloudflare-draft14-bbb --list-tracks-only
mix moqx.inspect https://ord.abr.moqtail.dev --namespace moqtail
mix moqx.inspect https://draft-14.cloudflare.mediaoverquic.com --namespace bbb --catalog-track .catalog --list-tracks-only
mix moqx.inspect https://draft-14.cloudflare.mediaoverquic.com --namespace bbb --no-fetch --list-tracks-only

Options:

  • --list-relay-presets - print known relay presets and example commands.
  • --choose-relay - interactively select a known relay preset.
  • --preset - apply a known relay preset by id.
  • --namespace - catalog/subscription namespace (default: "moqtail").
  • --catalog-track - explicit catalog track name. When omitted, moqx tries "catalog" and then ".catalog".
  • --no-fetch - skip catalog fetch and go directly to live subscribe.
  • --track - track name to subscribe to directly (skips interactive prompt).
  • --list-tracks-only - load a catalog, print tracks, and exit.
  • --timeout - connect/catalog/subscription timeout in ms (default: 10_000). When explicitly provided, it is also used as a max stream runtime; when it expires, the task exits cleanly.
  • --interval-ms - stats print interval in ms (default: 1_000).
  • --delivery-timeout-ms - passed through to MOQX.subscribe/4.
  • --show-raw - include full per-track raw catalog maps in listing output.
  • --help - prints this help.