Technical Specification — Poker Table Parser via Capture Card

🎯 Goal

Build a highly accurate and fast parser that processes poker table data in real time from a capture card feed, recognizes all required elements, and outputs the game hand line in our standard format.

⚠️ The parser’s task is pure parsing only (raw data extraction).
🚫 No analytics, EV calculations, or strategy logic.

📌 Requirements

1. Data Source
   • Input: capture card feed (video or screenshots).
   • Frequency: event-based (new action detected) or fixed interval (e.g., every 200ms).
2. What to parse
   • Hero’s hole cards (2 cards).
   • Board cards (street by street: Flop / Turn / River).
   • Player positions (UTG, MP, CO, BTN, SB, BB).
   • Player stacks in bb (convert from chips).
   • Pot size (POT) after each action.
   • Player actions (open, call, bet %, jam Xbb, etc.).
   • Game stage: PF / F / T / R.

3. Output format (single line)

    

   HAND: <POS> <HAND> | TABLE [ID]: <board or —> | POT <bb> | STACKS: <pos stack>... | LINE: PF <...> → F <...> → T <...> → R <...> → Hero act

4. When to output a line
   • After each active action (open / raise / bet / jam).
   • When the action reaches Hero.
   • 🚫 Skip folds.
5. PKO mode (bounties)

   • Add bounty info to stacks:

      

     BTN 24bb[$34]

6. Speed & Accuracy
   • Card recognition error ≤ 0%.
   • Stack recognition error ≤ 1bb.
   • Output update ≤ 0.5 sec after action.

📌 Example Outputs

Preflop

HAND: BB K♠️Q♦️ | TABLE [12]: — | POT 4.6bb | STACKS: UTG 28bb, MP 25bb, CO 31bb, BTN 18bb, BB(Hero) 22bb | LINE: PF UTG open 2.2bb → MP call → CO call → BTN call → Hero act

Postflop

HAND: BB 9♠️8♠️ | TABLE [12]: 9♣️ 7♦️ 2♠️ K♣️ 7♣️ | POT 12.3bb | STACKS: CO 27bb, BTN 24bb, BB(Hero) 19bb | LINE: PF UTG open 2.2bb → CO call → BTN call → BB call → F CO bet 33% (4.1bb) → BTN call → UTG fold → Hero call → T x/x/x/x → R BTN jam 18bb → Hero act

✅ Expected Result

• A ready-to-use tool (library / service) that:
  • Takes a frame →
  • Detects all objects (cards, stacks, pot, actions) →
  • Outputs a single line in the required format.
• Support for both cash games and tournaments (including PKO).