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