Windows

Owned by Luke Derrick
Last updated: Oct 10, 2024
2 min read

Setup

  1. Download the Gumband OS Monitor zip file at the bottom of this page, and extract its contents to the C: drive.

  2. Create an Exhibit and generate an ID and Token in Gumband.

  3. In the same directory as the executable, create a .env file and edit it to insert your specific tokens and variables:

    EXHIBIT_TOKEN=02b6903aece21b6sff520ac92dcba457 EXHIBIT_ID=1 # If the Gumband UI you're connecting to is not app.gumband.com, you'll # need to add two more environment variables here: # ENDPOINT=custom <----- indicates a custom IP # CUSTOM_IP=other.gmbnd.com <----- defines an endpoint that isn't app.gumband.com

  4. With those files saved, open the Windows Task Scheduler. This can be reached by typing "task" into the start menu search bar. The first result should be it.

  5. Select "Task Scheduler Library" from the left-side tree view.

  6. Choose "Import Task..." from the list of options on the right side of the window.

    1. Locate the file gumband_os_monitor_task.xml in c:\gumband-os-monitor\

    2. You will need to change the ownership:

      1. In the General tab, choose the “Change User or Group…” button,

      2. Enter your Windows Username or your Full Name in the text field

      3. Click “Check Names”, and your name should become underlined

      4. Click OK. The user account should change to something like <YOUR PC HOSTNAME>\<YOUR FULL NAME>

    3. Click OK and enter your user password to save this Task.

    4. Ensure that it is enabled

    5. NOTE: In order to update the executable, you will need to Disable this Task in the Scheduler and restart the PC before deleting or replacing the gumband-os-monitor-win-x64.exe file. Afterward, re-enable the Task and reboot once again.

Testing

  1. Reboot the host machine manually, to ensure the Windows Task Scheduler is setup correctly. Upon login, the OS Monitor should show as online in the Gumband UI:

The Gumband OS Monitor showing as “Online” in the Gumband UI. Note the online icon boxed in red.

  1. Check that taking screenshots is functioning. Click the "Take Screenshot" button on the "Control" tab in Gumband. It should upload a screenshot to the "Files" tab.

  2. Check that the reboot control is working. Click the "Reboot" button on the "Control” tab in Gumband. The host machine should reboot.

  3. When the host machine boots up again, the OS Monitor should automatically launch and connect to Gumband. In order to run, the OS Monitor will launch a Powershell window and minimize it when the user logs in.

Zip Download