mirror of https://gitlab.freedesktop.org/gstreamer/gst-plugins-rs.git synced 2024-11-26 21:41:03 +00:00

History

Sanchayan Maity 81437bb1c9 net/rusoto: Rename to aws Rename all the elements to use aws prefix now but still register a backwards compat element factory. Part-of: <https://gitlab.freedesktop.org/gstreamer/gst-plugins-rs/-/merge_requests/759>		2022-06-14 08:03:49 +00:00
..
src	net/rusoto: Rename to aws	2022-06-14 08:03:49 +00:00
build.rs	fix-getters-calls 0.3.0 pass	2021-04-20 18:19:58 +02:00
Cargo.toml	net/rusoto: Rename to aws	2022-06-14 08:03:49 +00:00
LICENSE-MPL-2.0	rusoto: Add missing license file	2022-01-16 14:15:29 +02:00
README.md	net/rusoto: Rename to aws	2022-06-14 08:03:49 +00:00

README.md

gst-plugin-s3

This is a GStreamer plugin to interact with Amazon Web Services. We currently have elements to interact with S3 and Transcribe.

AWS Credentials

AWS credentials are picked up using the mechanism described by AWS SDK. 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

s3sink

Writes data to a specified S3 (region, bucket, object, version?) tuple. The version may be omitted.

$ gst-launch-1.0 \
    videotestsrc ! \
    theoraenc ! \
    oggmux ! \
    s3sink uri=s3://us-west-1/example-bucket/my/file.ogv?version=my-optional-version

awstranscriber

Transcribes audio to text.