> For the complete documentation index, see [llms.txt](https://docs.gta.clothing/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.gta.clothing/share-and-sync/project-sync.md).

# Project Sync

Keep saved projects in sync across your computers and with your team through DCT Cloud or GitHub

Project sync keeps a saved project up to date on every computer that works on it. Every save uploads automatically, and changes from other people arrive in the open project while you work. Each person works in their own folder on their own PC.

## Choose how to sync

Each project syncs one way at a time:

|                       | **DCT Cloud**                                                                                                            | **GitHub**                                                                                           | Another Git host                                                                                     |
| --------------------- | ------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- |
| License               | **Ultimate** on the owner's account. Projects shared with you need none.                                                 | Any license                                                                                          | Any license                                                                                          |
| Who can open it       | Only you, or one of your [teams](https://docs.gta.clothing/share-and-sync/teams.md)                                      | The people you invite on GitHub                                                                      | The people you invite on that host                                                                   |
| Open it on another PC | **Download and open**. You can start working while the rest downloads.                                                   | **Clone from Git**                                                                                   | **Clone from Git**                                                                                   |
| Step-by-step guide    | [Share a Cloud Project with Your Team](https://docs.gta.clothing/share-and-sync/share-a-cloud-project-with-your-team.md) | [Sync a Project with GitHub](https://docs.gta.clothing/share-and-sync/sync-a-project-with-github.md) | [Sync with Another Git Host](https://docs.gta.clothing/share-and-sync/sync-with-another-git-host.md) |

To work on a project someone else set up, follow [Open a Cloud Project](https://docs.gta.clothing/share-and-sync/open-a-cloud-project.md) or [Clone a Project from Git](https://docs.gta.clothing/share-and-sync/clone-a-project-from-git.md). [Teams](https://docs.gta.clothing/share-and-sync/teams.md) explains invitations and roles, which are separate from license assignment.

## Where to find project sync

Everything lives in the **Project sync** window. It has three tabs:

* **This project** (while a project is open): set up sync, see its status, pause it, change sharing, review changes and stop syncing.
* **Open from cloud or Git**: your cloud projects and the ones shared with you, the cloud trash, and **Clone from Git**.
* **On this PC**: every project that syncs on this computer, with its status.

You can open it from several places:

* **Project > Share and sync this project…** (or press **Ctrl+K** and paste `>Share and sync`) opens **This project**.
* **Project > Cloud projects** lists your cloud projects. Choose one to open it, or choose **Manage cloud projects…** at the end of the list.
* **Project > Clone from Git…** (or press **Ctrl+K** and paste `>Clone from Git`) starts a clone.
* The **sync button in the status bar** shows the open project's sync status in a few words, or **Share** for a project that does not sync yet. Click it to open **This project**. It appears once any project on this PC syncs.
* On Home, the **Open from cloud or Git** tile and the **Cloud projects** section under **Recent projects**. See [Home & Quick Look](https://docs.gta.clothing/basics/useful-to-know/home-and-quick-look.md).

These actions can get their own shortcuts in **Options > Keybindings** (or press **Ctrl+K** and paste `@Change a shortcut`).

## Start syncing a project

1. Open the project and choose **Project > Share and sync this project…** (or press **Ctrl+K** and paste `>Share and sync`). If it was never saved, choose **Save project** first. Sync starts from the saved project file.
2. Under **Keep this project in sync**, choose **DCT Cloud** or **GitHub**. For GitLab, Bitbucket or an SSH address, choose **Use another Git host (GitLab, Bitbucket, SSH)**.
3. Follow the steps in the window. The guides linked above walk through each one.

<figure><img src="https://2130288373-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRsXe3tqSiAvM8iKYjngE%2Fuploads%2Fgit-blob-46108f1ebf452a9a16c8f01651944b86aaa1193f%2Fproject-sync-this-project.png?alt=media" alt="The This project tab of Project sync with Keep this project in sync, the DCT Cloud and GitHub option cards and the link Use another Git host (GitLab, Bitbucket, SSH)."><figcaption><p>Choose where the project is kept in sync.</p></figcaption></figure>

If the project folder is already a Git repository, **This project** says so first. It offers **Turn on automatic sync** when the repository is already online, **Publish to GitHub** when it only exists on this PC (its history is kept), or **Install Git for DCT** when Git is needed.

## What syncs

Saving the project and **Save to cloth** upload the saved project together with every file it uses. Unsaved [Texture Studio](https://docs.gta.clothing/basics/good-to-know/texture-studio.md) and [Model Studio](https://docs.gta.clothing/basics/good-to-know/model-studio.md) drafts stay on your PC until you save them. Build output, previews, [Project History](https://docs.gta.clothing/basics/useful-to-know/project-history.md) restore points and logs stay on each PC.

**Save As** creates an independent local copy. That copy does not sync until you set it up.

## When changes arrive

Changes from other people are applied to the open project without reloading it. DCT tells you who changed what:

* The status bar sync button briefly shows **Updated by …**.
* A small notice, **Changes arrived**, appears in the corner of the editor. **Show** selects the changed item, or opens Logs when several items changed.
* Each changed item shows an **Updated by …** line in the item list for a short while, or until you select it.
* [Logs](https://docs.gta.clothing/basics/useful-to-know/logs.md) keep a line for every change that arrived.

<figure><img src="https://2130288373-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRsXe3tqSiAvM8iKYjngE%2Fuploads%2Fgit-blob-641243d2e5da5c592d6f1268bf9a49394cf036a3%2Fscreenshot-needed.svg?alt=media" alt="Screenshot placeholder for changes arriving from a teammate."><figcaption><p>Capture needed: the editor with a synced test project right after a teammate's save, showing the Changes arrived notice with Show in the corner, the Updated by line on the changed item in the item list and Updated by in the status bar sync button. Use real clothing and test names. Use presentation mode; do not show private paths.</p></figcaption></figure>

A change to an item that is open in Texture Studio or Model Studio waits until you close that editor, and the status shows **Waiting for an editor to close**. Changes to unsaved settings or items also wait. Unrelated changes keep arriving in the meantime.

Different clothing items and independent settings are combined automatically. When you and someone else changed the same items, DCT asks you to choose. See [Review Sync Conflicts](https://docs.gta.clothing/share-and-sync/resolve-project-sync-conflicts.md).

## Status and problems

The status card on **This project**, each row on **On this PC** and the status bar sync button show the same short status, such as **Up to date**, **Uploading…**, **Receiving changes…** or **Paused**. **Up to date** means that everything you saved is synced: your changes upload each time you save the project. While the open project has changes you have not saved yet, the status bar sync button shows **Unsaved changes** instead (it can take up to a minute to notice an edit). When something needs you, the status says so in plain words and offers one button that fixes it:

| Status                     | What it means                                                                                                                                                        | Button                                                                       |
| -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------- |
| **Sign in to sync**        | You are signed out of your DCT account, or the sign-in expired. Your saves stay on this PC until then.                                                               | **Sign in**                                                                  |
| **Different account**      | This project syncs with another DCT account.                                                                                                                         | **Sign in**                                                                  |
| **Ultimate needed**        | Your account no longer has Ultimate. Your saves stay on this PC, and the cloud copy stays available for 30 days.                                                     | **Get Ultimate**                                                             |
| **Owner's Ultimate ended** | New saves can't upload. You can still download the project for 30 days. Ask the owner to renew.                                                                      | None                                                                         |
| **Project limit reached**  | You already own the most cloud projects your account can keep, including the trash.                                                                                  | **Manage cloud projects**                                                    |
| **Cloud storage full**     | Your cloud storage is full, including older versions and the trash.                                                                                                  | **Manage cloud projects**                                                    |
| **In the trash**           | The project was moved to the cloud trash. Owners can restore it within 7 days.                                                                                       | **Restore** for the owner, **Stop syncing (keep my copy)** for everyone else |
| **Access ended**           | The cloud project was deleted, or you no longer have access. Your copy on this PC is kept.                                                                           | **Stop syncing (keep my copy)**                                              |
| **Needs review**           | You and someone else changed the same items.                                                                                                                         | **Review changes**                                                           |
| **Waiting for connection** | DCT can't reach the sync service right now and tries again automatically.                                                                                            | **Try again now**                                                            |
| **Download incomplete**    | Some clothing hasn't finished downloading.                                                                                                                           | **Resume**                                                                   |
| **Update needed**          | The project was saved with a newer version of Durty Cloth Tool. Update DCT to keep syncing it.                                                                       | **Check for updates**                                                        |
| **Saved by another build** | The project was saved by a test or development build of Durty Cloth Tool that this version cannot open. Ask whoever saved it to save it again in a released version. | **Try again now**                                                            |
| **Git needed**             | DCT needs Git to sync this project.                                                                                                                                  | **Install Git for DCT**                                                      |
| **Sign in to GitHub**      | Connect your GitHub account again to keep syncing.                                                                                                                   | **Connect GitHub account**                                                   |
| **GitHub access needed**   | DCT may not use this repository yet. Allow it on GitHub and DCT continues on its own.                                                                                | **Allow access on GitHub**                                                   |
| **Different repository**   | The folder's Git repository points to a different address.                                                                                                           | **Open project folder**                                                      |
| **Repository not empty**   | The repository already has other history. Clone it into a new folder instead, or choose an empty repository.                                                         | **Stop syncing (keep my copy)**                                              |
| **Paused: branch changed** | The branch or remote changed outside DCT. Switch back in Git, or stop syncing and set it up again.                                                                   | **Open project folder**                                                      |
| **Needs Git attention**    | Files outside the project changed in the same place on both sides. Resolve that in your Git client, then resume.                                                     | **Open project folder**                                                      |
| **Git problem**            | Git couldn't finish. Check your connection and repository permissions. DCT tries again automatically.                                                                | **Try again now**                                                            |
| **Sync problem**           | Sync couldn't finish. Your project and your saves are kept, and DCT tries again automatically.                                                                       | **Show logs**                                                                |

While the editor is the active window, a small notice in its corner shows a new problem or **Changes need your review**, with the same button. Logs keep a record either way.

## Keep syncing in the background

Turn on **Keep Durty Cloth Tool running in the background** at the bottom of **On this PC**, or under **Options > General** (or press **Ctrl+K** and paste `@Keep running`), to keep syncing after you close DCT. DCT then starts with Windows and stays in the system tray when you close its window. The tray icon's tooltip shows **All projects up to date**, **Projects syncing: …**, **Projects that need you: …** or **Sync paused**. Double-click the icon, choose **Open Durty Cloth Tool** or start DCT again to bring it back. **Quit and pause synchronization** closes DCT; queued saves and unfinished downloads continue the next time DCT starts.

The option is off by default. Without it, closing DCT ends it. If a saved change is still uploading, DCT shows **Uploading your saved changes** and closes when the upload is done. **Exit now** closes at once and uploads the rest the next time you open DCT; **Cancel** keeps DCT open.

While DCT runs in the background, the tray shows a balloon only for a problem that needs you, such as signing in or reviewing changes. Click the balloon to open DCT.

The option also helps without a synced project: DCT stays ready in the tray and opens at once.

<figure><img src="https://2130288373-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRsXe3tqSiAvM8iKYjngE%2Fuploads%2Fgit-blob-fcdefa868b4a5fb9d8ab4d7a6713323bf0d67172%2Fsync-on-this-pc.png?alt=media" alt="The On this PC tab, Synced projects on this PC, with two DCT Cloud projects and three GitHub copies of pier_tops, all up to date, each with Open and buttons to pause, open its folder and stop syncing, and Keep Durty Cloth Tool running in the background with its explanation at the bottom."><figcaption><p>Every project that syncs on this computer, with its status.</p></figcaption></figure>

## Pause or stop syncing

* **Pause sync** and **Resume sync** sit on the status card of **This project** and as icons on each row of **On this PC**. While a project is paused, saves stay on this PC; resuming uploads the saves made in the meantime.
* **Stop syncing** sits at the bottom of **This project** and as an icon on **On this PC**. The project files stay where they are. For a cloud project, the cloud copy and other people's copies are not changed. For a Git project, the repository stays as it is and new saves are no longer committed.

A copy that has not finished downloading is paused instead of stopped, so you can resume it later. When DCT created that copy's folder and the project is not open, DCT offers **Move to Recycle Bin** for the unfinished folder.

## Cloud allowance

The owner of a cloud project needs active **Ultimate** on their signed-in account. An Ultimate license assigned to that account through a team also counts. You can own up to **ten cloud projects** with **30 GB** of storage shared between them. Older versions, projects in the trash and uploads still in progress count toward this allowance. Projects shared with you use their owner's allowance.

The account header on **Open from cloud or Git** and the **DCT Cloud** setup show how many cloud projects and how much storage you use.

## Cloud projects in your account

Your account on gta.clothing lists your cloud projects and the ones shared with you on its **Cloud projects** page. There you can see what a project holds, who can open it, its saved versions and its storage. The owner can also rename the project, change its sharing and use the trash there. Opening and saving a project stays in DCT, and nothing can be downloaded from the website.

**Manage online** on the **Synced with DCT Cloud** card (**View online** for a project shared with you) and the **View online** icon next to a project on **Open from cloud or Git** open the project's page in your browser.

With **Show contents in the account portal** on, each save also sends item names, counts and small preview pictures to that page. The owner chooses this during the **DCT Cloud** setup and can change it later with **Change sharing**. See [See and Manage Cloud Projects in Your Account](https://docs.gta.clothing/share-and-sync/manage-cloud-projects-in-your-account.md).

## Remove a cloud project

Only the owner can remove a cloud project:

1. On **Open from cloud or Git**, choose the trash icon (**Move to trash**) next to the project and confirm. Your team loses access and their copies stop syncing. No copy on any PC is deleted.
2. The project moves to the **Trash** section, which keeps it for 7 days. It still counts toward your allowance there.
3. Choose **Restore cloud project** to bring it back. Its copies resume syncing.
4. Choose **Delete permanently** to remove it from the cloud for good. Copies on PCs are not deleted, but they stop syncing.

<figure><img src="https://2130288373-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRsXe3tqSiAvM8iKYjngE%2Fuploads%2Fgit-blob-131616f2ba4c296cf38efc2fa21933d77b6c4054%2Fcloud-trash.png?alt=media" alt="The Open from cloud or Git tab with the account header and usage line, two cloud projects On this PC, a test project Not downloaded and the expanded Trash section with a test project, Deleted for good in 7 days, Restore cloud project and the Delete permanently icon."><figcaption><p>A removed cloud project waits in the trash for 7 days.</p></figcaption></figure>

### If the owner's Ultimate ends

New saves stop uploading and stay on each PC. Everyone with access can still download the project for 30 days. Renewing Ultimate resumes uploads.

{% hint style="danger" %}
After 30 days without Ultimate, the cloud content is removed. Local copies remain, so keep a copy of the work you need.
{% endhint %}

## Git limits

Git sync works on every license tier. Your host's repository permissions, storage limits and Git LFS allowance still apply, and a DCT team role does not grant access to a repository. Each collaborator needs their own access on the host.
