• Input Details, Part 1 (p. 20)
• Input Details, Part 2, Clip and Caption Settings (p. 22)
• Output Details, Part 1 (p. 24)
• Output Details, Part 2 (p. 26)
• Output Details, Part 3, Caption Settings (p. 27)
• (Optional) Output Encryption (p. 28)
• (Video/Thumbnails Only) Watermarks (p. 30)
• (FLAC/MP3/MP4 Only) Album Art (p. 31)
• (Optional) User Metadata (p. 34)
• (Fragmented MP4/MPEG-TS Outputs Only) Playlist (p. 35)
• (Fragmented MP4/MPEG-TS Outputs Only, Optional) HLS Content Protection (p. 36)
• (HLSv3 and Smooth Playlists Only, Optional) Digital Rights Management (p. 38)
Region
Elastic Transcoder creates your job in the region you are in.
General Settings
Pipeline
The name of the pipeline that you want Elastic Transcoder to use for transcoding. The pipeline determines several settings, including the Amazon S3 bucket from which Elastic Transcoder gets the files to transcode and the bucket into which Elastic Transcoder puts the transcoded files.
Output Key Prefix
The value, if any, that you want Elastic Transcoder to prepend to the names of all files that this job creates, including output files, thumbnails, and playlists. If you specify a value, it must contain a / somewhere after the first character, which simplifies Amazon S3 file management.
Input Details, Part 1
Use the settings in this section to specify information about the input files. If you provide more than one input file, Elastic Transcoder transcodes them and then stitches them together into one output file. For more information, see Clip Stitching (p. 86).
Input Key
The name of the files that you want to transcode. To determine from which Amazon S3 bucket to get the file, Elastic Transcoder refers to the Input Bucket field in the pipeline that you specified for this job.
If a file name includes a prefix—for example, cooking/lasagna.mpg—include the prefix in the key.
If the file isn't in the specified bucket, Elastic Transcoder returns an error.
Input Decryption
The encryption settings, if any, that are used for decrypting your input files. If your input file is encrypted, you must specify the mode that Elastic Transcoder will use to decrypt your file.
Decryption Mode (Required for Decryption)
The specific encryption mode that you want Elastic Transcoder to use when decrypting your files.
Elastic Transcoder supports the following options:
• Amazon S3 Server-Side Encryption: Amazon S3 handles the encryption and decryption of your files. As long as Elastic Transcoder has access permissions to your Amazon S3 bucket, you don't need to take any action.
For more information, see Protecting Data Using Server-Side Encryption in the Amazon Simple Storage Service User Guide.
• Client-Side Encryption Using Customer-Provided Keys: Elastic Transcoder supports three types of encryption using customer-provided keys:
• aes-cbc-pkcs7: A padded cipher-block mode of operation.
• aes-ctr: AES Counter Mode.
• aes-gcm: AES Galois Counter Mode, a mode of operation that is an authenticated encryption format, meaning that a file, key, or initialization vector that has been tampered with will fail the decryption process.
If you chose one of the AES-encryption modes, you must also specify the following three values (all three must be base64-encoded):
• Encryption Key
• Encryption Key MD5
• Encryption Initialization Vector Decryption Key (Required for AES Decryption)
The data encryption key used to encrypt your file. The key must be base64-encoded and it must be one of the following bit lengths before being base64-encoded:
96 (AES-GCM only), 128, 192, or 256.
The key must also be encrypted by using AWS KMS. For more information, see Encrypting and Decrypting Data in the AWS Key Management Service Developer Guide.
Decryption Key MD5 (Required for AES Decryption)
The MD5 digest of the key used to encrypt your input file, and that you want Elastic Transcoder to use as a checksum to make sure your key was not corrupted in transit. The key MD5 must be base64-encoded, and it must be exactly 16 bytes before being base64-encoded.
Decryption Initialization Vector (Required for AES Decryption)
The series of random bits created by a random bit generator, unique for every encryption operation, that you used to encrypt your input files. The initialization vector must be base64-encoded, and it must be exactly 16 bytes before being base64-encoded.
For more information, go to Initialization Vector.
Input Details, Part 2, Clip and Caption Settings
Use the settings in this section to specify information about clips and captions for the input files. These settings are available only when you provide multiple inputs.
For more information on captions, see Captions (p. 87) (Optional) Clip Start Time
You can create an output file that contains an excerpt from the input file. Clip Start Time indicates the place in the input file where you want a clip to start. The format can be either HH:mm:ss.SSS (maximum value: 23:59:59.999; SSS is thousandths of a second) or sssss.SSS (maximum value:
86399.999). If you don't specify a value, Elastic Transcoder starts at the beginning of the input file.
(Optional) Clip Duration
The duration of your excerpt clip. The format can be either HH:mm:ss.SSS (maximum value:
23:59:59.999; SSS is thousandths of a second) or sssss.SSS (maximum value: 86399.999). If you don't specify a value, Elastic Transcoder clips from Clip Start Time to the end of the file.
If you specify a value longer than the duration of the input file, Elastic Transcoder transcodes from Clip Start Time to the end of the file and returns a warning message.
(Video Only) Captions Merge Policy
A policy that determines how Elastic Transcoder handles the existence of multiple captions.
• MergeOverride: Elastic Transcoder transcodes both embedded and sidecar captions into outputs.
If captions for a language are embedded in the input file and also appear in a sidecar file, Elastic Transcoder uses the sidecar captions and ignores the embedded captions for that language.
• MergeRetain: Elastic Transcoder transcodes both embedded and sidecar captions into outputs.
If captions for a language are embedded in the input file and also appear in a sidecar file, Elastic Transcoder uses the embedded captions and ignores the sidecar captions for that language. If Caption Source is empty, Elastic Transcoder omits all sidecar captions from the output files.
• Override: Elastic Transcoder transcodes only the sidecar captions that you specify in Caption Source.
(Video Only, Optional) Input Key
The name of the sidecar caption file that you want Elastic Transcoder to transcode and include with the outputs.
(Video Only) Language
A string that specifies the language of the caption in one of the following formats:
• 2-character ISO 639-1 code, for example, en for English
• 3-character ISO 639-2 code, for example, eng for English
For more information on ISO language codes, see List of ISO 639-1 codes.
(Video Only, Optional) TimeOffset
For clip generation or captions that do not start at the same time as the associated video file, the TimeOffset tells Elastic Transcoder how much of the video to encode before including captions.
Specify the TimeOffset in the form [+-]SS.sss or [+-]HH:mm:SS.ss.
(Video Only, Optional) Label
The label of the caption shown in the player when choosing a language. We recommend that you put the caption language name here, in the language of the captions.