The upload script
What it does, where it runs, and how to check it or remove it.
The script is required. The game client sends nothing itself, so without the script nothing reaches the website: no pairing, no live view, no history, no alerts and no commands.
Why there is a script
Many game clients leak memory every time they send something over the internet. After a few hours they slow down or crash. So the module never sends anything itself: it writes a few small files, and the upload script sends them.
What it does
- It looks for game clients with the module every 30 seconds, in the usual folders and in the ones you gave the setup.
- For each client it sends the character state every 2 seconds while you watch it on the website, and every 30 seconds otherwise.
- It sends screenshots when the website asks for them.
- It sends your client's minimap when it changes, so your own map on the website stays up to date. You can turn this off per client in Settings → Clients → Module.
- It brings back your commands.
It needs nothing else installed: Windows has PowerShell, and Mac and Linux have curl.
Where it runs
| System | The script | Starts at login through |
|---|---|---|
| Windows | %LOCALAPPDATA%\Voidwatch\upload.ps1 | a shortcut in your Startup folder |
| Mac | ~/Library/Application Support/Voidwatch/upload.sh | a login item, xyz.voidwatch.upload |
| Linux | ~/.local/share/voidwatch/upload.sh | a user service, voidwatch.service |
A client in another folder
The setup finds clients in the usual places. If yours is somewhere else, the game message shows its folder. Give it to the setup once:
- Windows: drop the folder onto
setup-windows.cmd. - Mac: run the setup again and drag the folder into its window.
- Linux:
sh setup-linux.sh "/path/to/voidwatch".
Is it running?
Open the live page. A character with a fresh "updated" time means the script works. Under Settings → Clients, every client shows when it was last seen.
Remove it
Double-click remove-windows.cmd or remove-mac.command, or run sh remove-linux.sh. That stops the script and deletes it. The module in your game client stays until you delete its folder.
Antivirus and warnings
- Windows SmartScreen or an antivirus may ask about a script from the internet. The script is plain text: open it in Notepad to read every line before you allow it.
- Mac: a double-click can say the file is "from an unidentified developer". Right-click it and pick Open instead.