Documentation

Setup Guide

Get HitScanTCG running on your stream in under 15 minutes.

Requirements

Before you begin, make sure you have the following:

Windows 10/11

macOS and Linux support coming soon

OBS Studio

Version 28+ recommended

Webcam

Any USB webcam or phone camera

Internet Connection

Required for AI card identification

Installation

  1. Download HitScanTCG

    Download the latest HitScanTCG installer from our official release page. Run the installer and follow the on-screen prompts.

  2. Sign In to HitScanTCG

    Create a free account or sign in. HitScanTCG handles all AI processing through our secure cloud.

  3. Launch & Scan

    Open HitScanTCG, select your camera, and start scanning. The guided setup will walk you through everything.

💾 Disk Space: The installer includes the full card database with 31,000+ cards and images, requiring approximately 700 MB of disk space.

Camera Setup

HitScanTCG works with any camera source your PC can see:

  1. USB Webcam

    Plug in your webcam — HitScanTCG will auto-detect it. If you have multiple cameras, select the one you want from the settings panel.

  2. Phone Camera

    Connect your smartphone as a webcam using any virtual camera app. Once your phone appears as a camera source on your PC, HitScanTCG will detect it automatically.

  3. Network Camera

    For network cameras, enter the camera's stream URL in the HitScan settings panel.

📷 Tip: Position your camera at a comfortable angle where you can hold cards about 6–12 inches away. Good lighting makes a big difference in scan accuracy.

Launching HitScan

Once installed, getting started is simple:

  1. Open HitScanTCG from your Start Menu or desktop shortcut
  2. Select your camera source in the settings panel
  3. Click Start Scanning — the overlay preview will appear
  4. Hold a Pokémon card in front of your camera and watch the magic happen

The application runs a local overlay server that OBS connects to — your stream sees a clean, transparent overlay with card info and pricing.

OBS Integration

Add the HitScan overlay to your OBS scene:

  1. Add Browser Source

    In OBS, click the + button under Sources and select "Browser".

  2. Set the URL

    Enter the overlay URL shown in the HitScanTCG app window.

  3. Set Resolution

    Set width to 1920 and height to 1080 to match your stream resolution.

  4. Enable Transparency

    Ensure "Shutdown source when not visible" is unchecked. The overlay has a transparent background and composites automatically over your camera scene.

✅ That's it! Start scanning cards by holding them in front of your camera. The overlay will appear on stream automatically.

Settings

Fine-tune HitScanTCG from the built-in settings panel:

Camera Source

Select which connected camera to use, or enter a network camera URL for remote sources.

Hold Duration

How long (in seconds) to hold a card steady before a scan triggers. Default: 3 seconds. Adjustable in the settings panel.

Scan Cooldown

Wait time between consecutive scans to prevent duplicates. Default: 3 seconds, with a 60-second sliding-window dedup for repeat cards.

API Budget

Maximum AI identification calls per hour (includes both identify and visual verify). Default: 400 calls/hour. Budget is persisted to disk and survives restarts.

Server Ports

The overlay and camera feed ports are configurable in the settings panel if the defaults conflict with other software on your system.

Troubleshooting

Camera not detected

Make sure your webcam is plugged in and recognized by Windows. Try selecting a different camera source in the HitScan settings panel. If using a phone camera, ensure the virtual camera app is running.

Scans not triggering

Hold the card steady in good lighting. HitScan's intelligent scan system checks for a stable image, card-like shapes, color, and motion before triggering. Hold cards upright in your hand rather than flat against a surface.

Low confidence results

Ensure good lighting and a clean, uncluttered background. Move the card closer to the camera. If confidence is consistently low, try increasing the Hold Duration in settings to give the camera more time to stabilize.

Overlay not showing in OBS

Confirm HitScanTCG is running and the overlay URL (shown in the app window) loads in your browser. In OBS, right-click the Browser Source and select "Refresh cache of current page".

Connection issues

HitScanTCG requires an active internet connection for AI card identification. Check your network connection and try restarting the application.