Skip to content

RT-696: Add MoQ demo streams documentation #33494

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
itzmanish wants to merge 2 commits into
base: production
Choose a base branch
from
Open

RT-696: Add MoQ demo streams documentation #33494

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
0db0b1c
RT-696: Add MoQ demo streams documentation
itzmanish Sep 17, 2026
eab638a
RT-696: Fix MoQ demo stream style warnings
itzmanish Sep 17, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
56 changes: 56 additions & 0 deletions src/content/docs/moq/demo-streams/index.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,56 @@
---
title: Demo streams
pcx_content_type: how-to
description: Subscribe to long-running MoQ demo streams using draft-14 or draft-16.
sidebar:
order: 3

head:
- tag: title
content: Demo streams
---

import { Tabs, TabItem } from "~/components";

Cloudflare publishes long-running streams on the public [MoQ](/moq/) relays. Use these streams to test client implementations without setting up your own publisher.

## Available namespaces

The relays host the following namespaces. A check mark indicates that a namespace is available for that draft.

| Namespace | Draft-14 | Draft-16 |
| ----------------- | :------: | :------: |
| `/bbb` | ✅ | ✅ |
| `/demo-tos-360p` | ✅ | — |
| `/demo-tos-720p` | ✅ | — |
| `/demo-tos-1080p` | ✅ | — |
| `/demo-tos-4k` | ✅ | — |

## Subscribe with moq-sub

`moq-sub` from the [moq-rs](https://github.com/cloudflare/moq-rs) project writes the media as fragmented MP4 to standard output. Select a draft to view the matching command.

<Tabs>
<TabItem label="Draft-14">

Draft-14 supports every namespace in the table. This example subscribes to `/bbb`:

```sh
moq-sub https://draft-14.cloudflare.mediaoverquic.com --name bbb
```

</TabItem>
<TabItem label="Draft-16">

Draft-16 supports only `/bbb`. Its relay URL includes the provided JSON Web Token (JWT):

```sh
moq-sub https://draft-16.cloudflare.mediaoverquic.com/eyJhbGciOiJFZERTQSIsImtpZCI6Im1vcS12MSIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJtb3EuY2xvdWRmbGFyZS5jb20iLCJleHAiOjE4MTY0NDA0NTcsImlhdCI6MTc4NDkwNDQ1OCwiaXNzIjoiY2xvdWRmbGFyZSIsImp0aSI6IjgxMTc4MjIyZmIzNTVjMDQ3YmM0MDNkODQ2NWI0YWIzIiwib3BlcmF0aW9ucyI6WyJzdWJzY3JpYmUiXSwic3ViIjoiZWJkMWZlZDdhZjMzNzYzMjc3MDc0ODQ0NThmYWIxZmEifQ.VlTscBfWmjSybWx1NpmF0f1g5Gtfxg5H4rkUQQa2JHATtjGwO5iwl71DAS5kJ98-3ukPvmGe9RE7peYs_dqgCg --name bbb
```

The provided JWT lets you subscribe without provisioning a relay or creating a token.

</TabItem>
</Tabs>

To play the stream with `ffplay`, append `| ffplay -` to either command.
Loading