mats16/bcast repository overview

⁠Amazon Chime Meeting Broadcast Demo

This repository contains a Docker container that, when started, will join an Amazon Chime meeting by PIN and broadcast the meeting's audio and video in high definition (1080p at 30fps) to an RTMP endpoint you specify. The broadcast participant joins the meeting in the muted state. The meeting PIN must be unlocked in order for the broadcast participant to join the meeting.

⁠Prerequisites

You will need Docker and make installed on your system. As this container is running a Firefox browser instance and transcoding audio and video in real time, it is recommended to use a host system with at least 8GB RAM and 4 CPU cores, such as an m5.xlarge EC2 instance running Ubuntu Linux 18.04 LTS.

⁠Configuration

The input for the container is a file called container.env. You create this file by copying the container.env.template to container.env and filling in the following variables:

• SRC_URL: Chime Meeting URL (without any spaces in it)
  • Example(If you want to record Chime): https://app.chime.aws/portal/<your Meeting PIN here>
  • Example(Hosted Chime SDK Demo URL): <Hosted Chime URL>/?m=<Meeting ID>&record=true
• DST_URL: the URL of the RTMP endpoint or S3 bucket,
  • Twitch example: rtmp://live.twitch.tv/app/<stream key>
  • YouTube Live example: rtmp://a.rtmp.youtube.com/live2/<stream key>
  • S3 example: s3://<Bucket Name>/<Prefix>/<Key>.mp4

⁠Other parameters

• MEETING_PIN: You can use this param instead of SRC_URL.

• SCREEN_WIDTH

  • Default: 1920

• SCREEN_HEIGHT

  • Default: 1080

• COLOR_DEPTH

  • Default: 24

• VIDEO_BITRATE

  • Default: 4500k

• VIDEO_FRAMERATE

  • Default: 30

• AUDIO_CODEC

  • Default: aac
  • You can use flac, but flac in MP4 support is experimental.

• AUDIO_BITRATE

  • Default: 128k

• AUDIO_SAMPLERATE

  • Default: 44100

• AUDIO_CHANNELS

  • Default: 2

• AUDIO_DELAYS: You need to adjust according to the environment.

  • Default: 1800

• THREAD_NUM: 4 CPU cores is assumed.

  • Default: 4

⁠Running

To build the Docker image, run:

$ make

Once you have configured the container.env file, run the container:

$ make run

The container will start up and join the given Amazon Chime meeting as the <Broadcast> attendee and start streaming H.264/AAC in FLV format to the given RTMP endpoint.

When your broadcast has finished, stop the stream by killing the container:

$ docker kill bcast

If you launched an EC2 instance to host the Docker container, you may also want to stop the instance to avoid incurring cost.