Publishing HLS streams from SyncWords Live to your AWS S3 bucket

Serving HLS video streams to an audience from your S3 bucket is a popular option. SyncWords can publish your HLS stream with added captions, subtitles and/or dubbed audio tracks to your S3 bucket.

You will need to add your S3 bucket information to your Service configuration in SyncWords Live and add an IAM policy to your bucket to allow secure publishing from SyncWords Live into your S3 bucket.

Follow these steps

1 - In the SyncWords Live application -

When configuring your Service, in the Output section, for HLS Output, you can set the Destination to 'S3 Bucket'. Specify your Bucket Name. You can optionally specify a Path.

2 - Ask the person who manages your AWS account to add an IAM policy to your bucket authorizing SyncWords Live to write to your S3 bucket, like this one - 

{
    "Version": "2012-10-17",
    "Id": "Policy1665095648101",
    "Statement": [
        {
            "Sid": "Stmt1665064401111",
            "Effect": "Allow",
            "Principal": {
                "AWS": "arn:aws:iam::710713970991:root"
            },
            "Action": [
                "s3:ListBucket",
                "s3:GetObject",
                "s3:PutObject",
                "s3:AbortMultipartUpload",
                "s3:DeleteObject"
            ],
            "Resource": [
                "arn:aws:s3:::my-s3-bucket-name",
                "arn:aws:s3:::my-s3-bucket-name/*"
            ]
        }
    ]
}

This policy does not manage public access to your stream on the S3 bucket. You can add a new Statement entry to the base policy, like the example below, making the bucket public so users are able to freely stream from it. Feel free to work with the adminstrator of your AWS account to omit or adjust permissions appropriate to your use case.

,
        {
            "Sid": "Stmt1665064401112",
            "Effect": "Allow",
            "Principal": "*",
            "Action": "s3:GetObject",
            "Resource": [
                "arn:aws:s3:::my-s3-bucket-name",
                "arn:aws:s3:::my-s3-bucket-name/*"
            ]
        }

Make sure to use your actual S3 bucket name(s) in this section. This can also be finetuned to grant access to specific subdirectory in the bucket. 

"Resource": [
                "arn:aws:s3:::my-s3-bucket-name",
                "arn:aws:s3:::my-s3-bucket-name/*"
            ]

With the IAM policy in place, you can start your Service and begin streaming with caps, subs and dubs from your S3 bucket.

These examples don't cover more advanced use cases that include Cloudfront distributions so make sure to work with your AWS administrator. Contact us if you need further help setting up HLS publishing from SyncWords Live to your AWS S3 buckets.