> 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/basics/useful-to-know/home-and-quick-look.md).

# Home & Quick Look

The Home screen and inspecting clothing without creating a project

## Introduction

Durty Cloth Tool opens on **Home**. It is the starting point for everything, and it also lets you inspect a clothing file without committing to a project at all.

<figure><img src="https://2130288373-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRsXe3tqSiAvM8iKYjngE%2Fuploads%2Fgit-blob-e01abb6d844a7d9478e0060490f96c02db2bb682%2Fquick-look-poster.webp?alt=media" alt="Inspect a clothing file with Quick Look."><figcaption><p>Inspect a clothing file with Quick Look.</p></figcaption></figure>

{% embed url="<https://gta.clothing/assets/media/v4/quick-look-mobile.mp4?v=cc1e122df810>" %}
Inspect a clothing file with Quick Look.
{% endembed %}

## Starting points

A new project you create here can be built before you save it: see [Build without saving the project first](https://docs.gta.clothing/basics/essential-knowledge/build-options.md#build-without-saving-the-project-first).

Home starts with five ways to start, in two columns:

* **Create a new project**
* **Open a project**
* **Open from cloud or Git**, to download a project shared with you or clone one from GitHub or another Git host
* **Start from a project export**
* **Start from a built cloth resource**, see [Import & Export Formats](https://docs.gta.clothing/basics/useful-to-know/import-and-export-formats.md)

Beside them, the large **Inspect one cloth set without a project** area is Quick Look (see below): drop a YDD, YTD, YLD or a matching CodeWalker XML set anywhere on Home to look at it, or click the area to choose files.

<figure><img src="https://2130288373-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRsXe3tqSiAvM8iKYjngE%2Fuploads%2Fgit-blob-5186aedcbd55bb1e141c1417b60f42c73d310faf%2Fhome-overview.png?alt=media" alt="Home while signed out: the five start tiles in two columns with the Quick Look area beside them, Recent projects with the Forge Studio Test project and Cloud projects with Sign in to see your cloud projects on the left, What&#x27;s new with the latest release highlight on the right, Sign in with Discord and Options at the top right, and the version, Send feedback and the license at the bottom left."><figcaption><p>Home: the starts and Quick Look at the top, your projects on the left and What's new on the right.</p></figcaption></figure>

Below them sit **Recent projects** and **Cloud projects** (see below) on the left and **What's new**, the latest highlights from the release notes DCT has already downloaded, on the right, with a **Good to know** tip at the bottom right. Each list scrolls on its own, so Home itself never needs a scrollbar. Until you have a recent or a cloud project, **First steps** takes the left side instead, with one line on what will appear there; it ends with your first project, or when you hide it with its **X**. Its six steps tick themselves as you do them, anywhere in DCT:

1. **Sign in with Discord**, with what signing in does beside it: a license in your account that is free for this PC is activated here. See [License Activation](https://docs.gta.clothing/getting-started/license-activation.md).
2. **Read the quickstart guide**, which opens the [Quickstart](https://docs.gta.clothing/getting-started/quickstart.md). **Help > Quickstart guide** ticks it too.
3. **Open the sample project or add your own clothes**, with **Try the sample project**: six Forge Studios pieces to practise on, a download of about 15 MB the first time.
4. **Look at a piece in the 3D preview**.
5. **Open the Error List and fix what it reports**.
6. **Build for your server and test it in game**, with a link on how to test in game.

A step that is not done yet carries its button or link; a done step shows its tick. While the sign-in step is open it holds the only **Sign in with Discord** on Home. Once the steps are done or hidden, **Quickstart guide**, **Docs** and **Discord community** sit quietly at the bottom right. While no license is active, the free limits stand in one quiet line above the bottom row, with **See plans** (**Try Ultimate free for 7 days** while the free trial is offered, see [Try Ultimate free for 7 days](https://docs.gta.clothing/getting-started/license-activation.md#try-ultimate-free-for-7-days)). Before DCT has checked for updates, **All release notes** shows the release notes right away. A recent project that syncs shows a cloud for DCT Cloud, the GitHub mark or a branch for another Git host, here and under **Project > Recent Projects**.

The top right shows the account you are signed in with and your license, or **Sign in with Discord** when you are not and **First steps** does not show its sign-in step, next to **Options**. The bottom left shows the version you run and **Send feedback**, and your license while you are signed out. Select the account or the license to open **Account & License**, the version to open **What's New**, or **Send feedback** to write to the developers without opening a project (see [Send feedback](https://docs.gta.clothing/basics/useful-to-know/logs.md#send-feedback)).

Home is also a **drop target**. Drop files anywhere on it, and while you drag, Home says what dropping them will do:

* A `.dctproj` project opens.
* A `.dctexport` starts a project from the export, like **Start from a project export**.
* A `.dctpackage` imports its clothing, the same as opening it from Windows Explorer.
* A built cloth resource (its folder, its `fxmanifest.lua` or other manifest, an `.rpf` or a `.ymt`) starts a new project from it, like **Start from a built cloth resource**.
* A `.ydd`, `.ytd` or `.yld` file, in either the native binary format or CodeWalker XML, opens in Quick Look.
* A `.zip` is unpacked, with its progress and **Cancel**, and then used like its content dropped here: one built resource starts a new project from it, and a package or export is handled as above. For a zipped project, **Extract and open** unpacks the zip into a new folder inside one you choose and opens the project from there. For loose clothing or several resources, **Start a new project with it** opens a new project with them. See [Zip archives](https://docs.gta.clothing/basics/useful-to-know/import-and-export-formats.md#zip-archives).
* A folder of loose clothing or several resources offers **Start a new project with it** too, and a saved project's folder opens its project.

If you drop several files and one of them is a project, export or package, DCT uses that one and leaves the others out. A built cloth resource is used the same way, but only when no `.ydd`, `.ytd` or `.yld` file is in the drop; with them, everything opens in Quick Look.

### Cloud projects

When you are signed in and have cloud projects, Home lists the five most recently updated in a **Cloud projects** section under **Recent projects**. Each one shows where it is (**On this PC**, **Not downloaded** or **Downloading…**), who can open it and when it was last updated. Choose a project to open it; DCT downloads it first when it is not on this PC yet. **Show all** opens the complete list in **Project sync**.

When you are signed out, the section offers **Sign in to see your cloud projects**, which signs in with Discord like the button at the top right. When you have no cloud project yet, it says what appears there and links to [Working Together](https://docs.gta.clothing/share-and-sync/working-together.md). If the list could not be loaded, choose **Try again now**.

<figure><img src="https://2130288373-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRsXe3tqSiAvM8iKYjngE%2Fuploads%2Fgit-blob-fb1a01e93d4c601ffc877f1e66c40577b780d683%2Fhome-cloud-projects.png?alt=media" alt="The Recent projects and Cloud projects sections of Home: test projects under Recent projects, and under Cloud projects two test projects On this PC and one Not downloaded."><figcaption><p>Cloud projects on Home, under Recent projects.</p></figcaption></figure>

The **Open from cloud or Git** tile opens **Project sync** on the tab of the same name, where you also find the cloud trash and **Clone from Git**. See [Open a Cloud Project](https://docs.gta.clothing/share-and-sync/open-a-cloud-project.md), [Clone a Project from Git](https://docs.gta.clothing/share-and-sync/clone-a-project-from-git.md) and [Project Sync](https://docs.gta.clothing/share-and-sync/project-sync.md).

### Closing a project

Choose **Project > Close project** or press **Ctrl+Shift+W** to return to Home and Quick Look without exiting Durty Cloth Tool. If you have unsaved changes, you can save them, close without saving, or cancel and keep working. Your saved project stays in Recent projects.

### Removing a recent project

A recent entry can be removed from Home or from **Project > Recent Projects**. Both lists update together.

{% hint style="info" %}
Removing a recent entry only removes the shortcut inside DCT. **Your project file and its data are not touched**, and opening the project again puts it back in the list.
{% endhint %}

## Quick Look

**Quick Look** shows you what is actually in a clothing file:

* Model facts, including geometry and vertex counts
* LOD levels present
* Texture facts
* Cloth physics facts when a `.yld` is involved
* The clothing itself in 3D

Props such as glasses and hats sit upright in Quick Look, as in their thumbnails and on the ped, and turn around their upright axis when you drag the view. The previews in the add and duplicate reviews show them the same way.

{% hint style="success" %}
Quick Look needs **no project and no GTA V installation**. It renders the clothing on its own rather than on a ped, which is what lets it work without game data. This makes it a fast way to check a file somebody just sent you.
{% endhint %}

Press **Ctrl+Q** to open Quick Look from inside the editor. Your open project stays loaded.

## Continuing from Quick Look

From Quick Look you can:

* Continue into the **on ped preview**, which does need a GTA V installation. See [3D Previewing Clothes](https://docs.gta.clothing/basics/essential-knowledge/3d-preview-clothes.md).
* Continue into a **temporary analysis workspace**, where you can work on the files properly.

The analysis workspace leaves **the file you inspected untouched**. When you save for the first time, DCT asks for a name and a location and turns that workspace into a normal Durty Cloth Project.

Before an import would bring an unsaved analysis session to **20 clothing drawables**, DCT offers **Save and import**, **Continue without saving**, or **Cancel**. Textures, companion files and dummy reservations do not count toward this prompt. Saving first puts the incoming files directly in your chosen project folder. Continuing without saving suppresses further prompts for that analysis session. If you save and then cancel the import, the completed save is kept.

{% hint style="info" %}
**Project > New** works the same way. There is no setup wizard to get through first: you land in a workspace immediately, and DCT collects the project name, folder and file when you first save or build.
{% endhint %}
