Desktop install guide

Set up GGSight without guessing.

GGSight is a local desktop scanner because screen capture, OCR, scan zones, local storage, and match alerts need to run on your computer. The current distributed beta is Windows-only.

Unlock downloads Open full setup guide

Current platform

The distributed beta is Windows-only.

The Windows package includes the bundled app, game profiles, legal docs, installer, uninstaller, and the files needed to run the MVP scanner locally.

Windows

Best beta choice

Use this for Fortnite, Call of Duty, capture card previews, Remote Play windows, OBS previews, desktop notifications, and the easiest shortcut install.

Download Windows beta

macOS

Testing bundle

Use this for local OCR checks, screenshot testing, and future Mac scan-zone support. The current public beta is source-style.

Validation pending

Linux

Power-user bundle

Use this for OCR validation, dataset work, and Linux desktop testing. Package signing and native installers come later.

Validation pending

Windows quick install

The clean Windows path.

The Windows installer creates the GGSight runtime folder and shortcuts when permissions allow. Always extract the zip first and verify the hash when possible.

Download the Windows beta

Go to the download page, accept the Terms of Service and Stream Sniping Policy, then choose Download for Windows.

Extract the zip

Right-click the downloaded zip and choose Extract All. Do not run GGSight from inside the compressed zip preview.

Verify the download

Open the Download Safety Center and compare the SHA-256 hash before running the installer. If it does not match, delete the file.

Run the installer script

Open PowerShell in the extracted GGSight folder and run:

cd C:\path\to\GGSight
powershell -ExecutionPolicy Bypass -File .\desktop\install_windows.ps1 -InstallTesseract -RunAfterInstall -AllowUnsignedBeta

Launch from the desktop icon

Use the GGSight desktop shortcut or Start Menu shortcut. If Windows still shows an old icon, close GGSight and restart Windows Explorer.

Confirm OCR is ready

The recommended command uses Windows Package Manager to install Tesseract after explicit opt-in. GGSight also auto-detects an existing install at C:\Program Files\Tesseract-OCR\tesseract.exe.

Pick your first scan zone

Select the game, choose the visible source window or monitor region, draw a tight box around the gamer-tag feed, test OCR, then start scanning.

Uninstall cleanly

Open Start Menu > GGSight > Uninstall GGSight. Normal removal preserves your local settings and scan history. For complete removal, run uninstall_windows.ps1 -RemoveUserData from the extracted download folder.

macOS status

Public build not available yet.

macOS packaging, capture behavior, OCR dependencies, and release validation must be completed before a public download is offered.

Linux status

Public build not available yet.

Linux packaging, capture behavior, OCR dependencies, and release validation must be completed before a public download is offered.

After install

Make the scanner read player names, not random HUD text.

Good scan zones matter more than giant scan zones. Smaller boxes are faster, cleaner, and less likely to pick up random words.

Fortnite

Draw around the left-side kill feed and bus-driver feed. GGSight should capture the left actor name and ignore duplicate reads inside the same match.

Call of Duty

Draw around the right-side lobby roster when finding a match. Use the COD preset so lobby labels are ignored and gamer tags are kept.

Two monitors

Draw the zone on whichever monitor contains the game, capture card preview, OBS preview, PS Remote Play, or Xbox Remote Play window.

Notifications

Choose desktop, sound, or private Discord alerts. Open Setup to paste and test a Discord channel webhook. All channels share confidence and duplicate cooldown rules.

Privacy

GGSight reads visible pixels only. It does not inspect game memory, inject code, read network packets, or reveal hidden players.

Troubleshooting

If no names appear, shrink the zone, test a still screenshot, check that Tesseract OCR is installed, and choose the correct game preset.

Manual fallback

If the installer cannot run, start it manually.

This fallback is useful for developers and beta testers. Most Windows users should use the installer script above.

python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -r requirements.txt
python -m ggsight.app