> For the complete documentation index, see [llms.txt](https://nobraintools.gitbook.io/maya-groomers-tool/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://nobraintools.gitbook.io/maya-groomers-tool/getting-started/installation-manual-install.md).

# 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.</mark>

4. <mark style="color:red;">There's a new Launch code as of 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>