gst-plugins-rs/net/rusoto
Guillaume Desmottes b9f8ce9995 meson: add support for static build
There is no way to dynamically ask Cargo to build static or dynamic lib
so we have to build both and pick the one we care when doing the meson
processing.

Fix #88
2020-11-16 15:30:32 +01:00
..
src net: Update for subclassing API changes 2020-11-15 18:25:42 +02:00
build.rs Fix various new clippy warnings with clippy 1.43 2020-04-24 13:55:01 +03:00
Cargo.toml meson: add support for static build 2020-11-16 15:30:32 +01:00
LICENSE-APACHE Add LICENSE files to each individual crate 2020-07-10 13:06:28 +03:00
LICENSE-MIT Add LICENSE files to each individual crate 2020-07-10 13:06:28 +03:00
README.md Drop gst-plugin- prefix in plugin directory name 2020-04-05 19:10:47 +00:00

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:

  1. Environment variables: AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY
  2. AWS credentials file. Usually located at ~/.aws/credentials.
  3. 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 bucket. The region parameter is optional, and if not specified, the default parameter will be used (from .aws/config file).

$ gst-launch-1.0 \
    videotestsrc ! \
    theoraenc ! \
    oggmux ! \
    s3sink bucket=example-bucket key=my/file.ogv region=us-west-1