Versions Compared

Key

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

This tutorial will show you how you can the software with your existing library.toc

Using presets

The simplest way to setup a library based on an existing library structure is to use the provided preset. The preset Preserve original structure will leave all existing file untouched and create a folder .proxies in the root library location. All proxies will be rendered into this folder.

...

  1. Create new config

...

  1. choose config preset: Preserve original structure

...

  1. create a new library

...

  1. the Library Root needs to point to the folder of the existing library

...

  1. choose library preset: Preserve original structure

...

  1. that’s it - now you can start ingesting the existing files. It will keep the source file untouched and render proxy filels into the .proxies folder

...

Note

The easiest way is to use the preset, as mentioned above. Everything that follows below is the older and manual approach. Keep reading if you want to learn more about the concept of an existing library setup.

Setup manually


In previous version you needed to setup an existing library manually. This guide will show explain the concept how to setup an existing library from a blank setup.


In this example we assume that you have already did setup a folder structure and naming convention for your existing elements. But now we will create proxy files for a faster preview. The software needs these proxy files in order to work correctly.

...

Let’s create the two path values we will need.

key

value

extension

<source.extension>

proxy_type

(no value, this will be blank for now)

...

Path Patterns

In this tutorial the proxy files will be placed in a folder in the same location where the main element is stored. We will create a folder called proxy and the proxy files will be created in yet another sub-folder depending on the proxy type.

...


Set these values for the Path Patterns:

key

value

base_path

<source.directory>/proxies/<source.basename>/<proxy_type>/<source.basename>_<proxy_type>

path_file

<base_path>.<extension>

path_sequence

<base_path>.<frame>.<extension>

Info

If you want to go up one directory, simply use two dots '/../' in your file path.

Example to place the proxy folders next to the source file folder:
<source.directory>/../proxies/

...

All that’s let to do in the global settings in to set the file path definitions.
For a single file we use path_file from the path patterns and for a sequence of file we use path_sequence.

value

<path_file>

<path_sequence>

...

Now the global settings should look like this:

...

For the main template we will overwrite the path patterns path_file and path_sequence with the file path to the element. This will register the file path to the database for the mail elements.

key

value

path_file

<source.path>

path_sequence

<source.path>


The important part here is to choose the transcoding task: NoOp (do nothing)
Since we don’t want anything to happen with the mail elements, we still have to register the file path to the database in order for the software to know what that file path is.

...

For the thumbnail we have to overwrite the two path values.

key

value

extension

jpg

proxy_type

thumbnail

Info

It there are other path values, please make sure to remove them.

...

For the filmstrip we again will overwrite the two path values similar to the thumbnail.

key

value

extension

jpg

proxy_type

filmstrip

...

proxy movie

And one last time, overwrite the path values.

key

value

extension

mov

proxy_type

proxy

...

Conclusion

Now you will be able to keep your existing files and still create proxy files. Of course you are free to change the folder structure for the proxy files any way you like.

...