mirror of https://gitlab.freedesktop.org/gstreamer/gst-plugins-rs.git synced 2024-06-18 06:00:33 +00:00

History

Guillaume Desmottes 53e530f7db port all plugins to new register API Rank is now an enum rather than a u32		2019-06-04 14:35:10 +05:30
..
src	port all plugins to new register API	2019-06-04 14:35:10 +05:30
build.rs	Add build.rs that provides a version number, release date and other details	2019-06-03 11:11:29 +00:00
Cargo.toml	Add build.rs that provides a version number, release date and other details	2019-06-03 11:11:29 +00:00
README.md	Add a plugin to read data from Amazon S3	2019-05-25 16:57:39 +02:00

README.md

gst-plugin-s3

This is a GStreamer plugin to interact with the Amazon Simple Storage Service (S3).

Currently, a simple source element exists. The eventual plan is to also add a sink, to allow writing out objects directly to S3.

AWS Credentials

AWS credentials are picked up using the mechanism that rusoto's ChainProvider uses. At the moment, that is:

Environment variables: AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY
AWS credentials file. Usually located at ~/.aws/credentials.
IAM instance profile. Will only work if running on an EC2 instance with an instance profile/role.

An example credentials file might look like:

[default]
aws_access_key_id = ...
aws_secret_access_key = ...

s3src

Reads from a given S3 (region, bucket, object, version?) tuple. The version may be omitted, in which case the default behaviour of fetching the latest version applies.

$ gst-launch-1.0 \
    s3src uri=s3://ap-south-1/my-bucket/my-object-key/which-can-have-slashes?version=my-optional-version !
    filesink name=my-object.out