Hedge
Search…
Source Review
Hedge's Source Review feature allows you to enforce a custom offload workflow with predefined organization settings and metadata requirements.
Source Review is a paid add-on. Email [email protected] to access this feature.

Source Review

When Source Review is activated, adding a Source will trigger a pop-up form. Select a preset, review/add metadata, and confirm your transfer settings.
Next, click [OK] to exit Source Review, then [Add Transfers].

Logging

By default, the preset's name and all other metadata defined in the Source Review are logged in the Transfer Log and Media Hash List.
1
Transfer Log example:
2
---------------------
3
4
Hedge 21.2.2 (1123) - macOS 11.5.2
5
6
Source: /Untitled
7
Destination: /T1/PRX/2021-09-09/NY/A0001
8
9
Preset: Production X - CAM A
10
Project Name: PRX
11
Date: 2021-09-09
12
Location: NY
13
Reel: 0001
14
Preset ID: 0293840293
15
16
...
17
18
-- Transferred files --
19
#3: Clip0001.MXF
20
Path: PRX_2021-09-09_NY_0001_201907241633_000001.MXF
21
Size: 25491504 bytes
22
23
...
Copied!
1
Media Hash List example:
2
------------------------
3
4
<?xml version="1.0" encoding="UTF-8"?>
5
<hashlist version="1.1">
6
<hedge>
7
<rootPath>/Users/hedge</rootPath>
8
<info></info>
9
</hedge>
10
<sourceInfo preset="Production X - CAM A">
11
<sourceinfofield name="Project Name">PRX</sourceinfofield>
12
<sourceinfofield name="Date">2021-09-09</sourceinfofield>
13
<sourceinfofield name="Location">NY</sourceinfofield>
14
<sourceinfofield name="Reel">0001</sourceinfofield>
15
<sourceinfofield name="Preset ID">0293840293</sourceinfofield>
16
</sourceInfo>
17
18
...
19
20
<hash>
21
<file>PRX_2021-09-09_NY_0001_201907241633_000001.MXF</file>
22
<size>25491504</size>
23
<lastmodificationdate>2019-07-24T14:13:01Z</lastmodificationdate>
24
<xxhash64be>ca1a5aa7804b9f62</xxhash64be>
25
<xxhash64>629f4b80a75a1aca</xxhash64>
26
<hashdate>2021-09-09T16:43:38Z</hashdate>
27
</hash>
28
29
...
Copied!

Sidecar Creation for iconik

Hedge can also create Iconik sidecar files that add metadata to media while uploading to iconik.
Sidecar Creation for iconik is a paid add-on. Email [email protected] to enable this feature on your Hedge license.
Iconik Sidecar settings
Name
Type
Required
Description and example
iconikSidecarElements
Array
yes
metadata elements that should end up in the sidecar file e.g. ["{Project}", "{Location}"]
Example:
1
"iconikSidecarElements": ["{Project}", "{Location}"]
Copied!
1
Iconik sidecar JSON:
2
---------------
3
4
{
5
"metadata_values" : {
6
"Project" : {
7
"field_values" : [
8
{
9
"value" : "Project X"
10
}
11
]
12
},
13
"Location" : {
14
"field_values" : [
15
{
16
"value" : "NY"
17
}
18
]
19
}
20
}
21
}
Copied!

Source Review Presets

You can create a Hedge preset with Source Review elements by:
  1. 1.
    Using our Preset Builder.
  2. 2.
    Downloading the example JSON below, then editing it in a text editor.
Production X - CAM A.hedge
1KB
Binary
Example
To install the preset, double-click the .hedge file. Hedge will launch, then install it in ~/Library/Preferences/Hedge/Presets/.
Source Review is a paid add-on. Email [email protected] to access this feature.

Source Review Elements

The sourceReviewElements array contains all fields which appear in the Source Review form.
1
"sourceReviewElements": [
2
{ "name": "{Project Name}", "type": "text", "defaultValue": "" },
3
{ "name": "{Project ID}", "type": "text", "defaultValue": "" },
4
]
Copied!
Element properties
Name
Required
Description
name
yes
The display name of the form element. Must be unique and enclosed in curly brackets { }.
type
yes
The type of the form element. text,date, select, counter or hidden.
defaultValue
yes
The default value of the form element.
value
no
Holds the value that has been entered in the form.
options
required for select elements
An array of select objects.
Element types
There are five Source Review Element types:
Type
Description
text
A normal text input field.
date
A date picker. Uses the Language & Region set in System Preferences. To use a different format in labelPattern , renamePattern or folderPattern use {YYYY},{MM} and {DD} elements.
select
A dropdown with multiple values.
counter
A text input field with a number that auto increments every time the preset is used.
hidden
A hidden field that does not show up in the form.
1
"sourceReviewElements" : [
2
{ "name" : "{Project Name}", "type" : "text", "defaultValue" : ""},
3
{ "name" : "{Date}", "type": "date", "defaultValue" : ""},
4
{ "name" : "{Location}", "type" : "select", "defaultValue" : "",
5
"options" : [
6
{ "name" : "", "value" : "" },
7
{ "name" : "Adam", "value" : "Adam" },
8
{ "name" : "Rome", "value" : "Rome" }
9
]
10
},
11
{ "name" : "{Reel}", "type" : "counter", "defaultValue" : "0001" },
12
{ "name" : "{Preset ID}", "type" : "hidden", "defaultValue" : "0293840293" }
13
],
Copied!
All elements types can have a defaultValue set, with the exception of date . The defaultValue displays when the Source Review form's first used or when clearing the form. By default, the date element uses the date set in Preferences > General > Date:.
Values entered in the Source Review form are saved as a value property in the preset file..
1
{ "name" : "{Project Name}", "type" : "text", "value": "Project X, "defaultValue" : ""},
Copied!

Select options

The select element has an options property that defines all the dropdown options in the Source Review Form.
1
{ "name" : "{Location}", "type" : "select", "defaultValue" : "", "value" : "",
2
"options" : [
3
{ "name" : "", "value" : "" },
4
{ "name" : "Adam", "value" : "Adam" },
5
{ "name" : "NY", "value" : "030" }
6
]
Copied!
Select elements also allow empty options. This is handy when you want to force the user to make an active choice.

Organization settings

You can define the following organization settings in a preset:
Setting
Type
Required
Description and example
doNotCopyFiles
Array
no
Files with these file extensions will be transferred. e.g. [".thumbs", "XML"] cannot be combined with copyOnlyFiles.
copyOnlyFiles
Array
no
Only files with these file extensions will be transferred. e.g. [".mp4", "mov"] cannot be combined with doNotCopyFiles. When both properties are defined, doNotCopyFiles will be used.
ignoreEmptyFolders
Boolean
no
When true, empty folders will not be transferred.
ignoreBundles
Array
no
Bundles with these names have their file size checked. If the name matches and they're larger or smaller than the size specified, they won't be transferred. e.g. [ "AVCHD<2MB" ]
flattenFolders
Boolean
no
When true, the Source's folder structure is flattened. Duplicate filenames will be renamed with a counter.
labelPattern
String
no
Sets the Auto Label pattern for this preset. {Metadata} elements, excluding {Filename} and {File date} elements, can be used. This label will be used in the transfer log name and picked up by the {Source Name} element.
renamePattern
String
no
Renames all files with the specified format. {Metadata} elements including {Filename} can be used here.
folderPattern
String
no
Create destination folders with a specified format. {Metadata} elements, excluding {Filename} and {File date}elements, can be used. Use / to create a folder path.
dontAllowRepetitionAndTrim
Array
no
Specify characters that should be trimmed and checked for repetition in labelPattern, renamePattern, and folderPattern. Especially useful when not all elements have a value.
1
"doNotCopyFiles": ["xml", ".thumb"],
2
"copyOnlyFiles": ["mov", "mp4", "mxf"],
3
4
"ignoreEmptyFolders" : false,
5
"ignoreBundles": ["AVCHD<1MB"],
6
"flattenFolders" : true,
7
8
9
"labelPattern" : "{Location}_{Card}",
10
"renamePattern" : "{Project Name}_{Date}__{Location}_{Card}__{Clip Location}_{Rating}_{File YYYY}{File MM}{File DD}{File hh}{File ss}__{File Counter}",
11
"folderPattern" : "{Project Name}/{Date}/{Location}/{Card}",
12
13
"dontAllowRepetitionAndTrim" : ["_", "/"],
Copied!

Multiple presets in one file

It is also possible to create one .hedge file with multiple presets. See the example below.
1
[
2
{
3
"name": "preset 1",
4
...
5
},
6
{
7
"name": "preset 2",
8
...
9
},
10
{
11
"name": "preset 3",
12
...
13
}
14
]
Copied!

Clip Review

When clipReviewElements are defined in a preset, a Clip Review form is presented per clip.
Clip Review is a paid add-on. Email [email protected] to access this feature.
By default, any entered values are cleared from the Clip Review form. However, you can choose which values will persist by pinning them with 📌. Like Source Review, Clip Review data is logged in the Transfer Log and the MHL.
1
-- Transferred files --
2
#1: Clip0001.MXF
3
Path: 2021-09-09__0002_201908231232_000001.MXF
4
Size: 13729840 bytes
5
Source hash: b09fa6763fbd1cf6
6
Copy hash: b09fa6763fbd1cf6
7
8
Subject: Test shot
9
Tags: Hedge, Demo
10
Rating: ⭐️⭐️⭐️⭐️⭐️
11
Info: this is awsome
Copied!
1
<hash>
2
<file>2021-09-09__0002_201908231232_000001.MXF</file>
3
<size>13729840</size>
4
<lastmodificationdate>2019-08-22T11:44:05Z</lastmodificationdate>
5
<clipinfo>
6
<clipinfofield name="Subject">Test shot</clipinfofield>
7
<clipinfofield name="Tags">Hedge, Demo </clipinfofield>
8
<clipinfofield name="Rating">⭐️⭐️⭐️⭐️⭐️</clipinfofield>
9
<clipinfofield name="Info">this is awsome</clipinfofield>
10
</clipinfo>
11
<xxhash64be>b09fa6763fbd1cf6</xxhash64be>
12
<xxhash64>f61cbd3f76a69fb0</xxhash64>
13
<hashdate>2021-09-09T18:48:03Z</hashdate>
14
</hash>
Copied!
Last modified 2mo ago