Skip to content
n0-computerPublic

About

media livestreaming over iroh

Topics

Resources

Contributing

Stars

146 stars

Watchers

5 watching

Forks

Latest commit

 

History

622 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

iroh-live

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 main branch by git rev, so it is not yet on crates.io.

Quick start

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.

Using iroh-live in Rust

[dependencies]
iroh-live = { git = "https://github.com/n0-computer/iroh-live", features = ["full"] }

The library quickstart has a complete publisher and viewer.

Documentation

The book in docs/ has:

Crates

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

  • 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.

Contributing

DEVELOPMENT.md covers the build, the tests and the conventions, and Contributing the docs. Issues go in the tracker.

License

Copyright 2025 N0, INC.

This project is licensed under either of

at your option.

Contribution

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.

About

media livestreaming over iroh

Topics

Resources

Contributing

Stars

146 stars

Watchers

5 watching

Forks

Releases

Packages

Contributors

Languages