add example for laplace start
[toast/stream2beamer.git] / stream2beamer.md
1 # Stream Desktop/Video/Webcam to Kodi/Beamer/other PCs
2 Gregor and I had a closer look at the following projects:
3
4 # Laplace
5 Simple WebRTC implementation in GO: https://github.com/adamyordan/laplace.git
6 Simple to compile and just works.
7 WebRTC actually uses SRTP (Secure Real-time Transport Protocol). 
8
9 IPv6+IPv4, and no TLS:
10
11     ./laplace -addr "[::]:8080" -tls=false
12
13 # gstreamer
14 ## WebRTC
15 gstreamer has a WebRTC implementation.
16 The examples at https://github.com/centricular/gstwebrtc-demos.git work once
17
18     export OPENSSL_CONF=''
19
20 has been set (see https://gitlab.freedesktop.org/gstreamer/gst-plugins-bad/issues/811)
21
22 Another maybe helpful link: https://developer.ridgerun.com/wiki/index.php?title=GstWebRTC_-_H264-Opus_Examples#Receive_Pipeline
23
24 # VLC
25 Note that you have to close VLC and open it again for new streaming as VLC leaves the connections
26 open (I spent hours figuring out why http based streaming doesn't work - `netstat -4 --ip` is nice
27 for debugging in that respect).
28
29 ## RTP
30 ### Source
31 The address has to be the address where the video should be streamed **to**. In the following
32 examples, a multicast address is used. It is either the IP address of the device receiving the video (unicast address) or a multicast address 
33 like 239.255.12.42 (multicast addresses are between 224.0.0.0 and 239.255.255.255, some of
34 them being reserved, 239.0.0.0 to 239.255.255.255 are Organization-Local Scope so they are
35 good candidates, see
36 https://www.iana.org/assignments/multicast-addresses/multicast-addresses.xhtml).
37
38     cvlc -vv --sout '#transcode{vcodec=h264,acodec=mpga,channels=2,vb=800,ab=128}:rtp{mux=ts,dst=239.255.12.42,sdp=sap,name="Geris Game"}' GerisGame.mp4
39     cvlc -vv --sout '#transcode{vcodec=h264,acodec=mpga,ab=128,channels=2,samplerate=44100,scodec=none}:rtp{dst=239.255.12.42,port=5004,mux=ts,sap,name=Geris Game}' :no-sout-all :sout-keep GerisGame.mp4
40     cvlc -vv --sout '#transcode{vcodec=h264,acodec=mpga,channels=2}:rtp{mux=ts,dst=239.255.12.42,sdp=sap,name="Videokamera"}' v4l2:///dev/video0 # long latency
41     cvlc -vv --sout '#transcode{vcodec=h264,acodec=mpga,channels=2}:rtp{mux=ts,dst=239.255.12.42,sdp=sap,name="Desktop"}' screen:// # not convincing
42
43 ### Player
44     cvlc rtp://239.255.12.42
45
46
47 ## RTSP
48 For VLC, RTSP means RTSP combined with RTP.
49
50 ### Source
51 We assume that the video source computer has the external IP 192.168.1.54.
52 Instead of rtsp://192.168.1.54:8554/ we could also use rtsp://192.168.1.54:8554/mystream.sdp
53
54     cvlc -vv --sout '#transcode{vcodec=h264,acodec=mpga,ab=128,channels=2,samplerate=44100,scodec=none}:rtp{sdp=rtsp://:8554/}' :no-sout-all :sout-keep GerisGame.mp4
55     cvlc -vv --sout '#rtp{dst=239.255.12.42,port=1234,sdp=rtsp://192.168.1.54:8554/}' :no-sout-all :sout-keep GerisGame.mp4
56
57
58 ### Player
59 The address needs to be the address of the source. Note the backslash at the end.
60
61     vlc rtsp://192.168.1.54:8554/
62
63
64 ## VLC Remarks
65 * Latency: The following options are said to reduce latency:
66
67       --network-caching=150 --clock-jitter=0 --clock-synchro=0
68
69 * Duplicating a stream is nice for debugging:
70
71       cvlc -vv --sout '#duplicate{dst=display,dst="transcode{vcodec=h264,acodec=mpga,channels=2,vb=800,ab=128}:rtp{mux=ts,dst=239.255.12.42,sdp=sap,name=Geris Game}"}' GerisGame.mp4
72       cvlc rtp://239.255.12.42
73
74
75 ## HTTP
76 The address at the source side has to be the external one of the local computer.
77
78 ### Source (server)
79     cvlc -vv --sout '#transcode{vcodec=mp4v,acodec=mpga,vb=800,ab=128}:standard{access=http,mux=ogg,dst=0.0.0.0:8080}' GerisGame.mp4
80
81 # Player (client)
82
83     vlc http://192.168.1.54:8080
84
85
86 # Kodi
87 The player built into code knows at least the following streaming protocols: http, rtsp.
88
89 https://kodi.wiki/index.php?title=Internet_video_and_audio_streams