[JIM] Add a new Metadata Set v.5.5

This page provides an overview of the steps needed to create a new Metadata Preset from compiling both “StartUpXML” and “ExportXML” files to creating a Destination Preset with Metadata Path and recording.

StartUpXML

Let’s start with creating the “StartUpXML” file, which describes the actual structure of the available elements in the Channel Inspector. You can use different element types. In this example we will only use a Selection box.

Create a new XML file in your text editor of choice. Then add an XML root element, which is necessary for every just:in mac StartUpXML file:

<metadataSet></metadataSet>

Now we can add our first element. Let’s start with a Selection box, where the operator should be able to choose between different items. The structure looks like this in the “StartUpXML” file. Please note the “<name>” tag of that element, as you will need it for the ExportXML later.

<metadataSet>
    <control>
        <name>number</name>
        <label>Numbers</label>
        <type class="Selection">
            <item>One</item>
            <item>Two</item>
            <item>Three</item>
            <item>Four</item>
        </type>
    </control>
</metadataSet>

This element looks like this in the Channel Inspector. A simple Selection box with four items.

In the next step, we have to ensure that the ExportXML matches the wanted values of the StartUpXML.

ExportXML

Create a new XML file in your text editor of choice. Then create your required XML structure. Lastly, connect your elements from the StartUpXML with a “%”-sign and the corresponding <name> tag. In our StartUpXML example above, the Selection box element had the following name tag:

<name>number</name>

Therefore, we can use “%number” in our ExportXML file to reference this element. This looks like that:

The XML attribute “name="%Just_In_Clipname" - refers to an internal variable, which can be used to insert channel-specific variables into the ExportXML file.

Now, let’s build a new Metadata Preset with XMLs, we’ve just created.

Metadata Preset

Open Just Control, then open the Just Control Configuration Panel and switch to the Metadata Sets tab. Press the “+” button to create a new Preset, adjust the name, and choose the StartUpXML and ExportXML files. Press the “Create” button to complete that process.

Next, let’s create a new Destination Preset with a Metadata Path.

Destination Preset

To export metadata at the start (or the end) of a recording, we will need a new Destination Preset with a dedicated Metadata path. Again, open the Just Control Configuration panel, switch to the “Destination Preset” tab, and create a new preset. Note that you need two Container paths here, one for the High-res file (“Main Container”) and one for the metadata export (“Metadata Container”).

Channel Inspector and Recording

Once this has been completed, open Just Control and select a Channel. Within the Inspector select the new Metadata Preset, select if you want to write the metadata file at the “Start” or the “End” of a recording (“Write at…”), adjust the contents of the element(s), and start recording. After the recording has ended, you should see the ExportXML file at your location of choice, which should look similar to this.

Please note that you can add as many elements in your StartUpXML and in any combination that you want. There are no limits whatsoever, that may affect the metadata processing. If you have questions or need help with the steps above, please do not hesitate to contact us.

ToolsOnAir User Guide Central