Storage setup

​

Amazon S3

1. Create a new S3 bucket with default setup and permissions.
2. Create a new IAM user.
3. Attach the PutObject permission for your bucket on the IAM user:
   1. Add an inline policy:
      
   2. Under Service, select S3.
   3. Under Actions:
      1. The following permissions need to be added to the bucket:
         • GetBucketLocation
      2. The following permissions need to be added to the folder of the bucket:
         • PutObject
         • PutObjectAcl
   4. Under Resources, select Specific, click on Add ARN, add your bucket name and your video folder name:
      
   5. Your final policy statement should look like this:
      {
      	"Version": "2012-10-17",
      	"Statement": [
      		{
      			"Sid": "Statement01",
      			"Effect": "Allow",
      			"Action": "s3:GetBucketLocation",
      			"Resource": "arn:aws:s3:::your-bucket"
      		},
      		{
      			"Sid": "Statement02",
      			"Effect": "Allow",
      			"Action": [
      				"s3:PutObject",
      				"s3:PutObjectAcl"
      			],
      			"Resource": "arn:aws:s3:::your-bucket/*"
      		}
      	]
      }
      
4. Generate an access key and secret for that user.
   1. When asked for a use case, select Other.
   The access key sent to Video downloader cannot include any non URI-escaped characters that may conflict with the upload_url parameter, such as / or @. If your key generated by AWS includes such characters, please regenerate your key.
5. Call Video downloader with the following sample parameters:

{
    "target": "youtube_video",
    "query": "PFRn5zKJTD8",
    "upload_url": "https://access_key:access_secret@s3.us-west-2.amazonaws.com/your-bucket/video-folder"
}

• access_key and access_secret are generated from step 4.
• us-west-2 is used as a sample region, your AWS region may be different.
• A /video-folder must be provided.
• If your secret contains +, URL-encode it as %2B.

​

Other S3-compatible providers

• MinIO
• Wasabi
• DigitalOcean Spaces
• Backblaze B2
• Scaleway Object Storage
• Linode Object Storage
• IBM Cloud Object Storage
• Oracle Cloud Object Storage
• Hetzner Cloud Storage
• Google Cloud Storage, with an HMAC key: https://<hmac_access_id>:<hmac_secret>@storage.googleapis.com/<bucket>/<folder>