Pokvice

Desktop prototype that captures a single GGPoker No-Limit Hold’em table from the screen (macOS and Windows).

GGPoker must be windowed or borderless — exclusive fullscreen will cover the overlay.

Start the app

Windows: double-click start-pokvice.bat

macOS: in Terminal, from this folder:

chmod +x start-pokvice.sh   # once
./start-pokvice.sh

The first run creates a local environment and installs dependencies. Later runs just open the app.

You need Python 3.11+ installed (python.org). On Windows, tick Add python.exe to PATH.

OCR models may download on the first launch and take a minute.

Usage

1. Open a GGPoker table in windowed mode.
2. Click Select table or press Ctrl+Shift+S (Windows) / Cmd+Shift+S (macOS).
3. Drag a rectangle around the table. Enter confirms; Esc / right-click cancels.
4. A teal outline stays on the table (click-through). The live panel docks beside it.
5. Click Calibrate layout. Draw boxes for pot, board cards, and each seat’s name/stack/button. Save.
6. Click Start. The panel shows live OCR (names, stacks, pot, board). Enable Save captured frames to write PNGs under data/captures/.

Permissions

• macOS: System Settings → Privacy & Security → Screen Recording (this app / Terminal). Global hotkeys also need Accessibility.
• Windows: no special capture permission. If the hotkey does not fire while GGPoker is focused, use the Select table button.

Layout

See GameScraperImplementationPlan.md. Inner ROI boxes are stored in config/layouts/ as normalized coordinates.