Using the Refresher - Launcher

Launch the Refresher

This feature is only avaliable in XGT Refresher V1.2. (Released July 21, 2026)

Be sure to use the correct Python version as the XGT Refresher you downloaded, and point the directory to the xgt_refresher.pyc.

For the following example, the Py3.11 XGT Refresher was downloaded, and will use Py 3.11 to launch it.

Windows

In a Windows PowerShell enter the following to start the refresher.

py -3.11 "D:\Studio\xgt_refresher\xgt_refresher.pyc"

Linux

In a Terminal

python3.11 D:/Studio/xgt_refresher/xgt_refresher.pyc

Refresher UI

Refresher folder - Path to where this refresher is installed.

Python - Python versions currently installed in your machine, when launch the refresher, the tool will automatically select the version from your launch code.

license.json targets - Groomer's Tool License files to be activated/refreshed.

License Key / Email - A studio license key is provided when you subscribbed to Groomer's Tool. Enter the license key and the registered email to activate, or re-validate your studio license.

---

First Activation - No Maya Required

1. Add a license.json file - This is located inside the xgtc folder from Groomer's Tool main package.

2. Enter your Studio License Key and Email

3. Click on the Refresh License

4. When the license is activated, the log will show Refreshed: 1, Failed:0

Your License is now activated, and Groomer's Tool is ready to run in your studio.

Share the following code to your artists and ask them to run from a Maya Python tab. You do not need to share the files.

import sys
xgtcPath = 'D:/Studio/share/windows/'
# 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()

---

On License Re-Check Day - Quick Refresh

Start the XGT Refresher again Launch the Refresher

From the first activation, the path to the license.json path is saved, and should automatically show in the list.

1. If the license.json file does not appear, simply add it again.

2. You do not need to enter the License Key or Email for regular refresh. Click on the Refresh License button.

3. When the license is refreshed, the log will show Refreshed: 1, Failed:0

Artists in your studio can continue to have access to Groomer's Tool without an internet until the next refresh date.

---

Multiple Projects with Differnt Maya Versions

Studios can have multiple shows running in different OS, or Maya versions that requires Groomer's Tool.

For each Maya version (2023, 2025), or OS (Windows vs Linux), we will require its own Groomer's Tool to be installed in the system. For example,

If you happen to have a project running in Windows, and another in Linux, you may have this folder structure:

/Studio/share/linux/xgtc
/Studio/share/windows/xgtc

Or, if you are running Maya 2023, and Maya 2025 at the same time:

/Studio/share/2023/xgtc'
/Studio/share/2025/xgtc'

Each of these xgtc folders contains a license.json file, and they will need to be refreshed on re-check days.

Start the XGT Refresher Launch the Refresher

To refresh/re-validate multiple license file at the same time, you can use the "Search Folder" button

Browse to a folder where you put all Groomer's Tool's verions. (In our example, D:/Studio/)

The launcher will automatically detect all the license.json and add them to the list. The log will show it.

Click on "Refresh License" to refresh the listed licenses at once.

On successfuly multiple license refresh, your log should print something like:

[XGT] Refreshed: 2 , Failed: 0

---

Automatic Scheduled Refresh

If your studio has an automatic task scheduler such as Windows Task Scheduler, or Cron Job, you can click on the "Copy" buttons (Copy Windows/Linux), and re-use the codes in those tools.

You need to have the license activated at least once in order to have the working code copied.