snapshot of https://github.com/pion/webrtc.git (main, 2026-09-15; blobs > 131072B omitted)

examples/broadcast/README.md

@@ -0,0 +1,40 @@
+# broadcast
+broadcast is a Pion WebRTC application that demonstrates how to broadcast a video to many peers, while only requiring the broadcaster to upload once.
+
+This could serve as the building block to building conferencing software, and other applications where publishers are bandwidth constrained.
+
+## Instructions
+### Download broadcast
+```
+go install github.com/pion/webrtc/v4/examples/broadcast@latest
+```
+
+### Open broadcast example page
+[jsfiddle.net](https://jsfiddle.net/us4h58jx/) You should see two buttons `Publish a Broadcast` and `Join a Broadcast`
+
+### Run Broadcast
+#### Linux/macOS
+Run `broadcast` OR run `main.go` in `github.com/pion/webrtc/examples/broadcast`
+
+### Start a publisher
+
+* Click `Publish a Broadcast`
+* Press `Copy browser SDP to clipboard` or copy the `Browser base64 Session Description` string manually
+* Run `curl localhost:8080 -d "$BROWSER_OFFER"`. `$BROWSER_OFFER` is the value you copied in the last step.
+* The `broadcast` terminal application will respond with an answer, paste this into the second input field in your browser.
+* Press `Start Session`
+* The connection state will be printed in the terminal and under `logs` in the browser.
+
+### Join the broadcast
+* Click `Join a Broadcast`
+* Copy the string in the first input labelled `Browser base64 Session Description`
+* Run `curl localhost:8080 -d "$BROWSER_OFFER"`. `$BROWSER_OFFER` is the value you copied in the last step.
+* The `broadcast` terminal application will respond with an answer, paste this into the second input field in your browser.
+* Press `Start Session`
+* The connection state will be printed in the terminal and under `logs` in the browser.
+
+You can change the listening port using `-port 8011`
+
+You can `Join the broadcast` as many times as you want. The `broadcast` Golang application is relaying all traffic, so your browser only has to upload once.
+
+Congrats, you have used Pion WebRTC! Now start building something cool