Skip to main content
Version: 5.0 🚧

Stream Converter

Stream Converters listen at special TCP/UDP ports, accept new connections and receive packets, then convert to and push RTMP stream to SRS server like a RTMP client.

In short, it converts other protocols to RTMP, works like this:

Client ---PUSH--> Stream Converter --RTMP--> SRS --RTMP/FLV/HLS/WebRTC--> Clients

Note: Some stream protocol contains more than one single stream or even transport connections.

Use Scenario​

There are some use scenarios for stream caster, for example:

  • Push MPEG-TS over UDP, by some encoder device.
  • Push FLV by HTTP POST, by some mobile device.

Note: FFmpeg supports PUSH MPEGTS over UDP and FLV by HTTP POST to SRS.

Build​

Stream Converter is always enabled in SRS, while some protocols might need special configure parameters, please read instructions of each protocol.

Protocols​

The protocols supported by Stream Converter:

  • MPEG-TS over UDP: MPEG-TS stream over UDP protocol.
  • FLV by HTTP POST: FLV stream over HTTP protocol.

Config​

The configuration for stream converter:

# Push MPEGTS over UDP to SRS.
stream_caster {
    # Whether stream converter is enabled.
    # Default: off
    enabled on;
    # The type of stream converter, could be:
    #       mpegts_over_udp, push MPEG-TS over UDP and convert to RTMP.
    caster mpegts_over_udp;
    # The output rtmp url.
    # For mpegts_over_udp converter, the typically output url:
    #           rtmp://127.0.0.1/live/livestream
    output rtmp://127.0.0.1/live/livestream;
    # The listen port for stream converter.
    # For mpegts_over_udp converter, listen at udp port. for example, 8935.
    listen 8935;
}

# Push FLV by HTTP POST to SRS.
stream_caster {
    # Whether stream converter is enabled.
    # Default: off
    enabled on;
    # The type of stream converter, could be:
    #       flv, push FLV by HTTP POST and convert to RTMP.
    caster flv;
    # The output rtmp url.
    # For flv converter, the typically output url:
    #           rtmp://127.0.0.1/[app]/[stream]
    # For example, POST to url:
    #           http://127.0.0.1:8936/live/livestream.flv
    # Where the [app] is "live" and [stream] is "livestream", output is:
    #           rtmp://127.0.0.1/live/livestream
    output rtmp://127.0.0.1/[app]/[stream];
    # The listen port for stream converter.
    # For flv converter, listen at tcp port. for example, 8936.
    listen 8936;
}

Please follow instructions of specified protocols bellow.

Push MPEG-TS over UDP​

You're able to push MPEGTS over UDP to SRS, then covert to RTMP and other protocols.

First, start SRS with configuration for MPEGTS:

./objs/srs -c conf/push.mpegts.over.udp.conf

Note: About the detail configuration, please read about the mpegts_over_udp section of config.

Then, start to push stream, for example, by FFmpeg:

ffmpeg -re -f flv -i doc/source.flv -c copy -f mpegts udp://127.0.0.1:8935

Finally, play the stream:

Please note that each UDP port is bind to a RTMP stream.

Note: About the development notes, please see #250.

Push HTTP FLV to SRS​

You're also able to push HTTP FLV by HTTP POST, which is very simple for mobile device to send HTTP stream.

First, start SRS with configuration for FLV:

./objs/srs -c conf/push.flv.conf

Note: About the detail configuration, please read about the flv section of config.

Then, start to push stream, for example, by FFmpeg:

ffmpeg -re -f flv -i doc/source.flv -c copy \
    -f flv http://127.0.0.1:8936/live/livestream.flv

Finally, play the stream:

Note: About the development notes, please see #2611.

Push RTSP to SRS​

It's been eliminated, see #2304.

2015.1

Β©2013~2023 SRS