SFTP Ingestion
SFTP enables secure content transfer to Frequency's backend storage by setting up dedicated storage space and a transfer protocol.
Deliverables
Frequency Studio supports Secure File Transfer Protocol (SFTP) for content delivery, which you can learn more about here. Please deliver the following to your account manager:
Deliverable | Deliverable | Example |
|---|---|---|
SSH Public Key | SSH public key - Frequency will provide username/host. | P2JV5wbl3xjQ1R0fuVla |
Video assets | Prepare video assets to be ingested.
| movie.mp4 |
Image assets | Provide an image to represent the video asset.
| thumbnail.jpg |
Metadata file | Create a .csv file containing required and optional metadata for linking assets. Required metadata:
For optional metadata fields, please see the attached manifest, and refer to Metadata Definitions. |
Credentials Setup
Generate a SSH Key
Windows: Use PuTTYgen to create an SSH key pair in the appropriate format.
MacOS/Linux: Open Terminal and use the command:
ssh-keygen -P "" -f transfer-key
Locate the generated SSH files and retrieve the SSH Public Key (transfer-key.pub). Send this to Frequency to use to administer a new user.
The SSH Public Key looks like this:
ssh-rsa AAAAB3NzaC................................h2rkp8Uh gotfrank@Franks-MBP-WiFi.local
Frequency will generate and set up a new username.
Uploading Files
Using a SFTP client such as Cyberduck (Windows or MacOS), connect with SFTP to:
Host: sftp.frequency.com
User: Your provided username
SSH Private Key: Your SSH Private Key file
Upload your video, artwork, and/or subtitles files
You can use the root/base folder or put them into separate folders as you wish, as long as they're referenced as relative path in the Metadata Manifest File for the media files.
Asset specifications must meet Frequency's minimum requirements
Upload Metadata Manifest File
You must upload a manifest file in CSV format (e.g.: metadata.csv) that describes your content uploaded. Refer to this template and example for the correct field and field values.
The only required fields are video_file and image_file (both must be of 16:9 aspect ratio and at least 720p resolution). These fields must match the file names in the folder otherwise this may cause issues with ingestion.
You must update this manifest file after you have confirmed that all associated assets have been uploaded successfully, otherwise this may cause issues with ingestion.
In the future, you can overwrite this file with new information when necessary
CSV Example
Live Google Sheet Example
https://docs.google.com/spreadsheets/d/1e4tZyBEIxnE1236mIT7dPpe7SUQ3gaYnT1YQgmrscUk
Best Practices
Upload your metadata.csv after all assets have been fully uploaded
Ensure valid data without line breaks.
Verify correct file paths and case-sensitive filenames.
Automated Ingestion
Frequency will periodically check the metadata manifest file for new videos to ingest. Successfully ingested videos will appear in the MANAGE tool.
File Name Convention
Asset names must adhere to S3's Object key and metadata rules. Keep asset names within 1,024 bytes and use safe characters.
Safe characters
Please ensure your file names only use the following safe characters:
Alphanumeric characters |
|
Special characters |
|