31a53bba8a
Which will automatically be integrated in gstreamer documentation |
||
---|---|---|
.. | ||
src | ||
build.rs | ||
Cargo.toml | ||
LICENSE-MPL-2.0 | ||
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
andAWS_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
s3hlssink
Writes a single variant HLS stream directly to a specified S3 (region, bucket,
path prefix) tuple. Takes the encoded audio and video stream as input, and uses
hlssink3
if available, else hlssink2
. HLS stream parameters such as
playlist length, segment duration, etc. can be tweaked by accesing the
underlying sink using the hlssink
property.
awstranscriber
Transcribes audio to text.