This document will show how to set up transcodes using the CatDV Worker to control Telestream Episode 6.

Sometimes you might want to use a third party transcoding tool rather than CatDV’s in-built functions. CatDV Worker can automate this process to support more complex workflows. For example, CatDV Worker can watch for new footage arriving in a location (for example a card from a shoot arriving on the network), set off a copy to the SAN, a transcode to a mezzanine format and the creation of a web proxy.

This document will cover the creation of a mezzanine proxy and a web proxy using Episode .

Episode Engine integration with CatDV is via the Episode Command Line Interface (CLI) which is available here.

1. Set up Episode Tasks for the required Transcodes

In Episode, create a new encoder (Press the New Encoder button in the tool bar) for the mezzanine format and give the encoder a name. In this case we are using an MXF Op1a container with AVC Intra 50 video codec and 16 bit AES audio.

Episode1-650

Now create another new encoder for the web proxy format. In this case an H264 .mov

Episode2-650

You can test your encoders by making simple Episode workflows (supply an input file as a ‘Source’ and as a ‘Deployment’ use the same folder as the source.

When you are happy with the encoders, we need to find the transcode tasks in the file system:

On mac these are typically at:

~/Library/Application Support/Episode/User Tasks/Encoders/

on Windows

C:\ProgramData\Telestream\Episode 6\User Tasks\Encoders\

Note the path to the encoders created above, we’ll need them to use in the Worker later. (in this case:

CatDV Mezzanine Transcode.epitask and CatDV Web Proxy Transcode.epitask

 

2. Set up the CatDV Worker to watch for incoming media

Create a new job in the CatDV Worker. Press ‘Edit Config’ then ‘+’ to create a new job.

Onthe ‘Trigger’ tab, give the job a suitable name, set the trigger to be ‘File’ , check ‘Enable Watch Folder’, choose where to watch on the network as below

Episode3-650

On the Conditions tab choose the kind of incoming media we want to transcode (ie just media files)

Episode4-650

3. Set up CatDV Worker to transcode with Episode 6

In the Worker job’s ‘Conversion’ tab use the Episode Command Line to kick off a transcode:

  • We are calling the Command Line Interface
  •  Episode 6
    • OSX: /Applications/Episode.app/Contents/MacOS/engine/bin/episodectl
    • Windows: C:\Program Files\Telestream\Episode 6\bin\episodectl.exe
  • Episode 6.5 default location is
    • OSX: /Applications/Episode.app/Contents/Resources/engine/bin/episodectl
    • Windows: C:\Program Files (x86)\Telestream\Episode 6\bin
  • telling to perform a workflow: workflow submit
  • with our input file: –file $i passes the input file seen in the watch folder
  • using our new encoder: “~/Library/Application Support/Episode/User Tasks/Encoders/CatDV Mezzanine Transcode.epitask”
  • putting the resulting file in our chosen destination, in our case :–destination “~/CatDV Transcode Folder/”
  • telling Episode to wait until the transcode is done until it returns (so the worker Task Queue accurately shows what transcodes are finished)

On mac the full command line is:

/Applications/Episode.app/Contents/MacOS/engine/bin/episodectl workflow submit --file $i --encoder "~/Library/Application Support/Episode/User Tasks/Encoders/CatDV Mezzanine Transcode.epitask" --destination "~/CatDV Mezzanine Folder/" --wait

on Windows

C:\Program Files (x86)\Telestream\Episode 6\bin\episodectl.exe workflow submit --file $i --encoder "C:\Users\"USERNAME"\Documents\Episode 6\Tasks\Encodings\CatDV Mezzanine Transcode.epitask" --destination "C:\CatDV Mezzanine Folder\" --wait

We can also kick off a transcode to a Web Proxy at the same time (using the execute command 2 field. This assumes Episode is licensed to perform 2 jobs simultaneously.

On OSX

/Applications/Episode.app/Contents/MacOS/engine/bin/episodectl workflow submit --file $i --encoder "~/Library/Application Support/Episode/User Tasks/Encoders/CatDV Web Proxy Transcode.epitask" --destination "~/CatDV Web Proxy Folder/" --wait

on Windows

C:\Program Files (x86)\Telestream\Episode 6\bin\episodectl.exe workflow submit --file $i --encoder "C:\Users\"USERNAME"\Documents\Episode 6\Tasks\Encodings\CatDV Web Proxy Transcode.epitask" --destination "C:\CatDV Mezzanine Folder\" --wait

Episode5-650

4. Testing and Monitoring Episode Jobs

That’s it, you should now test your Worker Action. Detailed status can be monitored using the status viewer in Episode (Window – Show Status…), which will also show any Episode errors if media fails to encode.

5. Working with Episode cluster

CatDV can send jobs to an Episode Cluster by adding the “–cluster ” option to the command lines above.

This walkthrough is based on Episode Pro 6.4.1.11, and applies to Episode, Episode Pro and Episode Engine.

6. Troubleshooting

There is more information on Troubleshooting Worker actions that use the Execute Command capability here.