marazmarci/docker-srt

Docker image definition with compiled SRT live streaming protocol

docker-srt

Docker image definition with for the SRT library, with srt-live-transmit as the entry point. SRT is a live-streaming protocol.

Building the Docker image locally

1. Ensure you have Docker installed.
2. Clone this repository.
3. Run this command in the repository's folder:

   docker build -t docker-srt .

Testing the image

1. This should output srt-live-transmit's help:

   docker run --rm -it docker-srt

2. To test it on a single machine with real live video, if you have ffmpeg installed you can do:

   # Terminal 1: Run SRT RX
   MY_IP="10.0.0.2" # Replace it with your machine's IP
   docker run --name="srt-rx" -it --rm docker-srt -v -r:10 -s:5 "srt://0.0.0.0:9000?mode=server" "udp://$MY_IP:7010?mode=client"
   
   # Terminal 2: Run SRT TX
   docker run --name="srt-tx" --link="srt-rx" -it --rm -p 7000:7000/udp docker-srt -v -r:10 -s:5 "udp://:7000" "srt://srt-rx:9000?mode=client"
   
   # Terminal 3: Run ffplay viewer
   ffplay udp://127.0.0.1:7010
   
   # Terminal 4: Run ffmpeg source
   ffmpeg -f lavfi -re -i smptebars=duration=60:size=1280x720:rate=30 -f lavfi -re -i sine=frequency=1000:duration=60:sample_rate=44100 -pix_fmt yuv420p -c:v libx264 -b:v 1000k -g 30 -keyint_min 120 -profile:v baseline -preset veryfast -c:a libfdk_aac -b:a 96k -f mpegts "udp://127.0.0.1:7000?pkt_size=1316&flush_packets=0"

Using the image

The container's entry point is srt-live-transmit. As seen in the examples above, the arguments should be written after docker-srt in the docker run command.

Note: It is important to point out that if you use UDP as input of SRT, the payload of the UDP packets has to be smaller or equal to 1456 bytes (See: Haivision/srt#86)
(Or you can just add the --network=host flag to docker run as a workaround.)