# 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](/hedge/releases.md) / 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.

![](/files/-Mi1A_eARDp7HQ6I7lVq)

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](/files/-Me785BPAUfmMuaYIFdY)

## Metadata

OffShoot will add the following metadata to your clips:

* `Checksum_xxhash64be`
* All [Source Review](/offshoot/features/elements.md) metadata

![Checksum and Source Review metadata](/files/-MeAQxlEkqLreyA1CnOn)

## 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.hedge.video/offshoot/integrations/scratch.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.