Running scripts

Use scripts to perform repeatable tasks on one or more clients, like updating software or changing settings.

Where scripts live

Windows: %APPDATA%/ShowTrakServer/Scripts
macOS:   ~/Library/Preferences/ShowTrakServer/Scripts
Linux:   ~/.local/share/ShowTrakServer/Scripts

Create a script

  1. Create a folder under Scripts with any name (e.g., UpdateChrome).
  2. Add a Script.json describing the script and an entry file (e.g., run.ps1).
  3. Optional: add assets (icons, supporting files) within the folder.

Example layout

Scripts/
  MyScript/
    Script.json
    run.ps1
    assets/
      icon.png

Minimal Script.json

{
  "Name": "Update Client",
  "Type": "powershell",
  "Path": "run.ps1",
  "LabelStyle": "light",
  "Weight": 0,
  "Confirmation": false,
  "Enabled": true
}

Run a script

  1. Open the Scripts panel in Server.
  2. Select one or more clients (or a whole group).
  3. Click a script to run; confirm if prompted.
  4. Watch progress in the execution queue.

How it works

  • The Server catalogs script folders and computes checksums for files to sync as needed.
  • The Client downloads the required files and executes the entry script according to its type.
  • Results and errors stream back to the Server UI.

Best practices

  • Keep scripts self‑contained and small for faster transfers.
  • Test on a single client before running across many.
  • Prefer idempotent scripts so re‑running is safe.