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. Start with Windows for the best beta experience, then use macOS or Linux for testing and OCR validation.

Unlock downloads Open full setup guide

Choose your computer

One scanner, three beta packages.

Every package includes the desktop app source, game profiles, legal docs, install scripts, 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.

Download macOS beta

Linux

Power-user bundle

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

Download Linux beta

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 -RunAfterInstall

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

GGSight auto-detects standard Tesseract installs at C:\Program Files\Tesseract-OCR\tesseract.exe. Install Tesseract separately if the app says OCR is missing.

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.

macOS beta

Run the Mac test bundle.

The macOS bundle is currently for beta testing and OCR validation. Extract the zip, open Terminal in the folder, then run:

cd /path/to/GGSight
chmod +x desktop/install_macos.sh
desktop/install_macos.sh --run

Linux beta

Run the Linux test bundle.

The Linux bundle is source-style for power users. Extract the zip, open a terminal in the folder, then run:

cd /path/to/GGSight
chmod +x desktop/install_linux.sh
desktop/install_linux.sh --run

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

Enable desktop alerts and sound ping only when you want popups during a match. Raising confidence thresholds keeps alerts quiet.

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