Skip to content
Cart
cload
Checkout Secure

How to Use GSPro with the ProTee VX: Complete Setup Guide

Share this article

The VX is on the ceiling, the course is loaded, and the screen says it cannot connect. This guide gets you past it, one step at a time.

The ProTee VX is a ceiling-mounted launch monitor that works with GSPro: more than 2,500 community-built courses, 24 ball, club and flight data points, and no subscription on the launch monitor side. But ProTee's GSPro integration runs through a specific license type and a connector flow that is easy to get wrong the first time.

This guide walks through the full setup in order: GSPro license conversion, ProTee Labs game-options configuration, the GSPro API connection, PC specs, VSync settings, putting setup, and the fixes for the most common connection errors.

What You Need Before Starting

The VX talks to GSPro through ProTee Labs and the GSPro API. Confirm you have all of the following before opening any software:

  • Mounted ProTee VX with the included Cat6 Ethernet cable connected to your PC (use the included USB 3.0--to--Ethernet adapter on a blue USB3 port if your network is already hardwired).
  • ProTee Labs installed and activated on your Windows PC (Top Shelf Golf includes the activation code with your VX order).
  • A GSPro license set to the ProTee VX hardware type.
  • A Windows PC that meets the GSPro requirements. ProTee recommends an NVIDIA RTX 3080 or better, 32 GB of RAM, and at least 20 GB of free storage for optimal 4K performance. The ProTee Labs minimum (64-bit Windows 10, Intel Core i7-8xxx, 8 GB RAM) is lower than what GSPro needs at higher resolutions.
  • An internet connection for the license, downloads, and the GSPro API.

If you do not have a sim PC yet, our guide on whether you need a dedicated simulator computer walks through SurfThing prebuilds that are configured for GSPro out of the box.

Step 1: Confirm the VX Is Mounted and ProTee Labs Is Running

Before you open GSPro, make sure your hardware path is healthy.

  1. Power on the ProTee VX with the red switch on the back of the unit.
  2. Launch ProTee Labs on your PC. Go to Settings > Device, select ProTee VX from the device list, and click Connect.
  3. Wait until the status in the upper right reads "CONNECTED."
  4. If this is your first session, run through the camera calibration flow (place the calibration plate flat in the hitting area, level it with the included bubble level, click Calibrate System, then Calibrate World, and define your play area).
  5. Hit a test shot. ProTee Labs should display ball speed, club speed, and the rest of the 24 data points.

If Labs cannot find the VX, the most common fix is to use the supplied USB-to-Ethernet adapter on a blue USB 3.0 port rather than a USB 2.0 port. ProTee's knowledge base also notes that the VX requires at least a 1 Gbit network connection over Cat6 or higher.

Step 2: Set Your GSPro License to ProTee VX

GSPro sells separate license types per launch monitor. Your license has to be tied to the ProTee VX hardware before it can talk to ProTee Labs.

  1. Buy a GSPro license through TSG's GSPro product page.
  2. If you already own a GSPro license for a different launch monitor (for example, a SkyTrak or Garmin license), open the GSPro License Conversion Tool and select ProTee VX as your new hardware. This conversion is the first fix ProTee support lists for "Connection Failed to GSPro" errors.
  3. Install GSPro on the same Windows PC that runs ProTee Labs.
  4. Update ProTee Labs to the latest stable or beta version before continuing. ProTee says updating ensures compatibility with new features and fixes, and its release notes include GSPro connection improvements.

Step 3: Configure ProTee Labs Game Options

ProTee Labs is the bridge between the VX hardware and GSPro. The bridge is configured under Settings > Game Options.

  1. In ProTee Labs, open Settings > Game.
  2. Find the GSPro integration entry. Confirm the connector is enabled.
  3. Leave the default host as localhost. ProTee's support team recommends not changing this unless their team specifically tells you to.
  4. Save the settings and keep ProTee Labs running in the background.

Step 4: Open GSPro and the GSPro API Together

  1. Launch GSPro on your Windows PC.
  2. Launch the GSPro API as a separate program. ProTee's instructions call for both to stay open, so GSPro by itself is not enough.
  3. Per ProTee's knowledge base: "After activation, ensure that both the GSPro API and GSPro remain open while connecting in Labs settings under the Game Options."
  4. In ProTee Labs, open Settings > Game Options and click Connect next to GSPro.
  5. The connector should report a successful link.

Step 5: Fix "Connection Failed to GSPro" Errors

The error message "Connection Failed to GSPro" points to the GSPro license type. ProTee support's fix:

  1. Open GSPro and click Change License Type.
  2. Go to the GSPro License Conversion Tool and select ProTee VX.
  3. In the connector, click Clear setting and restart the connector, then in GSPro go to Settings > Game > System > Reset GSPro connect and choose ProTee VX.
  4. Retry the connection from ProTee Labs.

If the error persists, check that the GSPro API window is still open (it sometimes minimizes silently) and that no firewall is blocking the local connection. ProTee recommends connecting the VX directly to your PC's Ethernet port over the network for stability.

Step 6: Optimize GSPro Graphics for the ProTee VX

Once the connection is solid, ProTee's graphics-tuning guidance for GSPro on a VX comes down to a couple of settings.

  1. Enable VSync in GSPro. Per ProTee support: enabling VSync prevents GSPro from grabbing more GPU than it needs, which can otherwise interfere with the VX connector. Press F in GSPro to toggle the FPS counter and verify your frame rate is stable.
  2. Match GSPro resolution to your projector or display.
  3. Lower object detail and tree count if your frame rate dips below 60 fps. GSPro's default settings target high-end PCs.
  4. For a dedicated GPU, make sure GSPro is running on the dedicated card rather than integrated graphics. On Windows: Settings > Gaming and add GSPro to the high-performance GPU list.

Putting with GSPro on the ProTee VX

Putting in GSPro on a VX has two quirks worth knowing.

Ball position. The ProTee VX detection area is approximately 25" x 21" (65 x 55 cm). ProTee support suggests marking a point on the floor or hitting strip where the ball should be placed for putting. Do not use white for the mark.

Green speed. Green speeds in GSPro can be fixed by the course or tournament setting and may not be user-adjustable. If your putts feel too fast or slow, try a different course or check the tournament settings before assuming the VX is wrong.

Why ProTee Labs and GSPro Show Different Numbers

You will sometimes see a different carry distance or apex height in ProTee Labs versus what shows up in GSPro on the same shot. This is expected.

Per ProTee's knowledge base: ProTee Labs and GSPro use different ball-flight models. Carry distances can vary between ProTee Labs (which uses the Driving Range physics), TGC 2019, GSPro, and other simulation software, plus factors like altitude, temperature, and humidity that some GSPro courses apply.

In practice:

  • The club selected in GSPro overrides ProTee Labs' auto-detect during a round, so if Labs shows the wrong club, it usually means GSPro is forcing the selection. Change the club in GSPro, not in Labs.

Recommended PC Specs for GSPro + ProTee VX

ProTee publishes a baseline PC spec for the VX hardware itself, plus a higher recommendation for running GSPro at 4K.

Component ProTee VX Minimum (ProTee Labs) GSPro 4K Recommended (ProTee)
OS 64-bit Windows 10 64-bit Windows 10 or 11
Processor Intel Core i7-8xxx @ 3.00 GHz or AMD equivalent Modern Intel / AMD Ryzen with dedicated GPU support
RAM 8 GB 32 GB
Graphics NVIDIA RTX 3060 or equivalent NVIDIA RTX 3080 or better
Storage 5 GB available 20 GB available (more for course downloads)
Network Wired Ethernet, 1 Gbit minimum (Cat6 or higher) Same; broadband internet for GSPro API
macOS support Not supported Not supported (Windows only)

If you would rather not build the PC yourself, SurfThing prebuilt PCs come ready to run GSPro. The SurfThing SG3-5602 is optimized for 1080p and 1440p with 16 GB of RAM. For 4K, the SurfThing SG3-5702Ti pairs an RTX 5070 Ti with 32 GB of RAM. See our simulator PC guide.

Common ProTee VX + GSPro Issues and Quick Fixes

"Connection Failed to GSPro" in ProTee Labs

License-type mismatch. Open GSPro, click Change License Type, run the GSPro License Conversion Tool, and select ProTee VX. Restart GSPro and the GSPro API.

The wrong club shows up on a shot

When ProTee Labs is connected to GSPro, GSPro's selected club takes priority over Labs' auto-detect. Change the club in GSPro, not in Labs.

Frame rate drops in GSPro

Enable VSync in GSPro. Lower object detail / tree count. Confirm GSPro is running on your dedicated GPU instead of integrated graphics.

Does the VX work with GSPro multiplayer?

Yes. Per ProTee support, the VX works with all GSPro gameplay modes, including multiplayer. The game mode you choose in GSPro does not affect VX tracking or data quality.

Distances feel too short or too long

GSPro courses apply altitude, temperature, and humidity. Check the course settings, then compare against the ProTee Labs Driving Range, which uses ProTee's flight model rather than GSPro's.

CEILING-MOUNTED A.I. LAUNCH MONITOR

ProTee VX Golf Launch Monitor & Golf Simulator

$6,500
ProTee VX ceiling-mounted launch monitor on white background
SPECS
  • Tech: Machine vision + A.I., dual high-speed cameras
  • Placement: Ceiling-mounted (bracket included)
  • Data points: 24 ball, club, and flight metrics
  • Cameras: 2 ProTee Swing Cameras included
  • Hitting zone: 25" x 21" (65 x 55 cm)
  • Software: ProTee Labs included; GSPro + TGC 2019 supported
PROS
  • No club stickers and no marked balls required
  • Dual high-speed cameras + built-in IR illumination
  • Lefty / righty switch in seconds, no recalibration
  • No recurring software fees on the launch monitor side
  • Strong GSPro integration through the ProTee Labs connector
CONS
  • Windows-only (no Mac, iOS, Android, Linux)
  • 9 ft minimum ceiling height
  • GSPro 4K performance wants RTX 3080 or better, 32 GB RAM

Planning the room around a VX? The ProTee VX DIY Enclosure Golf Simulator puts it on the ceiling above a Carl's Place DIY enclosure with a premium impact screen in six sizes, a Real Feel hitting mat and a short-throw laser projector with its ceiling mount. Every pick updates the price and the 3D view, and the whole build goes to your cart as one package.

Enter your room size, see every part that fits →

Compare all launch monitors side by side →

← Older Post Newer Post →