livebox

Minimal RTMP to HLS solution in Docker. Built with static nginx and ffmpeg binaries to minimize image size.

Install

docker pull ziyan/livebox:latest

Run

You need to prepare a location on your harddisk for all generated files. The location will be used as a volume in docker container. The location must be owned by www-data:www-data.

mkdir data
chown www-data:www-data data

Please first take a look at the example for a standard setup using docker-compose, to run the example:

docker-compose build
docker-compose up -d

To publish to the livebox instance:

ffmpeg -re -i input.flv -c copy -f flv rtmp://localhost/live/livestream

Then, your stream can be played at:

http://localhost/livestream.m3u8

Advanced usage

To run livebox standalone:

docker run -p 1935:1935 -v $(pwd)/data:/data ziyan/livebox:latest

Configurations

These settings should be passed in to docker using -e "KEY=VALUE" arguments. Or, see example for how to use them in docker-compose.yml.

• HLS settings

  • HLS_LIST_SIZE=10 How many segments should be kept in the m3u8 live playlist
  • HLS_TIME=4 How long each segment should be in seconds

• Substreams declaration

  • SUBSTREAMS=720p 540p 360p 216p Name of substreams seperated by space.

  • 720p settings

    • SUBSTREAM_720p_BITRATE=4252000 Total bitrate of a substream, video and audio
    • SUBSTREAM_720p_VIDEO_SIZE=1280x720 Resolution of video
    • SUBSTREAM_720p_VIDEO_FPS=25 Frame rat eof video

  • 540p settings

    • SUBSTREAM_540p_BITRATE=2377000
    • SUBSTREAM_540p_VIDEO_SIZE=960x540
    • SUBSTREAM_540p_VIDEO_FPS=25

  • 360p settings

    • SUBSTREAM_360p_BITRATE=1063000
    • SUBSTREAM_360p_VIDEO_SIZE=640x360
    • SUBSTREAM_360p_VIDEO_FPS=25

  • 216p settings

    • SUBSTREAM_216p_BITRATE=420000
    • SUBSTREAM_216p_VIDEO_SIZE=384x216
    • SUBSTREAM_216p_VIDEO_FPS=25

• Video codec settings

  • VIDEO_PROFILE=baseline
  • VIDEO_LEVEL=3.1

• Audio codec settings

  • AUDIO_SAMPLING_RATE=44100
  • AUDIO_CHANNELS=2
  • AUDIO_BITRATE=96k

Build

make