# 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="https://454332562-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGyyK7o0fNRXvtva8vEkG%2Fuploads%2F26CI8XXJSAz6WK9wWiN5%2Fimage.png?alt=media&#x26;token=31904970-0a23-4d47-906b-afc6059e6ab4" 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="https://454332562-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGyyK7o0fNRXvtva8vEkG%2Fuploads%2FgZgGMwOZ0D8in0M81St3%2Fimage.png?alt=media&#x26;token=7215f185-52cb-4593-843e-ab4711f5a1ac" 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="https://454332562-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGyyK7o0fNRXvtva8vEkG%2Fuploads%2F7iey8ibFS0XraXUxLcYL%2Fimage.png?alt=media&#x26;token=afd924e5-37f9-4db9-88bf-510bdfe56c52" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://454332562-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGyyK7o0fNRXvtva8vEkG%2Fuploads%2FFqJwhawbtFCJ0xvOMQa4%2Finstallation_toolUI.jpg?alt=media&#x26;token=33ca756f-66a8-40be-b2eb-82f9dc17c302" alt=""><figcaption></figcaption></figure>

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