Skip to content

Add Update 01 blog post #116

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

Merged
kixelated merged 2 commits into from
Jul 31, 2026
+115 −0
Merged

Add Update 01 blog post #116

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
78b2e4f
Add Update 01 blog post
kixelated Jul 31, 2026
f3deff8
Correct the stats section
kixelated Jul 31, 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
115 changes: 115 additions & 0 deletions src/pages/blog/update-01.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,115 @@
---
layout: "@/layouts/global.astro"
title: Update 01
author: kixelated
description: moq-lite-05, legacy format import/export, stats, a big moq-net API break, and five new language bindings.
cover: "/blog/update-00/globe.png"
date: 2026-07-31
---

# Update 01

sup nerds.

I hit the merge button on the `dev` branch: +129k -24k

## moq-lite-05
[Read the draft](https://www.ietf.org/archive/id/draft-lcurley-moq-lite-05.html)

For those unawares, `moq-lite` is my subset of the *official* `moq-transport` draft.
It's dramatically simpler and honest about supported functionality.
You know exactly what the peer will support, unlike the sprawling and perpetually optional `moq-transport` draft.

Anyway, here's the new stuff (partially) cherry-picked from `moq-transport`:
- **FETCH**: Request a single group from the past. Intended for VOD/DVR, similar to HTTP.
- **DATAGRAMS**: Unreliable and lossy. I still claim you should [never use datagrams](/blog/never-use-datagrams) but they're now an option.
- **PATH**: For underlying transports without a path: TLS/TCP/UDS.

But `moq-lite` is also a testing ground, extending `moq-transport` with new functionality:
- **TIMESTAMPS**: Timestamp/timescale is now part of the transport, so relays know accurate expiration times.
- **HOPS**: Each announcement includes previous hops (prevents cycles) and soon an explicit cost.
- **PROBE**: The sender can report/probe the estimated send rate, used for ABR.

I've made IETF extensions for these if anybody cares.
Knock yourself out lul.

## Export/Import
I want to help you support your crappy legacy formats.
So you can get one foot in the MoQ door.

- **moq-rtmp**: Import/export RTMP streams.
- **moq-rtc**: WebRTC support via [WHIP](https://datatracker.ietf.org/doc/rfc9725/) and [WHEP](https://datatracker.ietf.org/doc/draft-ietf-wish-whep/).
- **moq-srt**: A gross protocol, please stop using it...
- **moq-hls**: HLS export to both disk and (soon) a live origin. There's also DASH support I guess.

## Stats
Each relay (or client) can now publish metrics as a `.stats/node/<node>` broadcast.
We dog food in this bitch.

We publish cumulative metrics for each broadcast once per second.
We use JSON Merge Patch and DEFLATE to minimize the size of each update, served as a `.json.z` sibling of each plain track.
There's a **moq-stats** crate to do all of the heavy lifting.

You can run a worker to discover and aggregate all of these metrics.
That's how [moq.pro](https://moq.pro) works.

There's also `/metrics` for Prometheus if you want to integrate with other stuff.
Boring.


## moq-net API
I got the feedback that there were too many breaking API changes.
That's why I'm making one massive breaking change instead.
ur welcome.

**Rust + JS Stuff**:
- Moved into modules: ex. `BroadcastConsumer` -> `broadcast::Consumer`.
- `track::Consumer::subscribe()` returns a `track::Subscriber`, so fetching doesn't require an active subscription.

**JS Only Stuff**:
- Signals split into `in` and `out` sections, where `out` is read-only.

**Rust Only Stuff**:
- Global LRU to maximize cache usage, instead of a 5s hard expiration.
- Route changes no longer sever the subscription!

The last one is cool, although kind of niche.
If you establish multiple connections that can both serve broadcast A, any subscriptions will prefer the shortest path but seamlessly switch to the other path if the first one fails (or becomes higher cost).

So like... you could connect to both [moq.pro](https://moq.pro) and Cloudflare.
If one goes down, the other will take over SEAMLESSLY.


## Language Bindings
Rust and TypeScript are the *official* languages we support, but we're adding more languages to the party.
It's Rust under the hood of course.

Instead of the gross raw **moq-ffi** bindings, there are some "ergonomic" wrappers that feel more native.
These APIs are vibe coded (I don't know these languages lul) so please raise a stink if any API is gross.

- **Python**: [`moq-rs`](https://pypi.org/project/moq-rs/) on PyPI ([docs](https://moq-rs.readthedocs.io)).
- **Go**: [`github.com/moq-dev/moq-go`](https://pkg.go.dev/github.com/moq-dev/moq-go).
- **Kotlin**: [`dev.moq:moq`](https://central.sonatype.com/artifact/dev.moq/moq) on Maven Central ([docs](https://javadoc.io/doc/dev.moq/moq)).
- **Swift**: [`moq-swift`](https://swiftpackageindex.com/moq-dev/moq-swift/documentation/moq) via SPM.

@coderabbitai coderabbitai Bot Jul 31, 2026

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

📐 Maintainability & Code Quality | 🟡 Minor | ⚡ Quick win

🧩 Analysis chain

🏁 Script executed:

#!/bin/bash
set -euo pipefail

echo "== locate file =="
git ls-files | grep -F 'src/pages/blog/update-01.mdx' || true

echo "== relevant lines =="
sed -n '80,100p' src/pages/blog/update-01.mdx 2>/dev/null || true

echo "== swift links in repo =="
rg -n "moq-swift|moq-dev/moq-swift|swiftpackageindex|doc\.moq\.dev|swiftpackage" src/pages/blog/update-01.mdx src/pages/blog || true

echo "== fetch link status and redirect headers =="
python3 - <<'PY'
import urllib.request

urls = [
    "https://swiftpackageindex.com/moq-dev/moq-swift/documentation/moq",
    "https://github.com/moq-dev/moq-swift",
    "https://doc.moq.dev/lib/swift/",
]
for url in urls:
    try:
        req = urllib.request.Request(url, method='HEAD', headers={"User-Agent": "CodeRabbit-link-check"})
        with urllib.request.urlopen(req, timeout=15) as r:
            print(f"{url}: {r.status} {r.geturl()}")
    except Exception as e:
        print(f"{url}: ERROR {type(e).__name__}: {e}")
PY

echo "== fetch package/index pages =="
python3 - <<'PY'
import urllib.request
urls = [
    "https://github.com/moq-dev/moq-swift",
    "https://doc.moq.dev/lib/swift/",
    "https://swiftpackageindex.com/moq-dev/moq-swift",
]
for url in urls:
    try:
        req = urllib.request.Request(url, headers={"User-Agent": "CodeRabbit-link-check-readme"})
        with urllib.request.urlopen(req, timeout=20) as r:
            body = r.read().decode("utf-8", errors="replace")
            lines = body.splitlines()[:80]
            print(f"\n--- {r.geturl()} status={r.status} ---")
            print("\n".join(lines))
    except Exception as e:
        print(f"{url}: ERROR {type(e).__name__}: {e}")
PY

Repository: moq-dev/moq.dev

Length of output: 5590

Replace the broken Swift documentation link.

The Swift Package Index /documentation/moq link for moq-dev/moq-swift resolves to 404 Not Found. Use a working SPM/package link instead, or a working documentation link.

🤖 Prompt for AI Agents 
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@src/pages/blog/update-01.mdx` at line 93, Update the Swift entry in the
documentation list to replace the broken Swift Package Index documentation URL
with a verified working SPM/package or documentation link for moq-dev/moq-swift,
keeping the existing label and formatting unchanged.

- **C**: [`libmoq`](https://docs.rs/libmoq).

Full docs for each language: [doc.moq.dev/lib](https://doc.moq.dev/lib/).

## Native Media
I got tired of ffmpeg and figured I'd **REWRITE IT IN RUST**.

**Disclaimer**: this stuff is mostly vibe coded. Don't trust it lul.

- **moq-video**: Capture, encode, decode, and render video. Uses hardware acceleration via OS/GPU-specific APIs. For example: [moq-nvenc](https://crates.io/crates/moq-nvenc) and [moq-vaapi](https://crates.io/crates/moq-vaapi).
- **moq-audio**: Capture, encode, decode, and render audio. Duh.
- **moq-transcode**: On-demand transcoding utilizing FETCH.

We're merging in relevant stuff from [iroh-live](https://github.com/n0-computer/iroh-live) so more features are coming soon.
These crates will keep evolving as they actually turn into products (and get reviewed lul).


## FIN
IDK what else to say.

Written by [@kixelated](https://github.com/kixelated).
![@kixelated](/blog/avatar.png)
Loading