Prerequisites

OvenMediaEngine works in concert with a variety of open source and library. First, install them on your clean Linux machine as described below. We think that OvenMediaEngine can support most Linux packages, but the tested platforms we use are Ubuntu 18+, Fedora 28+, and CentOS 7+.

$ (curl -LOJ https://github.com/AirenSoft/OvenMediaEngine/archive/v0.9.1.tar.gz && tar xvfz OvenMediaEngine-0.9.1.tar.gz)
$ OvenMediaEngine-0.9.1/misc/prerequisites.sh

Build & Run

You can build OvenMediaEngine sources using the following command.

$ cd OvenMediaEngine-0.9.1/src
$ make release
$ sudo make install
$ systemctl start ovenmediaengine
# If you want automatically start on boot
$ systemctl enable ovenmediaengine.service 

$ export PKG_CONFIG_PATH=${PKG_CONFIG_PATH}:/usr/local/lib/pkgconfig:/usr/local/lib64/pkgconfig
$ export LD_LIBRARY_PATH=${LD_LIBRARY_PATH}:/usr/local/lib:/usr/local/lib64
$ cd OvenMediaEngine-0.9.1/src
$ make release
$ sudo make install
$ systemctl start ovenmediaengine
# If you want automatically start on boot
$ systemctl enable ovenmediaengine.service

$ echo 'export PKG_CONFIG_PATH=${PKG_CONFIG_PATH}:/usr/local/lib/pkgconfig:/usr/local/lib64/pkgconfig' >> ~/.bashrc 
$ echo 'export LD_LIBRARY_PATH=${LD_LIBRARY_PATH}:/usr/local/lib:/usr/local/lib64' >> ~/.bashrc

$ source scl_source enable devtoolset-7
$ export LD_LIBRARY_PATH=${LD_LIBRARY_PATH}:/usr/local/lib:/usr/local/lib64:/usr/lib
$ export PKG_CONFIG_PATH=${PKG_CONFIG_PATH}:/usr/local/lib/pkgconfig:/usr/local/lib64/pkgconfig
$ cd OvenMediaEngine-0.9.1/src
$ make release
$ sudo make install
$ systemctl start ovenmediaengine
# If you want automatically start on boot
$ systemctl enable ovenmediaengine.service

$ echo 'source scl_source enable devtoolset-7' >> ~/.bashrc 
$ echo 'export LD_LIBRARY_PATH=${LD_LIBRARY_PATH}:/usr/local/lib:/usr/local/lib64:/usr/lib' >> ~/.bashrc 
$ echo 'export PKG_CONFIG_PATH=${PKG_CONFIG_PATH}:/usr/local/lib/pkgconfig:/usr/local/lib64/pkgconfig' >> ~/.bashrc

Ports used by default

The default configuration uses the following ports, so you need to open them in your firewall settings.

You can open the port of the firewall as shown in the following example.

$ sudo firewall-cmd --add-port=80/tcp
$ sudo firewall-cmd --add-port=1935/tcp
$ sudo firewall-cmd --add-port=3333/tcp
$ sudo firewall-cmd --add-port=9000/udp
$ sudo firewall-cmd --add-port=10000-10005/udp

Hello Ultra-low Latency Streaming

Start Stream

You can live streaming using live encoders such as OBS, XSplit. Please set the RTMP URL as below:

rtmp://<Server IP>[:<RTMP Port>]/<Application name>/<Stream name>

The meanings of each item are as follows:

• <Server IP>: The IP address or domain of the OvenMediaEngine server.

• <RTMP Port>: You can use <Port> of <Provider> in the above Server.xml file. If you use the default configuration, the RTMP default port (1935) is used. Also, If you set the default port, you can omit the port.

• <Application name>: This value corresponds to <Name> of <Application> in conf/Server.xml. If you use the default configuration, you can use the app.

• <Stream name>: The name of the stream you defined.

After you enter the above RTMP URL into the encoder and start publishing, you will have an environment in which the player can view the live stream.

Example of using OBS Encoder

The transmitting address in OBS needs to use the <Application name> generated in Server.xml. If you use the default configuration, the app has already been created, and you can use it.

• You install OBS on your PC and run it.

• Click "File" in the top menu, then "Settings" (or press "Settings" on the bottom-right).

• Select the "Stream" tab and fill in the settings.

• Go to the "Output" tab.

• Set the following entries.

We are strongly recommended that you use the CPU (ultrafast), Profile (baseline), and Tune (zerolatency) sections of the OBS configuration for low latency.

Playback

We have prepared a test player so that you can easily check that the OvenMediaEngine is working well. For more information, see the Test Player chapter.

Please note that the WebRTC Signalling URL is similar to the RTMP URL and consists of the following:

• ws://<Server IP>:[<Signalling Port>/<Application name>/<Output Stream name>

  • <Server IP>: The IP address or domain of the OvenMediaEngine server.

  • <Signalling Port>: You can use the value of <Signalling><ListenPort> in Server.xml above. If you use the default configuration, the WebRTC signalling default port (3333) is used.

  • <Application name>: This value corresponds to <Name> of <Application> in conf/Server.xml. If you use the default configuration, you can use the app.

  • <Output Stream name>: You must use an output stream name for streaming. If you are using the default configuration, an output stream named <Stream Name>_o is automatically generated when stream is input.

If you want to build OvenPlayer in your environment, see OvenPlayer Quick Start.