Skip to content

Eyevinn/hls-copy-s3

Repository files navigation

HLS Copy to S3

Script to download full HLS package and copy to an S3 bucket.

npm github release license

PRs welcome made with hearth by Eyevinn Slack

Badge OSC

Download full HLS package (playlists and media chunks) and upload contents to an S3 bucket.

Requirements

  • AWS S3 CLI
  • NodeJS 18+

Installation / Usage

Options can be provided either as command line options or environment variables.

% npx @eyevinn/hls-copy-s3 \
  --dest-endpoint=<dest-endpoint> \
  --dest-access-key=<dest-access-key> \
  --dest-secret-key=<dest-secret-key> \
  https://lab.cdn.eyevinn.technology/osc/VINN-10/339bd6f7-5db1-4faf-9b95-eb5c90f017f5/index.m3u8 s3://test/files/

Using environment variables stored in a file called .env in this example:

DEST_ENDPOINT=<dest-endpoint>
DEST_ACCESS_KEY=<dest-access-key>
DEST_SECRET_KEY=<dest-secret-key>
% set -a ; source .env ; set +a
% npx @eyevinn/hls-copy-s3 https://lab.cdn.eyevinn.technology/osc/VINN-10/339bd6f7-5db1-4faf-9b95-eb5c90f017f5/index.m3u8 s3://test/files/

Eyevinn Open Source Cloud

Also available as an open web service in Eyevinn Open Source Cloud. This enables you to transfer HLS directly to an S3 bucket without having to go through your local computer first. Read this documentation for usage instructions.

Development

% npm install
% set -a ; source .env ; set +a
% npm start -- https://lab.cdn.eyevinn.technology/osc/VINN-10/339bd6f7-5db1-4faf-9b95-eb5c90f017f5/index.m3u8 s3://dest/files/

Contributing

See CONTRIBUTING

License

This project is licensed under the MIT License, see LICENSE.

Support

Join our community on Slack where you can post any questions regarding any of our open source projects. Eyevinn's consulting business can also offer you:

  • Further development of this component
  • Customization and integration of this component into your platform
  • Support and maintenance agreement

Contact [email protected] if you are interested.

About Eyevinn Technology

Eyevinn Technology is an independent consultant firm specialized in video and streaming. Independent in a way that we are not commercially tied to any platform or technology vendor. As our way to innovate and push the industry forward we develop proof-of-concepts and tools. The things we learn and the code we write we share with the industry in blogs and by open sourcing the code we have written.

Want to know more about Eyevinn and how it is to work here. Contact us at [email protected]!