Search

How to Troubleshoot the Spektrix Box Office App

Dave Carr
Dave Carr
  • Updated

The Spektrix Box Office App software enables Spektrix in the cloud to communicate with hardware installed on your PC. For example, ticket printers or PIN Pads / Chip Readers

This article explains how to troubleshoot problems registering or using the Spektrix Box Office App. 

Permissions Windows Administrator

 

Before troubleshooting, sure you're familiar with:

Jump to the issue you’re experiencing when using the Box Office App

TIP: When following the troubleshooting guidance in this article, you may see a Windows User Account Control screen pop up asking “Do you want to allow this app to make changes to your device? ”Click Yes to proceed. “

 

Before you start troubleshooting

If you experience any issues when using the Box Office App or with devices connected to it, first check the following:

  • You have Windows Administrator permissions on the PC you're using with the Box Office App. Check with your IT team if unsure.
     
  • Microsoft .NET Framework 4.71 or later installed on your PC. To check the version of .Net installed, follow the steps in How to determine which .NET Framework versions are installed.
     

Next, check if the Box Office App is running. To resolve any issues, there may be occasions where you need to manually start or restart the Box Office App.

  • How to manually start the Box Office App

    When the Box Office App is running, you’ll see this icon in your system tray:

    box_office_app_connected.png

    If you can’t see this icon, you’ll need to manually start the Box Office App. Before doing so, check if the Spektrix App Service is running in Windows Services. You'll either need administrator permissions or your IT team to start the service for you. Follow these steps:

    1. Click the Windows button in your taskbar. Search for Services and select it from the options that appear.

    2. In Services, find the Spektrix App Service:


    3. If the app status displays Running, then proceed to step 5. If the service is not running proceed to step 4.

    4. If the Spektrix App Service is not running, right click on the Spektrix App Service and select Start. Wait for the service to start and then proceed to the next step.

    5. On your PC, browse to C:\Program Files (x86)\Spektrix Ltd\LocalApp\Gui.

    6. Double click BoxOfficeAppGui.exe to run the Box Office App. To save time, you can add a shortcut to BoxOfficeAppGui.exe on your desktop.

    7. Right click on BoxOfficeAppGui.exe.

    8. Select Show more options.

    9. Click Send to > Desktop (create shortcut).

  • How to Restart the Box Office App

    To restart the Box Office App in Windows Services, you’ll either need administrator permissions or your IT team to restart the service for you. Follow these steps:

    1. Click the Windows button in your taskbar. Search for Services and select it from the options that appear.

    2. In Services, find the Spektrix App Service. Right click and select Restart:


    3. The App icon will turn green when registered and connected. If the App icon is grey with a red exclamation mark and you’re connected to the internet, register the Box Office App.

 

Why can't I register or log in to the Box Office App?

After installing the Box Office App, you’ll need to register it. If you experience an issue registering the App or logging in after registration, click on the tab below relevant to your error.

 

Why isn't the Box Office App connecting?

The Box Office App should connect automatically within a few minutes of turning on your PC. This depends on the speed of your PC and other programs which load at startup. When the Box Office app is connected, you’ll see this icon in your system tray:

box_office_app_connected.png

A grey Box Office App icon with a red exclamation mark means the App is either not connected or registered:

box_office_app_not_connected.png

You may also see a disconnected message in the system tray.

Check the following:

 

Why does the Box App freeze or crash on startup?

The Box Office App should connect automatically within a few minutes of turning on your PC. This depends on the speed of your PC and other programs loading at startup. To enable quicker App startup, follow these steps:

  1. Click the Windows button in your taskbar. Search for Services and select it from the options that appear.
  2. In Services, find the Spektrix App Service. Right click and select Properties.

  3. In the General tab, click the dropdown next to Startup type and change to Automatic and click Apply > OK:


 

Why does the Box Office app connection keep dropping?

You can change how the Box Office App responds to a dropped connection in Windows Services. To do this, follow these steps:

  1. Click the Windows button in your taskbar. Search for Services and select it from the options that appear.
  2. In Services, find the Spektrix App Service. Right click and select Properties.
  3. In the Recovery tab, look for First failure, Second failure and Subsequent failures.
  4. Click the dropdown and change each to Restart the Service. Click Apply > OK:

 

Why does the Box Office App keep crashing or not show in the system tray?

When the Box Office App is running, you’ll see a green icon in the system tray:

box_office_app_connected.png

TIP: You may need to click the up arrow in the system tray to show hidden icons.

If you can’t see this icon, you’ll need to Restart the Box Office App in Windows Services.