# Installation - Manual Install

## **Important Notice**

<details>

<summary><mark style="color:red;"><strong>Existing Users PLEASE READ before upgrading</strong></mark></summary>

1. <mark style="color:red;">**DELETE**</mark> <mark style="color:red;"></mark><mark style="color:red;">existing xgtc folder to avoid errors.</mark>
2. <mark style="color:red;">**DELETE**</mark>  <mark style="color:red;"></mark><mark style="color:red;">existing shelf icon.</mark>
3. <mark style="color:red;">If you are having the following issue installing the latest version:</mark>

`Warning: Seat limit reached for this license. Please re-validate or reset seats.`

<mark style="color:red;">Please go to the main Groomer's Tool UI, then,</mark> <mark style="color:red;"></mark><mark style="color:red;">**Account-> Reset Seats (bind this device)**</mark><mark style="color:red;">. Contact me if you are having any issues. <info@nobraintools.com></mark>

3. <mark style="color:red;">There's a new Launch code as if V15.03.06, please update your existing launch code with:</mark>

<mark style="color:$success;">**Default Path:**</mark>

```python
from xgtc.scripts.ui import activate as xgt
xgt.XgtRun()
```

<mark style="color:$success;">**Custom path (if you prefer to have the xgtc folder somewhere else):**</mark>

```python
import sys
xgtcPath = 'C:/.../plugins/2025/'
# change to the central folder path you put xgtc folder in.
# This is the parent folder path of xgtc folder, not the xgtc folder path. 
# Make sure to use '/' forward slashes

if xgtcPath not in sys.path:
    sys.path.append(xgtcPath)
    
from xgtc.scripts.ui import activate as xgt

xgt.XgtRun()
```

</details>

## **Manual Install**&#x20;

{% embed url="<https://youtu.be/MFeuAVkMA2Y>" %}

{% hint style="warning" %}
NOTE: The Manual Installation Video is for V15.02. The xgtc folder now contains 6 items, and **an updated launch code.** Steps are exactly the same.
{% endhint %}

## **1. Download File**

* Depends on where you got the subscription from, after receiving a receipt for your subscription, please visit
  * [**Gumroad's content page**](https://app.gumroad.com/library), or
  * [**No Brain Tools's Download page**](https://nobraintools.wixsite.com/nobraintools/file-share)
* Download Maya Groomer's Tool with the Maya version you want to run with. Current supported versions are 2022 (Py3), 2023, 2024, 2025, and 2026 on Windows.

***

## **2. Unpack  - Copy/Paste Into Folder**

* Unpack the downloaded .zip file.
* Extract/Copy the `xgtc` folder to your **Users\Documents\maya\version\scripts\\** folder.​

<details>

<summary>Example folder structure</summary>

Your xgtc folder content should look like this:

* Users​\Documents\maya\2025\scripts\xgtc
* Users\Documents\maya\2025\scripts\xgtc\icons\\
* Users​\Documents\maya\2025\scripts\xgtc\scripts\\
* ​Users\Documents\maya\2025\scripts\xgtc\marking\_menus\\
* ​Users\Documents\maya\2025\scripts\xgtc\\\_\_init\_\_.pyc
* ​Users\Documents\maya\2025\scripts\xgtc\license.json
* ​Users\Documents\maya\2025\scripts\xgtc\Maya\_DragDrop\_Installer.py

</details>

{% hint style="danger" %}
When installing a new version of Maya, a duplicate `xgtc` folder may be created. This can interfere with the installation of Groomer's Tool. Before proceeding with the installation, ensure there are no `xgtc`folders in any Maya default directories (such as the pref or scripts folder).
{% endhint %}

<details>

<summary>Installing Groomer's Tool for none English Maya versions</summary>

If you are running Maya in different language other than English, the folder will be: \Documents\maya\version\\**\<language>**\scripts\\

* ​Simplified Chinese:&#x20;
  * Users\Documents\maya\version\\**zn\_CH**\scripts\xgtc
  * Users\Documents\maya\version\\**zn\_CH**\scripts\xgtc\icons\\
  * Users\Documents\maya\version\\**zn\_CH**\scripts\xgtc\scripts\\
  * Users\Documents\maya\version\\**zn\_CH**\scripts\xgtc\marking\_menus\\
  * Users\Documents\maya\version\\**zn\_CH**\scripts\xgtc\\\_\_init\_\_.pyc
  * Users\Documents\maya\version\\**zn\_CH**\scripts\license.json
  * ​Users\Documents\maya\version\\**zn\_CH**\scripts\xgtc\Maya\_DragDrop\_Installer.py
* **Japanese:**&#x20;
  * Users\Documents\maya\version\\**ja\_JP**\scripts\xgtc
  * Users\Documents\maya\version\\**ja\_JP**\scripts\xgtc\icons\\
  * Users\Documents\maya\version\\**ja\_JP**\scripts\xgtc\scripts\\
  * Users\Documents\maya\version\\**ja\_JP**\scripts\xgtc\marking\_menus\\
  * Users\Documents\maya\version\\**ja\_JP**\scripts\xgtc\\\_\_init\_\_.pyc
  * Users\Documents\maya\version\\**zn\_JP**\scripts\license.json
  * Users\Documents\maya\version\\**ja\_JP**\scripts\xgtc\Maya\_DragDrop\_Installer.py

</details>

***

## **3. Maya Run Command**

* In Maya, open the Script Editor. In a Python Tab run the following code.

<mark style="color:$success;">**Default Maya path:**</mark>

```python
from xgtc.scripts.ui import activate as xgt
xgt.XgtRun()
```

<mark style="color:$success;">**Custom path (if you prefer to have the xgtc folder somewhere else):**</mark>

```python
import sys
xgtcPath = 'C:/.../plugins/2025/'
# change to the central folder path you put xgtc folder in.
# This is the parent folder path of xgtc folder, not the xgtc folder path. 
# Make sure to use '/' forward slashes

if xgtcPath not in sys.path:
    sys.path.append(xgtcPath)
    
from xgtc.scripts.ui import activate as xgt
xgt.XgtRun()
```

{% hint style="info" %}
To add the script to your Maya Custom Shelf, navigate to File > Save Script to Shelf in the script
{% endhint %}

***

## **4. License Activation**

* When you run Groomer’s Tool for the first time, you will get a Licensing Window.
* Please go to your receipt email, or the content page to get the License Key.

<div align="center"><figure><img src="/files/v9386m9VPkjO8I5VosZe" alt=""><figcaption></figcaption></figure></div>

<mark style="color:$success;">A)</mark> <mark style="color:$success;"></mark><mark style="color:$success;">**Gumroad License**</mark>

If you got your license from Gumroad, go back to your Gumroad's Library to retrieve the license key. Alternatively, it's also in the subscription Email sent when you purchased the subscription.

<figure><img src="/files/kCijGptadUG5baLOBbE7" alt=""><figcaption></figcaption></figure>

<mark style="color:$success;">**B) No Brain Tools License**</mark>

If you got your license from **[www.nobraintools.com](http://www.nobraintools.com)**, log in and go to My License/Order Info page to retrieve the license key. Alternatively, it's also in the subscription Email sent when you purchased the subscription.

<figure><img src="/files/IrobrTs7zc8jViktzhz1" alt=""><figcaption></figcaption></figure>

* When it’s successfully validated, the Groomer’s Tool kit will pop up right after.

<figure><img src="/files/vdXkp0wB5FOSaQ6ZmI8Q" alt=""><figcaption></figcaption></figure>

* If you have any issues or need help with the installation, please contact me at <info@nobraintools.com>


---

# 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://nobraintools.gitbook.io/maya-groomers-tool/getting-started/installation-manual-install.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.
