> 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-studio/using-the-refresher-terminal.md).

# Using the Refresher - Terminal

## Setting Up XGT Refresher

Please see [Using the Refresher - Launcher](/maya-groomers-tool/getting-started/installation-studio/using-the-refresher-launcher.md#setting-up-xgt-refresher)

***

## Windows

### First Activation - No Maya Required

You can use this code to activate the license.json file for the first time. 

Make sure to change:

* env path
* path for the xgt\_license\_refresh.pyc
* path for license.json
* license key 
* email

```powershell
# Point to actual refresher folder
$env:XGT_XGTC_SCRIPTS = "D:\Studio\xgt_refresher\" 

py -3.11 D:\Studio\xgt_refresher\xgt_license_refresh.pyc `
  --path "D:\Studio\share\windows\xgtc\license.json" `
  --license "XGT-1234ABCD-1234ABCD" `
  --email "email@company.com" `
  --verbose
```

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. 

```python
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()
```

***

### Refresh On Re-Check Days with simple command

```powershell
# Point to actual refresher folder
$env:XGT_XGTC_SCRIPTS = "D:\Studio\xgt_refresher\" 

# Point to actual refresher folder and the license.json in xgtc folder
py -3.11 D:\Studio\xgt_refresher\xgt_license_refresh.pyc `
  --path "D:\Studio\share\windows\xgtc\license.json" `
  --verbose
```

### **Expected success output:**

```
[XGT] Loading license from: D:\Studio\share\windows\xgtc\license.json
[XGT] Calling Gumroad/Render verify… 
[XGT] Snapshot state: ('ok', {}); last_check=YYYY-MM-DD; is_studio=True
[XGT] License refreshed and written.

# .json must be set to "writable" to the refresh machine.
# you can check the license.json time stamp to see if it updates.
```

***

## Linux

### First Activation - No Maya Required

```bash
# Point to refresher folder
export XGT_XGTC_SCRIPTS=”D:/Studio/xgt_refresher/”

python3.11 D:/Studio/xgt_refresher/xgt_license_refresh.pyc \
  --path "D:/Studio/share/linux/xgtc/license.json" \
  --license "XGT-1234ABCD-1234ABCD" \
  --email "email@company.com" \
  --verbose 
```

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. 

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

***

### Refresh On Re-Check Days with simple command

```bash
# Point to refresher folder
export XGT_XGTC_SCRIPTS="D:/Studio/xgt_refresher/"

# Point to actual refresher folder and the license.json in xgtc folder
python3.11 D:/Studio/xgt_refresher/xgt_license_refresh.pyc \
  --path "D:/Studio/share/linux/xgtc/license.json" \
  --verbose
```

### **Expected success output:**

```
[XGT] Loading license from: D:/Studio/share/linux/xgtc/license.json
[XGT] Calling Gumroad/Render verify…
[XGT] Snapshot state: ('ok', {}); last_check=YYYY-MM-DD; is_studio=True
[XGT] License refreshed and written.

# .json must be set to "writable" to the refresh machine.
# you can check the license.json time stamp to see if it updates.
```

***

### Duplicating Jobs for Multiple Targets

**Running Groomer's Tool on different projects (different OS/Maya)**

* Duplicate the task and change only the `--path` argument, e.g.:
  * ```
    D:/Studio/share/linux/2023/xgtc/license.json
    ```
  * ```
    D:/Studio/share/win/2025/xgtc/license.json
    ```
  * Then, create additional tasks pointing at other versions/builds.
  * You can use the same refresher to refresh different builds of Groomer's Tool license.

```powershell
# Still using the same refresher path
export XGT_XGTC_SCRIPTS="D:/Studio/xgt_refresher/" 
# As long as it match with refresher box Py version,
# multi-refresh can still use the same refresher script

# Refresh license.json (on a Linux Maya 2023 project)
python3.11 D:/Studio/xgt_refresher/xgt_license_refresh.pyc \ # Same Refresher 
  --path "D:/Studio/share/linux/2023/xgtc/license.json" \
  --verbose
  
# Refresh license.json (on a Windows Maya 2025 project)
python3.11 D:/Studio/xgt_refresher/xgt_license_refresh.pyc \ # Same Refresher 
  --path "D:/Studio/share/win/2025/xgtc/license.json" \
  --verbose
  
```