Interactive poker hand history replayer — paste GG / PokerStars hand history, watch the hand play out on a visual table. Zero dependencies · Single self-contained HTML · Open directly in browser · MIT-licensed.
Hand Replayer turns boring plain-text hand histories into a visual, animated poker table. Paste your GG / PokerStars hand history, and watch each street play out — who raised, who folded, who won, and how the pot grew.
Hand Replayer 把枯燥的纯文本手牌历史变成一目了然的动态牌桌画面。粘贴 GG / PokerStars 的手牌历史，就能看到每条街的行动——谁加注、谁弃牌、谁赢下底池。
- Analyze faster — visual playback beats reading text line by line
- Share hands — export a self-contained HTML you can send to anyone
- Agent-ready — AI agents can generate replay HTML for you automatically
| Feature | Description |
|---|---|
| Paste & Play | Paste hand history text → instant animated replay / 粘贴手牌文本 → 即时动态回放 |
| GG & PokerStars | Both formats supported, with real sample hands included / 两种格式都支持，内置真实风格样例 |
| Self-contained | Single HTML file, zero dependencies, works offline / 单文件、零依赖、离线可用 |
| Export / Share | Export a fully self-contained HTML for sharing / 导出完全自包含的 HTML 用于分享 |
| Example hands | HU / 6-max / full-ring / GG / PS samples built in / 内置单挑/6人/9人/GG/PS 样例 |
- Download
index.html - Double-click to open in your browser
- Paste a hand history or click a sample button
# Python 3
python3 -m http.server 8000
# open http://localhost:8000Host the folder on any static file server (GitHub Pages, Netlify, etc.) — no backend needed.
- Copy a hand history from GG Poker or PokerStars (Hand History window → copy all)
- Paste into the text area
- Click Parse / 解析
- Watch the hand replay; use playback controls to step through
The repo ships with five examples in examples/:
| File | Format | Players |
|---|---|---|
example_hu.json |
pre-parsed JSON | 2 |
example_6max.json |
pre-parsed JSON | 6 |
example_fullring.json |
pre-parsed JSON | 9 |
example_gg.txt |
GG raw text | 6 |
example_ps.txt |
PokerStars raw text | 6 |
HandReplayer/
├── index.html ← self-contained app (HTML+CSS+JS, parser embedded)
├── parser.js ← development-only parser (merged into index.html on build)
├── SPEC.md ← full product spec (V2.1)
├── examples/ ← sample hands (fictional data)
└── LICENSE ← MIT
The release artifact is the single self-contained index.html — the parser is embedded in a <script> block. parser.js is the same code split out for development convenience; merge it into index.html before release (the shipped file is already merged).
开发态 parser.js 与发布态内嵌解析器是同一份代码。发布形态 = 单文件 index.html，解析器内嵌、零外部依赖。
MIT — see LICENSE.
Fictional sample data only. No real hand histories are included. 示例数据均为虚构。不包含任何真实牌局记录。