# Scratch

OffShoot's integration for Assimilate SCRATCH automatically adds transferred clips to a target SCRATCH project.

{% hint style="info" %}
Read all about this feature on our blog – [Hedge, then SCRATCH](https://blog.hedge.video/scratch/).
{% endhint %}

## Requirements

1. [Hedge 21.2 or newer](https://docs.hedge.video/hedge/releases) / OffShoot 23.2 or newer
2. [Assimilate SCRATCH](https://www.assimilateinc.com/products/)

## Settings

Once Assimilate SCRATCH is installed, enable the integration in OffShoot's settings.

![](https://1060439511-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LStRji2w1AYja1bLBFv%2F-Mi19zWUOVYzSQZz2Y2S%2F-Mi1A_eARDp7HQ6I7lVq%2Fimage.png?alt=media\&token=5dd0d6b6-819b-4cea-b2ac-734fe1cd5ae1)

Next, specify the Destination and file extensions for clips you want to be added to your SCRATCH project.

#### "For transfers where Destination matches:"

Specifies which Destination's clips you want to be added to your SCRATCH project. If you don't specify a Destination, the `First Destination` your Source is transferred to will be used. You can specify in two ways:

* By volume name, e.g. `RAID`
* A folder path. Use a wildcard (\*) for more flexibility, e.g. `*/proxies`

{% hint style="info" %}
Add multiple Destinations by separating them with a semicolon:

`Backup 1;Backup 2;Backup 3`
{% endhint %}

#### "Add clips when file extension matches:"

Narrows down which files are added to your SCRATCH project by setting one or multiple file extensions.

{% hint style="info" %}
Add multiple extensions by separating them with a semicolon:

`.R3D;.MOV`
{% endhint %}

{% hint style="danger" %}
Image sequences and spanned clips are currently not supported.
{% endhint %}

Finally, tell OffShoot which SCRATCH `project`, `group` , and `timeline` the clips will be added to:

* **Project:** the name of the SCRATCH project (must be an existing project).
* **Group:** the name of the group in the SCRATCH project. If this group does not exist, a new one will be created. 
* **Timeline:** the name of the timeline within a group in a SCRATCH project. If this group does not exist, a new one will be created.

{% hint style="danger" %}
Before transferring with the integration enabled, be sure to have created your project in SCRATCH.
{% endhint %}

These elements can be used when setting **Group** and **Timeline**:

`{Source Name}`,`{Counter}`,`{YYYY}`,`{YY}`, `{MM}`, `{DD}`,`{hh}`.`{mm}`, `{ss}`

Once you're done configuring the integration, transfer your media. When a transfer completes, clips are added to your SCRATCH project.

{% hint style="info" %}
Clips are added when you (re)loading your SCRATCH project.
{% endhint %}

![Project, Group, Timeline, and Clips Processed from OffShoot](https://1060439511-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LStRji2w1AYja1bLBFv%2F-Me75qJ43UORvL7XvTny%2F-Me785BPAUfmMuaYIFdY%2FSCRATCH%20-%20Clips%20Added%20From%20Hedge%20-%20Group%20A009%20w-Callouts%20and%20Type.png?alt=media\&token=2652d3ee-4e8e-40f9-9eef-93c931692953)

## Metadata

OffShoot will add the following metadata to your clips:

* `Checksum_xxhash64be`
* All [Source Review](https://docs.hedge.video/offshoot/features/elements) metadata

![Checksum and Source Review metadata](https://1060439511-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LStRji2w1AYja1bLBFv%2F-MeAQtxgZiXrpJwnQI_7%2F-MeAQxlEkqLreyA1CnOn%2FSCRATCH%20-%20Clips%20Added%20From%20Hedge%20-%20Group%20A008%20-%20Checksum%20and%20Source%20Review%20metadata.png?alt=media\&token=c33faef8-63b2-4a35-8fc9-ad7e299fa111)

## The SCRATCH Watch Folder

By default OffShoot uses the default SCRATCH watch folder location: 

{% tabs %}
{% tab title="Mac" %}
`/Library/Application Support/Assimilator/Watch`
{% endtab %}

{% tab title="Windows" %}
`C:\ProgramData\Assimilator\Watch`
{% endtab %}
{% endtabs %}

If you change SCRATCH's watch folder path, you'll also need to tell OffShoot about it. 

{% tabs %}
{% tab title="Mac" %}
Do so in Terminal, with this command:

`defaults write nl.syncfactory.Hedge.Mac SFIIntegrationsScratchDefaultsWatchFolderKey <path/to/the/new/watchfolder>`

To check the current setting use this command:

`defaults read nl.syncfactory.Hedge.Mac SFIIntegrationsScratchDefaultsWatchFolderKey`
{% endtab %}

{% tab title="Windows" %}
Do so in the Registry app:

Add a string: `ScratchWatchFolder` with the new path as `value`
{% endtab %}
{% endtabs %}

Often, the dailies computer is not the same as the offload computer. When that's the case, set up a network between the two computers over Wi-Fi, and share SCRATCH's watch folder on the dailies computer over the network. Then, point OffShoot to the shared folder. Alternatively, you could use rsync to sync two watch folders over the network.