Real-time audio and video over iroh, written in Rust. Peers connect directly, with no media server in the middle. The wire protocol is Media over QUIC: every video rendition and every audio track travels on its own QUIC streams, so a lost video packet never delays audio. Each viewer's player picks the rendition its link can carry, and keeps audio and video in step.
Early tech preview. Expect frequent API changes. iroh-live currently depends on moq's unreleased
mainbranch by git rev, so it is not yet on crates.io.
Download irl from the
rolling release,
or build it:
cargo install --locked --path iroh-live-cli
# Publish the camera and microphone. Prints a ticket and a QR code.
irl publish
# On another machine
irl watch <TICKET>Without a camera, irl publish --test-source publishes a test pattern and a
beeping tone. To open the stream in a browser, run the iroh-live relay and
open http://localhost:4443/?name=<TICKET>, as the
CLI quickstart
shows.
[dependencies]
iroh-live = { git = "https://github.com/n0-computer/iroh-live", features = ["full"] }The library quickstart has a complete publisher and viewer.
The book in docs/ has:
- Getting started: install, CLI quickstart, library quickstart.
- Concepts: how it fits together, nodes, paths, routes, access control and relays.
- How-to guides: publish, watch, call, rooms, browsers, recording, access, tuning, Android and Raspberry Pi.
- Reference: the
irlCLI, Cargo features, environment variables, the relay and platform support. - Architecture, troubleshooting, glossary, and migrating from the previous release.
iroh-live is the library most applications need.
iroh-live-cli is the irl tool, and
iroh-live-relay the relay for browsers. The
crates reference lists the rest.
demos/android: an Android app that watches, publishes and calls, with hardware H.264 and zero-copy rendering.demos/pi-zero: a Raspberry Pi camera publisher with an e-paper QR display and a GLES2 viewer.
DEVELOPMENT.md covers the build, the tests and the conventions, and Contributing the docs. Issues go in the tracker.
Copyright 2025 N0, INC.
This project is licensed under either of
- Apache License, Version 2.0, (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
- MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)
at your option.
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in this project by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.