PokerStackTrackerPro
PokerStackTrackerPro is a native iOS app for tracking poker tournaments and cash games in real time. Use AI chat to update your stack naturally, log full hands in seconds with the Hand Logger (with voice dictation), scan blind structures with your camera, and review deep analytics to improve your game.
This manual covers every feature of the app. Use the sidebar to jump to any section.
Quick Start
Up and running in under two minutes:
- Open the app and tap Tournaments or Cash Games from the home tab.
- Tap the + New button to create a session.
- Enter your tournament name and buy-in — or scan a blind structure to auto-fill everything.
- Tap Start. Your session is live.
- Use the AI chat bar at the bottom to update your stack: just type
I have 45k.
Setting Up a Tournament
Tap Tournaments → + New Tournament. The setup screen has four sections:
Quick Setup (top section)
- Scan Poker Atlas Screenshot — take or upload a photo of a tournament poster or blind schedule to auto-fill the entire form. See Scanning Blind Structures.
- Browse Nearby Events — find tournaments shared by other players nearby via CloudKit.
- Share This Event — toggle to contribute this tournament's details to the shared pool (appears after filling in name and venue).
Fields
| Field | Description |
|---|---|
| Tournament Name | Any name you choose (required) |
| Game Type | NLH, PLO, Mixed, or a custom game type you've created in Settings |
| Venue | The card room or casino name |
| Buy-in / Entry Fee | Buy-in is the total cost of one entry; the entry fee is the portion the house keeps (the rest funds the prize pool) |
| Bounty Amount | Per-bounty value for PKO tournaments |
| Guarantee | Guaranteed prize pool (optional) |
| Re-entry Policy | None, 1, 2, or Unlimited re-entries |
| Starting Chips | Your starting stack (required) |
| Starting SB / BB | First blind level — auto-filled if you scan |
Blind Structure Editor
Tap Edit Full Blind Structure to enter the complete blind schedule. Each level includes: level number, small blind, big blind, ante, and duration (minutes). You can add break entries. If you scanned, the levels are pre-populated — review and edit as needed.
Scanning Blind Structures
PokerStackTrackerPro can read a blind schedule from a photo and auto-fill your tournament setup — no manual entry needed.
- On the New Tournament screen, tap Scan Poker Atlas Screenshot.
- Choose Camera to take a live photo, or Photo Library to upload one you already have. You can select up to 10 images at once for multi-page structures.
- The app runs OCR on the image(s) and extracts blind levels, starting chips, buy-in, and venue name where available.
- Review the pre-filled fields and make any corrections before tapping Start.
Pre-Game Scouting Reports
Once you have a blind structure loaded, tap View Scouting Report on the setup screen (or swipe to the Scouting pane during an active session).
The scouting report analyzes the structure and provides:
- Critical blind levels (when antes kick in, when ICM pressure increases)
- Estimated ITM bubble and final table timing by level
- Structure speed assessment (turbo, fast, standard, deep)
- Recommended opening strategy based on structure speed and game type
- Stack-to-blind warnings at key levels for your starting stack
Active Session — The 9 Panes
During an active tournament, swipe left and right through 9 panes. The status bar at the top (showing current stack, level, and elapsed time) stays fixed on every pane.
- Live chart of your stack over time
- Average stack overlay line
- Starting chips baseline
- Current M-ratio and BB count
- Zone badge + coaching tip
- Field size, players remaining
- Rebuys, bounties, add-ons
- Tap Investment to correct buy-in and fees
- Full blind schedule
- Current level highlighted
- Time remaining per level
- Timestamped chip stack photos
- Tap + to add a photo
- Stack count recorded with photo
- Capture your buy-in receipt
- Stamped with time and stack
- General session notes
- Stack count and blind level auto-attached
- Full hand logger — see Hand Logger
- Pending quick captures
- Swipe to share, edit, or delete
- Full message history
- Update stack via natural language
- Pre-game strategy report
- Viewable anytime during play
Status Bar (always visible)
The fixed bar at the top shows the tournament name, the current blind level (or the break countdown while on break), your big-blind count badge, and — once you've set a field size — a players-remaining counter with − and + buttons. Tap − each time someone busts (or + to undo); no need to leave whatever pane you're on. Bulk corrections still live in the Metrics pane's Players editor.
AI Chat Updates
The fastest way to update your session is through the AI chat bar at the bottom of the screen. Just type naturally — the app extracts what it needs.
What you can say
What gets extracted automatically
- Stack size — "32k", "32,000", "32 thousand"
- Players remaining — "310 left", "about 400 in the field"
- Blind level — "blinds are 500/1000/100 ante"
- Rebuys — "took a rebuy", "re-entered"
- Bounties — "knocked one out", "collected a bounty"
- Final result — "busted in 47th", "finished 3rd, won $1,200"
Quick Actions
Tap the quick action buttons next to the chat input for one-tap updates: Rebuy, Add-On, Bounty, and Break. The card button starts a hand Quick Capture.
Chat is also watching for big stack swings — after a large pot it offers to log the hand for you. See Big-Pot Detection & Break Debrief.
M-Ratio & Stack Zones
The app tracks your M-ratio (stack ÷ cost of one full orbit) and your BB count (stack ÷ big blind) in real time. Both are displayed in the status bar and Metrics pane.
| Zone | M-Ratio | BB Count | Strategy Tip |
|---|---|---|---|
| 🟢 Green | 20+ | 30+ | Comfortable. Play your full range and look for accumulation spots. |
| 🟡 Yellow | 10–20 | 15–30 | Getting shorter. Widen your opening range, look for re-steal spots. |
| 🟠 Orange | 5–10 | 8–15 | Push/fold territory approaching. Look to shove light from late position. |
| 🔴 Red | <5 | <8 | Critical. Push or fold only — any ace, pair, or two broadways is a shove. |
The zone badge in the status bar updates in real time as your stack and blind level change.
Notes & Chip Stack Photos
Session Notes (Pane 6)
Tap the + button on the Notes pane — or type note: table 14 is soft in chat — to jot a general session note. Your current stack size and blind level are automatically recorded with it.
Use this for table observations, meal breaks, seat changes, or anything worth remembering. For specific hands, use the full Hand Logger instead — it captures cards, actions, and results.
Chip Stack Photos (Pane 4)
Tap + on the Chip Stack Photos pane to take a timestamped photo of your stack. Each photo is stored with the timestamp, your current stack count, and the blind level at the time.
Buy-In Receipt (Pane 5)
Capture your buy-in receipt for record-keeping. The image is saved with the session.
Ending a Tournament
When your tournament is over, tap the End Session button (accessible from the status bar menu or bottom action bar). A sheet appears to record:
- Final position — where you finished
- Payout — your cash winnings (if any)
- Total bounties collected
- Additional notes
After confirming, you'll be taken to the Session Recap screen showing a full summary, and prompted to create a share card or video recap.
Hand Logger — Overview
The Hands pane (pane 7) is a full poker hand logger built around one idea: capture now, enrich later. At the table you only need a few seconds to save what matters — your hole cards. Everything else (actions, board, villains, result) can be added on a break or after the session, while it's still fresh.
There are three ways to get a hand into the app:
- Quick Capture — tap the card button, pick your hole cards, done. The hand waits in Pending Hands until you enrich it.
- Full entry — tap Log Hand and enter the whole hand with the tap-only Hand Capture Screen.
- Voice — dictate what you remember; the transcript attaches to the hand as your reference.
Saved hands appear in the Hands list with their result and net amount. Swipe right to share a hand, swipe left to edit or delete it. Every logged hand also flows into your session recap.
Quick Capture
When a big hand just happened and the next one is already being dealt, you don't have time for details:
- Tap the card button next to the chat input (or the + on the Hands pane).
- Pick your two hole cards.
- Done — the hand is saved to Pending Hands with the current level and your stack.
You can also type shorthand straight into chat — e.g. hand AKs — and the app creates the pending capture for you.
Later, tap the pending hand to open the Hand Capture Screen with everything pre-filled, and add the actions, board, and result. Or tap its mic to dictate what you remember instead.
The Hand Capture Screen
Tap Log Hand on the Hands pane to enter a complete hand. The screen is built around a control bar pinned to the bottom: whatever the hand needs next — your cards, the action, a bet size, the next board card — is always right there. You never scroll to find a control, and the keyboard never appears.
Setup
- Level — defaults to the current blind level; tap the header to pick any level from your structure.
- Your seat & cards — pick your seat, then the bar asks for your hole cards on a one-tap card grid (13 ranks × 4 suits, plus an x row for unknown suits — every card is a single tap). Tap Later if you'd rather add them afterwards.
- Your stack — defaults to your tracked stack with a Use current shortcut; editable if the hand started from a different count.
- Once set, the Hero section collapses to a chip row — seat · cards · stack. Tap any chip to change it.
- Villains — tap Add villain for each opponent: position and relative stack (covers you / you cover). The bar prompts you until the hand has at least one opponent.
Actions
The bar shows who's to act with their legal options — fold, check or call, bet or raise, all-in. A strip above the buttons always shows the street, the board so far, and the pot. The app advances streets automatically when action closes and narrates the hand as you build it.
- Bet sizing — tap Bet/Raise and preset chips take over the bar, sized to the spot: opening preflop offers 2bb · 2.5bb · 3bb · Pot; facing a bet or raise on any street offers Min · 2.5× · 3× · 4× · Pot (multiples of the bet you're facing); opening postflop offers ⅓ · ½ · ⅔ · Pot · 1.5×. Jam is always there.
- Exact amounts — tap # for an inline keypad (digits,
k,bb, delete) with a live preview of exactly what you'll commit — "Raise to 27,000". It's part of the bar, not the system keyboard. - All-In — fills the player's remaining stack in one tap. Shoves are also detected automatically: any bet, raise, or call that commits a player's last chip is recorded as all-in.
- Board cards — when a street closes, the bar switches to the card grid ("Flop cards (3)", "Turn card", "River card"). Picked cards appear in the strip; the last one can be removed until the next action.
- Undo — the arrow in the toolbar steps back one input; tapping any earlier action in the list rewinds the hand to that point.
Once an all-in is called and at most one player has chips behind, the betting prompts stop — the bar collects just the remaining board cards straight through to showdown. In multiway pots, betting continues normally while two or more players still have chips (side pots).
Unknown suits
Didn't catch a suit? The grid's x row is for any card whose suit you don't know. A♣Kx is a legal holding, and it works for your cards, villain hands, and the board.
Showdown & result
When a hand reaches showdown, tap who won — Hero won, [villain] won, or Chop — and Save lights up immediately. That's the whole requirement: you don't have to enter anyone's cards.
If a villain tables a hand and you want it on record, open Add shown cards. Once every live opponent's cards (or a Mucked mark) are in, the app evaluates the hands itself; if the cards disagree with the result you tapped, a banner says so with a one-tap Use cards. Entering cards after tapping a result replaces your tap — the cards are the better evidence. Hands that end when everyone folds need no tap at all.
One honest exception stays: if any showdown card has an unknown suit, the app won't guess (a possible flush can't be proven) — your tapped result stands.
Save closes the screen at once. A Hand saved toast appears on the Hands pane for a few seconds with a Share button if you want to send the hand right away.
Voice Dictation
Some hands are easier to say than to tap. Tap the mic button (on the Hand Capture Screen, the quick-capture sheet, or any pending hand) to open Voice Hand Entry:
- Speak the hand as you remember it — cards, action, the story, anything.
- Watch the live transcript as you talk, then tap Done.
- Edit the text — after you stop, the transcript becomes editable, so you can fix any mis-heard words right there. Need to add more? Tap Resume and new speech is appended after your edits.
- Tap Use Transcript. It appears as a collapsible reference card on the Hand Capture Screen.
From there it's your choice: enter the structured hand by tap using the transcript as your guide, or just save — the transcript alone is a perfectly good record. Transcript-only hands show a Dictated label in the hands list, and the full transcript appears in the hand's detail view, in shared hand histories, and in your session recap.
Transcripts stay editable forever: tap Edit on the Transcript section of any saved hand (or the pencil on the capture screen's transcript card) to correct the text later. Editing a transcript never changes the hand's logged actions or result.
Big-Pot Detection & Break Debrief
Big-pot detection
When you update your stack in chat and the change is a big swing, the app notices and offers to log the hand:
Big pot — +34,000 at Level 12. Log it? Just tell me your cards.
Reply with your hole cards and a quick capture is created on the spot. Adjust what counts as a "big pot" (or turn detection off) in Settings → Big-pot detection.
Break debrief
When you go on break, the app reviews your stack timeline and asks about any swings it can't account for:
Reply with your cards to create a hand capture, describe what happened to record it as a note, say later to defer, or skip today to turn debriefs off for the session. Either way, your session story stays complete — every swing ends up explained in the recap.
Sharing Hands
Share any logged hand as a clean, formatted text hand history — great for group chats, coaches, and study partners:
- From the hands list — swipe right on a hand and tap Share.
- From a hand's detail view — tap Share Hand.
- Right after saving — share the hand you just entered without leaving the capture flow.
The share text includes the level and blinds, your position, cards, and stack, the action street by street with board cards in suit symbols (K♠K♦ on J♥8♥4♦…), shown hands, and the result. You'll see an in-app color preview before sending; the shared text itself is plain text that pastes cleanly anywhere. If the hand has a dictated transcript, it's included as a Transcript block.
Starting a Cash Session
Tap Cash Games → + New Session. Fill in:
- Game Type — NLH, PLO, Mixed, or custom
- Stakes — e.g. 1/2, 2/5, 5/10
- Venue
- Buy-in Amount — how much you sat down with
Tap Start Session. The timer starts immediately.
Tracking Cash Sessions
Cash session tracking works the same as tournaments with the AI chat bar. Type your current stack at any point:
The status bar shows your current stack, profit/loss, hourly rate, and session duration in real time.
Swipe through panes for the stack graph, session stats, and hand notes.
Ending a Cash Session
Tap End Session and enter your cash-out amount. The app calculates your net result, hourly rate, and adds the session to your results history.
Results Dashboard
The Results tab shows your complete playing history at a glance:
- Cumulative profit/loss chart — your running total over time
- Summary stats — total profit, sessions played, ITM rate, biggest win
- Session list — all tournaments and cash sessions, sortable and filterable
Tap any session in the list to view its full recap, including the stack graph, timeline, and all notes and photos from that session.
Analytics Deep Dive
Tap Analytics within the Results tab for deeper breakdowns:
- ROI — return on investment across all sessions
- Win Rate / Hourly Rate — how much you make per hour
- Performance by Game Type — NLH vs PLO vs Mixed
- Performance by Venue — which card rooms are most profitable for you
- Performance by Stakes — for cash games
- Average field size and ITM rate — tournament-specific
- Biggest wins and losses
Use the filter bar to narrow results by date range, game type, or format (tournaments only / cash only).
Video Recaps
Tap Video Recap from the session recap screen to generate a short animated video of your session. The video shows:
- Animated stack graph building over time
- Key session stats overlaid
- Your final result
Tap Export to save to your Photos app or share directly to social media.
Milestones
The app automatically detects and celebrates key milestones:
- 🏆 First Cash — your first tournament cash
- 🥇 First Place — winning a tournament outright
- ⭐ New Personal Best — your biggest cash ever
- 👑 Final Table — making it to the final table
When a milestone is triggered, you'll see a special milestone card that you can share.
Import & Export
CSV Import
Go to Settings → Import Data to bring in historical sessions from a CSV file. Useful if you've been tracking in a spreadsheet and want to consolidate your history.
CSV Export
Go to Settings → Export Data to export all your sessions as a CSV file. Opens the native share sheet so you can save to Files, email, or open in Excel/Numbers.
iCloud Sync
PokerStackTrackerPro uses iCloud (CloudKit) to sync your data across all your Apple devices automatically. No setup required — as long as you're signed into iCloud, your sessions appear on every device.
Settings
Access Settings from the gear icon in the top-right corner of any main tab.
| Setting | Description |
|---|---|
| Default Game Type | Pre-fills the game type picker on new sessions |
| Default Starting Chips | Pre-fills starting stack for new tournaments |
| Default Payout % | Pre-fills the payout percentage field |
| Keep Screen Awake | Prevents your screen from sleeping during active sessions (on by default) |
| Haptic Feedback | Toggle vibration for key events |
| Theme | Choose between Midnight, Felt, and Classic dark themes |
| Custom Game Types | Add your own game types (e.g. "8-Game", "Stud") |
| Import Data | Import sessions from a CSV file |
| Export Data | Export all sessions to CSV |
Themes
Three dark themes are available, all designed for low-light poker room conditions. Change theme in Settings → Theme.
- Deep navy background
- Gold accent
- Best for dark card rooms
- Deep green background
- Classic casino felt look
- High contrast
- Rich dark brown
- Warm amber accent
- Traditional card room feel
Support
Found a bug or have a feature request? Open an issue on GitHub. We read every submission.
For privacy information, see our Privacy Policy.