1# rtp-forwarder
2rtp-forwarder is a simple application that shows how to forward your webcam/microphone via RTP using WebRTC.rs.
3
4## Instructions
5### Build rtp-forwarder
6```shell
7cargo build --example rtp-forwarder
8```
9
10### Open rtp-forwarder example page
11[jsfiddle.net](https://jsfiddle.net/1qva2zd8/) you should see your Webcam, two text-areas and a 'Start Session' button
12
13### Run rtp-forwarder, with your browsers SessionDescription as stdin
14In the jsfiddle the top textarea is your browser, copy that and:
15#### Linux/macOS
16Run `echo $BROWSER_SDP | ./target/debug/examples/rtp-forwarder`
17#### Windows
181. Paste the SessionDescription into a file.
191. Run `./target/debug/examples/rtp-forwarder < my_file`
20
21### Input rtp-forwarder's SessionDescription into your browser
22Copy the text that `rtp-forwarder` just emitted and copy into second text area
23
24### Hit 'Start Session' in jsfiddle and enjoy your RTP forwarded stream!
25You can run any of these commands at anytime. The media is live/stateless, you can switch commands without restarting Pion.
26
27#### VLC
28Open `rtp-forwarder.sdp` with VLC and enjoy your live video!
29
30#### ffmpeg/ffprobe
31Run `ffprobe -i rtp-forwarder.sdp -protocol_whitelist file,udp,rtp` to get more details about your streams
32
33Run `ffplay -i rtp-forwarder.sdp -protocol_whitelist file,udp,rtp` to play your streams
34
35You can add `-fflags nobuffer` to lower the latency. You will have worse playback in networks with jitter.
36
37#### Twitch/RTMP
38`ffmpeg -protocol_whitelist file,udp,rtp -i rtp-forwarder.sdp -c:v libx264 -preset veryfast -b:v 3000k -maxrate 3000k -bufsize 6000k -pix_fmt yuv420p -g 50 -c:a aac -b:a 160k -ac 2 -ar 44100 -f flv rtmp://live.twitch.tv/app/$STREAM_KEY` Make sure to replace `$STREAM_KEY` at the end of the URL first.
39