mmatt.net / browser-stream
this repo has no description
fork atom
Rust 77.9%
Shell 10.6%
Dockerfile 6.3%
PowerShell 5.1%
5 1 0

Clone this repository

https://tangled.org/mmatt.net/browser-stream https://tangled.org/did:plc:tas6hj2xjrqben5653v5kohk/browser-stream
git@knot.tangled.wizardry.systems:mmatt.net/browser-stream git@knot.tangled.wizardry.systems:did:plc:tas6hj2xjrqben5653v5kohk/browser-stream

For self-hosted knots, clone URLs may differ based on your setup.

Download tar.gz
README.md

browser-stream#

Stream a fullscreen website to RTMP/RTMPS using Chromium + FFmpeg.

Example usage#

cargo run -- \
  --url https://example.com \
  --output rtmp://live.example.com/app/mystream

Equivalent split URL + stream key:

cargo run -- \
  --url https://example.com \
  --rtmp-url rtmp://live.example.com/app \
  --stream-key mystream

Build and run locally#

  1. Fetch sidecars:
./scripts/fetch-sidecars.sh
  1. Build:
cargo build --release
  1. Run:
cargo run -- \
  --url https://example.com \
  --output rtmp://live.example.com/app/mystream

Docker#

Use environment variables (copy .env.example to .env and edit values), then run:

docker compose up --build

Full image variant:

docker compose --profile full up --build browser-stream-full

Build images directly:

docker build --target slim -t browser-stream:slim .
docker build --target full -t browser-stream:full .

CLI arguments#

browser-stream supports the following flags:

Flag Type Default Required Notes
--url string none yes Website URL. Must be http or https.
--width u32 1920 no Frame width. Min 16.
--height u32 1080 no Frame height. Min 16.
--fps u32 30 no Frame rate. Range 1..=120.
--bitrate-kbps u32 4500 no Video bitrate in kbps. Min 100.
--keyint-sec u32 1 no GOP/keyframe interval in seconds. Range 1..=60.
--x264-opts string bframes=0 no Passed to x264 options.
--rtmp-url string none conditional Use with --stream-key if --output is not set.
--stream-key string none conditional Use with --rtmp-url if --output is not set.
--output string none conditional Full output URL (for example rtmp://.../app/key). Alternative to --rtmp-url + --stream-key.
--retries u32 5 no Number of retry attempts after failure.
--retry-backoff-ms u64 1000 no Delay between retries (milliseconds).
--startup-delay-ms u64 2000 no Delay before starting frame capture (milliseconds).
--frame-timeout-ms u64 30000 no Frame read timeout (milliseconds). Min 1000.
--no-audio bool flag false no Disable silent audio track.
--ffmpeg-path path auto no Override ffmpeg binary path.
--chromium-path path auto no Override chromium/headless shell binary path.
--verbose bool flag false no Enable verbose logging.

Output selection rules:

  • Provide --output, or
  • Provide both --rtmp-url and --stream-key.