Getting Started

Encore Transfer is an open source worker service from Eyevinn Technology that listens for completed SVT Encore transcoding jobs and transfers the output files to a destination — typically an S3-compatible object store or an OSC storage bucket. It is the final stage in a complete Encore-based transcoding pipeline. Available in Eyevinn Open Source Cloud.

Prerequisites

  • If you have not already done so, sign up for an OSC account.
  • A running SVT Encore instance for transcoding.
  • A Valkey instance to use as the job queue (shared with your Encore instance).
  • An OSC access token (available from Workspace Settings → API Tokens in the OSC dashboard).
  • A destination URL for the transferred files (S3 bucket or OSC storage).

Step 1: Store credentials as secrets

Navigate to the Encore Transfer service, open the Service Secrets tab, and create secrets for any sensitive values:

  • oscat — your OSC access token
  • awsaccesskeyid — AWS S3 access key ID (if transferring to AWS S3)
  • awssecretaccesskey — AWS S3 secret access key (if transferring to AWS S3)

Step 2: Create a Valkey queue instance

If you do not already have a Valkey instance shared with your Encore deployment, create one:

  1. Navigate to the Valkey service.
  2. Click Create valkey and enter a name (e.g., encorequeue).
  3. Wait for the instance to reach Running status.
  4. Note the External IP and External Port to construct the Redis URL: redis://<IP>:<PORT>.

Step 3: Create the Encore Transfer instance

Click Create encore-transfer and fill in:

Field Description Example
Name Name for this worker instance my-transfer
RedisUrl Redis URL for the shared Encore job queue redis://172.232.131.169:12345
RedisQueue Queue name (optional, defaults to the Encore default queue) encore-jobs
Output Destination URL for transferred files s3://my-bucket/output/
OscAccessToken OSC access token {{secrets.oscat}}
AwsAccessKeyIdSecret S3 access key ID (optional) {{secrets.awsaccesskeyid}}
AwsSecretAccessKeySecret S3 secret access key (optional) {{secrets.awssecretaccesskey}}

Click Create and the worker will start listening for completed Encore jobs on the queue.

CLI Usage

npx -y @osaas/cli create eyevinn-encore-transfer my-transfer \
  -o RedisUrl="redis://172.232.131.169:12345" \
  -o Output="s3://my-bucket/output/" \
  -o OscAccessToken="{{secrets.oscat}}" \
  -o AwsAccessKeyIdSecret="{{secrets.awsaccesskeyid}}" \
  -o AwsSecretAccessKeySecret="{{secrets.awssecretaccesskey}}"

Transcoding Pipeline Overview

A complete Encore pipeline in OSC consists of:

  1. SVT Encore — transcodes video according to a profile
  2. Valkey — Redis-compatible queue connecting Encore to downstream workers
  3. Encore Transfer — picks up completed jobs and moves output files to storage
  4. Encore Packager (optional) — packages transcoded files into HLS/DASH adaptive bitrate streams

Resources