Go to file
Alexandre Iooss 9a013c26ab
OME patch has been upstreamed
2020-09-18 09:54:59 +02:00
debian Rename service and default for Debian 2020-09-18 09:54:26 +02:00
doc Update OME stream path 2020-09-15 16:05:00 +02:00
ghostream Split /app to /stream and /play 2020-09-15 15:48:03 +02:00
.gitignore Flask app 2020-09-14 11:41:20 +02:00
.gitlab-ci.yml Missing flask for Debian package testing 2020-09-14 15:25:04 +02:00
Dockerfile Initial Docker example 2020-09-14 17:10:14 +02:00
MANIFEST.in Flask app 2020-09-14 11:41:20 +02:00
README.md OME patch has been upstreamed 2020-09-18 09:54:59 +02:00
setup.py Make a Debian package 2020-09-14 15:16:09 +02:00
tox.ini Lint code 2020-09-14 15:04:54 +02:00

README.md

Ghostream

License: GPL v2 pipeline status

Boooo! A simple streaming server with authentication and open-source technologies.

Features:

  • RTMPS ingest (OBS compatible).
  • RTMPS playback (VLC, MPV compatible).
  • WebRTC playback with a lightweight web interface.
  • Low-latency streaming, sub-second with web player.
  • Authentification of incoming stream using a LDAP server.

Installation on Debian/Ubuntu

This instructions were tested on Debian Buster. You need to unable non-free repository to have AAC codec.

NGINX

Install NGINX server.

Copy 60-ghostream.conf module to /etc/nginx/modules-available/60-ghostream.conf. Then symlink this file to /etc/nginx/modules-enabled/60-ghostream.conf.

Copy ghostream site to /etc/nginx/sites-available/ghostream. Then symlink this file to /etc/nginx/sites-enabled/ghostream.

Restart NGINX.

You may need to generate SSL certificates. For the initial generation, you may comment the SSL rules and use Certbot NGINX module.

OvenMediaEngine

Install some required libraries,

sudo apt update
sudo apt install --no-install-recommends build-essential ca-certificates nasm autoconf zlib1g-dev tcl cmake curl libssl-dev libsrtp2-dev libopus-dev libjemalloc-dev pkg-config libvpx-dev libswscale-dev libswresample-dev libavfilter-dev libavcodec-dev libx264-dev libfdk-aac-dev

Then compile libsrt,

curl -LOJ https://github.com/Haivision/srt/archive/v1.3.3.tar.gz
tar xvf srt-1.3.3.tar.gz
cd srt-1.3.3
./configure --prefix="/opt/ovenmediaengine" --enable-shared --enable-static=0
make -j 2
sudo make install
cd ..

Then compile OvenMediaEngine FFMpeg,

curl -LOJ https://github.com/AirenSoft/FFmpeg/archive/ome/3.4.tar.gz
tar xvf FFmpeg-ome-3.4.tar.gz
cd FFmpeg-ome-3.4
./configure --prefix="/opt/ovenmediaengine" --enable-gpl --enable-nonfree --extra-cflags="-I/opt/ovenmediaengine/include" --extra-ldflags="-L$/opt/ovenmediaengine/lib -Wl,-rpath,/opt/ovenmediaengine/lib" --extra-libs=-ldl --enable-shared --disable-static --disable-debug --disable-doc --disable-programs --disable-avdevice --disable-dct --disable-dwt --disable-error-resilience --disable-lsp --disable-lzo --disable-rdft --disable-faan --disable-pixelutils --disable-everything --enable-zlib --enable-libopus --enable-libvpx --enable-libfdk_aac --enable-libx264 --enable-encoder=libvpx_vp8,libvpx_vp9,libopus,libfdk_aac,libx264 --enable-decoder=aac,aac_latm,aac_fixed,h264 --enable-parser=aac,aac_latm,aac_fixed,h264 --enable-network --enable-protocol=tcp --enable-protocol=udp --enable-protocol=rtp --enable-demuxer=rtsp --enable-filter=asetnsamples,aresample,aformat,channelmap,channelsplit,scale,transpose,fps,settb,asettb
make
sudo make install
cd ..

Finally compile OvenMediaEngine,

curl -LOJ https://github.com/AirenSoft/OvenMediaEngine/archive/v0.10.7.tar.gz
tar xvf OvenMediaEngine-0.10.7.tar.gz
cd OvenMediaEngine-0.10.7/src
make release
sudo make install

Copy Server.xml to /usr/share/ovenmediaengine/conf/Server.xml.

Now enable and start OvenMediaEngine, sudo systemctl enable --now ovenmediaengine.

Ghostreamer web server

On Debian you can install ghostream deb.

On other system, you might install manually the Python module and Systemd unit ghostreamer.service.

You might customize /etc/default/ghostream.

Installation with Docker

An example is given in doc/docker-compose.yml. It uses Traefik reverse proxy.