Statistics
| Branch: | Revision:

peerstreamer-src @ master

Name Size Revision Age Author Comment
  Libs 7071cfbd 5 months Luca Baldesi apply bug fixes for the pstreamer engine
  Public 7305450b 7 months Luca Baldesi fix bug preventing change page remove the re-i...
  Test 07dd477d 6 months Luca Baldesi fix bugs on the RTP2WebRTC side * Destination ...
  Tools 58fb2cdc 7 months Luca Baldesi Add web source creation files
  src 07dd477d 6 months Luca Baldesi fix bugs on the RTP2WebRTC side * Destination ...
.gitignore 66 Bytes 92a361ca 9 months Luca Baldesi return the channel name with the channel creati...
.gitmodules 428 Bytes a89389f2 9 months Luca Baldesi fix remote path for the janus-gateway submodule...
COPYING 33.7 KB 9eb656e7 over 1 year Luca Baldesi First commit Add ReST URL router Add the task ...
Makefile 2.31 KB 2b3d6257 5 months Luca Baldesi fix Makefile clean target, fix readme instruction
README.md 3.08 KB 2b3d6257 5 months Luca Baldesi fix Makefile clean target, fix readme instruction
peerstreamer-ng.c 5.01 KB 1e7c49cb 7 months Luca Baldesi add local source channels to the list of known ...

Latest revisions

# Date Author Comment
7071cfbd 03/27/2018 02:00 PM Luca Baldesi

apply bug fixes for the pstreamer engine

2b3d6257 03/16/2018 10:01 AM Luca Baldesi

fix Makefile clean target, fix readme instruction

12da7cd6 03/14/2018 11:33 AM Luca Baldesi

add bug fixing from pstreamer repo

deaa09a4 03/09/2018 11:30 AM Luca Baldesi

Merge branch 'advanced_net_helper'

add net helper x support (with fragmentation, shaping and acknowledgments)

0019365c 02/13/2018 06:16 PM Luca Baldesi

fix network endianness encoding

07dd477d 02/08/2018 03:54 PM Luca Baldesi

fix bugs on the RTP2WebRTC side

  • Destination ip address for the pstreamer must be the janus endpoint.
  • Configuration of the janus instance module parameters is now fixed, but key must be separated from values by the ":" character;
    e.g., -s "janus_param=--configs-folder:Tools/janus_conf"
7305450b 01/30/2018 04:30 PM Luca Baldesi

fix bug preventing change page

remove the re-initialization of Janus when the page closes

cea8d274 01/30/2018 04:07 PM Luca Baldesi

add local source channel dumping feature

also change the keyframe request rate to "one every 5 seconds".

1e7c49cb 01/26/2018 05:38 PM Luca Baldesi

add local source channels to the list of known channels

9ff58c88 01/26/2018 02:10 PM Luca Baldesi

fix Javascript libraries and beautify html

View all revisions | View revisions

README


PeerStreamer-ng

PeerStreamer-ng [1] is P2P rel-time streaming platform. It is specifically design for mesh networks and it is meant to be purely decentralized.

Documentation

You can find documentation on usage and development on the official wiki: https://ans.disi.unitn.it/redmine/projects/peerstreamer-ng/wiki

Compilation

You need to install Janus dependencies, on ubuntu: sudo apt install libmicrohttpd-dev libjansson-dev libnice-dev libssl-dev libsrtp-dev libsofia-sip-ua-dev libglib2.0-dev libopus-dev libogg-dev libcurl4-openssl-dev pkg-config gengetopt libtool automake

After that, you can get the executable by running: $> make

To turn on all the debugging features, set the DEBUG environment variable: $> DEBUG=1 make

Test

PeerStreamer-ng comes with a unit test suite. It does require valgrind installed to run. In the "test" folder are stored the test files. To run them and check code consistency run: $> make tests

Tutorial: Stream a web camera with WebRTC

Tested on Ubuntu 17.10

In this tutorial we are creating a streaming source first, * Acquiring a media content from a local (usb) camera; * Encapsulating it in a RTP stream; * Creating a pstreamer P2P overlay; * Injecting the RTP stream in the overlay.

Then, we will launch PeerStreamer-ng to serve the P2P stream to the user through a browser supporting WebRTC.

The source

The following script captures a usb camera (/dev/video0) with FFmpeg which is used to stream it locally through RTP. It is important to note, to be able to serve the stream through WebRTC, FFmpeg must transcode the video with VP8. It also launches a source instance of pstreamer that takes such stream in input and use P2P mechanism to distribute it to the attaching peers.

Overall, this script creates a PeerStreamer-ng channel at IP address 127.0.0.1 on port 6000 and it saves its description on a local channel list file called channels.csv which we will use to feed PeerStreamer-ng with.

``` NAME="My Channel" VIDEO=/dev/video0 SDPFILE="file://${PWD}/channel.sdp" SOURCEPEERPORT=6000 RTPBASEPORT=5002 HOSTEXTIP=127.0.0.1

echo "$NAME,$HOSTEXTIP,$SOURCEPEERPORT,QUALITY,http://$HOSTEXTIP:8000/channel.sdp" > channels.csv

ffmpeg -re -i ${VIDEO} -vcodec libvpx -deadline realtime -an -f rtp rtp://127.0.0.1:$((RTPBASEPORT+2))\ -sdpfile $SDPFILE & FFMPEGPID=$!

Libs/pstreamer/pstreamer -p 0 -c "iface=lo,port=$SOURCEPEERPORT,chunkiser=rtp,audio=$RTPBASEPORT,\ video=$((RTPBASEPORT+2)),addr=127.0.0.1,maxdelayms=50" SOURCEPEERPID=$!

trap "kill $SOURCEPEERPID $FFMPEG_PID" SIGINT SIGTERM EXIT ```

You can download the script above from the project site.

PeerStreamer-ng

The following command executes PeerStreamer-ng and it start the HTTP interfaces. Pages are now served on port 3000 (overridable through the flags, see the command line help).

./peerstreamer-ng -c channel.csv

References

[1] https://ans.disi.unitn.it/redmine/projects/peerstreamer-ng

Also available in: Atom