Thursday, March 30, 2017

Setup Live Streaming with NGINX RTMP module



It is a lot of fun to implement live streaming with nginx rtmp module since you can stream movies, live games competition, live news, live music event, etc that it can be seen other people in different place in real time. 
In this project, I used nginx rtmp module that you can get free to build your own live streaming server. Let's start on how to implement live streaming...

First you need to build the nginx rtmp module that you can find the guidance here


Configuring nginx.conf

Next, you need to configure nginx.conf by adding rtmp{} section. Original nginx.conf contains only http{} section.

Here is an example for simple nginx.conf configuration


#user  nobody;
worker_processes  1;

error_log  logs/error.log debug;

events {
    worker_connections  1024;
}

http {
    include       mime.types;
    default_type  application/octet-stream;

    sendfile        on;
    keepalive_timeout  65;

    server {
        listen       8080;
        server_name  localhost;
        
        # rtmp stat
        location /stat {
            rtmp_stat all;
            rtmp_stat_stylesheet stat.xsl;
        }

        location /stat.xsl {
            # you can move stat.xsl to a different location
            # in my case, i used /home/addies/build/nginx-rtmp-module
            root /home/addies/build/nginx-rtmp-module;
        }

        # rtmp control
        location /control {
            rtmp_control all;
        }

        error_page   500 502 503 504  /50x.html;
        location = /50x.html {
            root   html;
        }
    }
}

rtmp {
    server {
        listen 1935;
        ping 30s;
        notify_method get;

        application myapp {
            live on;        
        }
    }
}


Then you can start nginx with command:
sudo /usr/local/nginx/sbin/nginx -s stop
sudo /usr/local/nginx/sbin/nginx



Publishing

Here is the way that we can do publishing the streaming
1. publishing with ffmpeg
2. publishing with Open Broadcaster Software (OBS)

This time, I will use publishing with ffmpeg.
Next section, I will create another tutorial for publishing with Open Broadcaster Software (OBS)



Publishing with ffmpeg

Now, we will do stream test with file location in /home/addies/stream/any_files_for_testing.mp4 
Assumption, you have installed nginx rtmp server (this can be done in virtual machine just for testing if you don't have VPS). In my case, I used virtual machine with Ubuntu-14.04.5-server-amd64 to implement this...just for my own experiement.

Open linux terminal in nginx rtmp server and type command:

ffmpeg -re -i /home/addies/stream/any_files_for_testing.mp4 -c copy -f flv rtmp://localhost:1935/myapp/mystream 

If you use terminal in different computer, then you must change the localhost to your nginx rtmp IP address.

Note:
-i              :  input streaming location
myapp      : routing nginx.conf that you provide in rtmp{} section
mystream : stream key (you can use any name for it)

if you don't have ffmpeg then you must install it by using command 
sudo apt-get install ffmpeg

see on how to install ffmpeg here



Pic 1. ffmpeg stream file is running


then you can see the streaming by using rtmp player. In my case, I used vlc player since vlc support rtmp (you can use other rtmp player).

Open and input the stream url as following picture below
      rtmp://192.168.135.128:1935/myapp/mystream

Please change the IP Address 192.168.135.128 to your IP Address


 Pic 2. Input stream url into vlc


Finally, you will get the streaming result as below


Pic 3. Streaming result


The above sample is just streaming without any conversion. I use any_files_for_testing.mp4 codecs are compatible with rtmp.

If you need streaming and encoding audio (AAC) and video (H264), need libx264 and libfaac  then here is the command:
ffmpeg -re -i  /home/addies/stream/any_files_for_testing.mp4  -c:v libx264 -c:a libfaac -ar 44100 -ac 1 -f flv rtmp://localhost/myapp/mystream



Thank you for reading my tutorial and hope you enjoy it.


See you in next tutorial




Posted by at

2 comments:

Subscribe to: Post Comments (Atom)