Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
NGINX-based Media Streaming Server
C XSLT Other
tree: 3f9dea711d

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
doc
test
AUTHORS
LICENSE
README
TODO
config
ngx_rtmp.c
ngx_rtmp.h
ngx_rtmp_access_module.c
ngx_rtmp_amf.c
ngx_rtmp_amf.h
ngx_rtmp_cmd_module.c
ngx_rtmp_cmd_module.h
ngx_rtmp_core_module.c
ngx_rtmp_handler.c
ngx_rtmp_live_module.c
ngx_rtmp_netcall_module.c
ngx_rtmp_netcall_module.h
ngx_rtmp_notify_module.c
ngx_rtmp_receive.c
ngx_rtmp_record_module.c
ngx_rtmp_send.c
ngx_rtmp_shared.c

README

== nginx-rtmp-module ==

NGINX-based RTMP server

* Live streaming of video/audio

* Recording published streams in FLV file

* HTTP callbacks on publish/play/record

* Advanced buffering techniques
  to keep memory allocations at a minimum
  level for faster streaming and low
  memory footprint

* Works with Flash RTMP clients as well as
  ffmpeg/rtmpdump/flvstreamer etc
  (see examples in test/ subdir)


Build:

cd to NGINX source directory & run this:

./configure --add-module=<path-to-nginx-rtmp-module>
make
make install


Note the module does not share data between workers
and only works in one-worker mode. 


RTMP URL format:

rtmp://rtmp.example.com/<app>[/<name>]

<app> -  should match one of application {}
         blocks in config
<name> - interpreted by each application
         can be empty


Example nginx.conf:

rtmp {

    server {

        listen 1935;

        chunk_size 4000;

        max_buf 1M;

        # TV mode: one publisher, many subscribers
        application mytv {

            # enable live streaming
            live on;

            # record first 1K of stream
            record all;
            record_path /tmp/av;
            record_max_size 1K;

            # publish only from localhost
            allow publish 127.0.0.1;
            deny publish all;

            #allow play all;
        }

        # Many publishers, many subscribers
        # no checks, no recording
        application videochat {

            live on;

            # The following notifications receive all 
            # the session variables as well as 
            # particular call arguments in HTTP POST
            # request

            # Make HTTP request & use HTTP retcode
            # to decide whether to allow publishing
            # from this connection or not
            on_publish http://localhost:8080/publish;

            # Same with playing
            on_play http://localhost:8080/play;

            # record 10 video keyframes (no audio) every 2 minutes
            record keyframes;
            record_path /tmp/vc;
            record_max_frames 10;
            record_interval 2m;

            # Async notify about an flv recorded
            on_record_done http://localhost:8080/record_done;

        }

    }
}

Something went wrong with that request. Please try again.