# Cosmo Add Proxy To Project Action

The **Cosmo Add Proxy to Project Action** node allows you to attach or update a proxy file for an existing high-resolution (HiRes) asset in Cosmo.

The proxy is linked to a previously registered asset. If the corresponding HiRes asset does not already exist in Cosmo, the node will fail.

This node is typically used in transcoding or proxy-generation workflows where a render system creates lightweight editorial media after the master file has been ingested.

#### Important Timing Note

Avoid executing this node immediately after [Cosmo Add Asset to Project Action](https://docs.helmut.de/helmut4-releases/helmut4-components/streamdesigner/nodes/actions/cosmo-16/cosmo-add-asset-to-project-action).\
The asset may not yet be fully available in the database. If both nodes must be used in the same stream, insert a [Sleep node](https://docs.helmut.de/helmut4-releases/helmut4-components/streamdesigner/nodes/actions/misc-21/sleep-action) between them (recommended delay: **at least 4000 ms**).

#### How the Proxy Is Assigned

The node determines which asset receives the proxy based on the provided inputs. The following priority order applies:

**1. Highest Priority — Asset ID**

If **Asset ID** is provided, the proxy is attached to exactly that single asset.

**2. Medium Priority — Project ID**

If no Asset ID is provided but a **Project ID** is specified, all assets inside that project that match the provided HiRes path will receive the proxy.

**3. Lowest Priority — HighRes Path Only**

If neither Asset ID nor Project ID is provided, Cosmo searches the entire database for matching HiRes paths and assigns the proxy globally to all matching assets.

This allows updating multiple projects at once without iterating through them individually.

#### Input Parameters

**Asset ID**\
ID of the asset to which the proxy should be attached.\
If present, this parameter overrides all other matching methods.

**Project ID (optional)**\
Limits proxy assignment to assets within a specific project.

**HighRes Path**\
Full file path (including extension) of the associated high-resolution media.

**Proxy Path**\
Full file path (including extension) of the proxy media file.

#### Synchronization Options

**Auto Sync**\
If enabled, the proxy is automatically synchronized when the project is opened.\
If disabled, the asset will appear as pending synchronization in the panel and must be synced manually.

**Skip Metadata Sync**\
If enabled, metadata synchronization in the panel is skipped.

**Skip Markers Sync**\
If enabled, marker synchronization in the panel is skipped.

**Don't change Asset name**\
If enabled, markers sync will be skipped in panel

**Don't change Asset breadcrumb**\
If enabled, the breadcrumb of the asset will not be changed after synchronisation, if it has been changed in premiere

When Auto Sync is disabled, the panel indicates pending updates and increases the counter of items requiring synchronization.

#### Execution Behavior

* Requires an existing registered HiRes asset in Cosmo
* Can update a single asset, a project, or all matching assets
* Typically used after proxy generation/transcoding
* Supports asynchronous execution

<figure><img src="https://1398472304-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcJYkTyk9qgh7aCR6dHIm%2Fuploads%2Fa9ptzNkHSmLpICaV8Ljx%2Fimage.png?alt=media&#x26;token=7a51767b-aabc-4f68-b9c8-753f02046961" alt="" width="351"><figcaption><p>Cosmo Add Proxy To Project Action</p></figcaption></figure>

#### Practical Example

A typical workflow:

1. A master file is ingested and registered in Cosmo.
2. A transcode system generates an H.264 proxy.
3. This node attaches the proxy to the HiRes asset.
4. Editors immediately receive an online/offline-switchable clip in Premiere Pro or After Effects after synchronization.
