Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

label

key

description

Library Name

name

display name of the library in the application

Library Root

root

set the root location for the library data
Set individual paths for each operating system

If you move your library data to another location, you only have to update this value and everything should be linked correctly

Database File

database_path

database that contains a data for this library
Set individual paths for each operating system

Template mapping

template_mapping

link the transcoding templates to the specific template types

main: main template for the library element (required)
thumbnail: preview of the element (required)
filmstrip: quick preview for movie/sequence files (recommended for movie/sequences)

Values

values

Patterns

patterns

path patterns that you want to add/overwrite

Transcoding templates

templates

templates for different tasks (transcoding, copy …)

Path Patterns

Here you can overwrite path patterns from the global section. You can also add new ones.

Path Values

Here you can overwrite the custom values from the global section. You also can add new ones.

Tip

Tip:
Add a path value called facility in the global section.
Add the custom value somewhere in the path pattern.

This way you can share the same folder structure and naming convention for all the libraries between all the sites. Here in the library section you overwrite the value with the name of your facility. This way you could sync the libraries between all your sites but still separating them into different folders.

Some companies use the IATA airport code to differentiate between their facilities.

Transcoding Templates

Create transcoding templates for managing tasks like copying a file, generate proxy formats or run a custom command.

Path Patterns & Values

Again, you can overwrite values and patterns from the library section. You can also add new ones.

...

  • finally the transcoding values (will overwrite both global and library values)

Transcoding Tasks

Define your transcoding task here.

...

task

description

NoOp

no operation, do nothing
This can be useful if you already created all your proxy files, but you still want to register the file paths in the database.

Copy File

Copies from the source path to the output path

Filmstrip

Creates a filmstrip with a certain amount of frames for a sequence. This task will only run for movie files and a sequence of images

frames: define how many frames the filmstrip contains (default: 24)
height: height in pixels (default: 270)

The width of the filmstrip is calculated based on the given parameters. Every frame has a fixed pixel aspect ratio of 16:9

Thumbnail

Create a thumbnail

width: width in pixels (default: 480)
height: height in pixels (default: 270)

To define which frame to use as the thumbnail frame: Settings → Global → Thumbnail Frame of Sequence

FFmpeg

use FFmpeg to transcode the source file(s)
There are several predefined FFmpeg presets

More comprehensive documentation will follow.

Custom Command

Run your custom command

For example:

exec C:/python.exe
params C:/my_script.py <source.path>

Custom Command Examples

Info

The custom command can be useful to send render jobs to you render farm

...

You can access all Path Pattern and Path values by adding the <> (less-than sign) around them.

Examples

<source.path>

path to the source file
/some/path/to/my_file_sequence.1001.exr

<source.name>

name of file with frame padding
my_file_sequence.%04d.exr

<source.basename>

base name of the file without extension and frame padding
my_file_sequence

<source.extension>

source path file extension
exr