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:

1. Open the app and tap Tournaments or Cash Games from the home tab.
2. Tap the + New button to create a session.
3. Enter your tournament name and buy-in — or scan a blind structure to auto-fill everything.
4. Tap Start. Your session is live.
5. Use the AI chat bar at the bottom to update your stack: just type I have 45k.

Navigation

The app has three main tabs at the bottom of the screen:

During an active tournament session, returning to the app after 5+ minutes away automatically lands you back on the Tournaments tab — quick app switches keep your place.

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

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.

1. On the New Tournament screen, tap Scan Poker Atlas Screenshot.
2. 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.
3. The app runs OCR on the image(s) and extracts blind levels, starting chips, buy-in, and venue name where available.
4. 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.

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.

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:

1. Tap the card button next to the chat input (or the + on the Hands pane).
2. Pick your two hole cards.
3. 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 — designed for fast, tap-only entry with no typing required.

Setup

• Level — defaults to the current blind level; tap it to pick any level from your structure.
• Your stack — defaults to your tracked stack with a Use current shortcut; editable if the hand started from a different count.
• Position & hole cards — tap to select.
• Villains — tap Add Villain for each opponent: position, relative stack (covers you / you cover), and later their shown cards if they table a hand.

Actions

Enter actions street by street — fold, check, call, bet, raise, all-in. The app tracks the pot live, advances streets automatically when action closes, and narrates the hand as you build it.

• Preflop sizing — one-tap presets in big blinds (2bb, 2.5bb, 3bb…).
• Postflop sizing — pot-fraction presets (⅓, ½, ⅔ pot…).
• Custom amounts — type any number; it's taken as the total bet. Add bb (e.g. 4bb) to enter big blinds instead of chips.
• All-In — a dedicated button that 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, even if you entered it as a raise.
• Board cards — pick the flop, turn, and river as they're dealt; mis-taps can be deleted.

Once an all-in is called and at most one player has chips behind, the betting prompts stop — the app 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 card picker includes a fifth option — x — 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

Enter shown cards at showdown and the app evaluates the hands and determines the winner automatically — pot size and your net win/loss are computed from the action. You can override the winner or pot if the hand played out unusually. Then tap Save.

One honest exception: if any card at showdown has an unknown suit, the app won't guess (a possible flush can't be proven) — you pick the winner with the override control before saving.

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:

1. Speak the hand as you remember it — cards, action, the story, anything.
2. Watch the live transcript as you talk, then tap Done.
3. 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.
4. 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:

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).

Share Cards

After ending a session — or from any past session recap — tap Share to create a polished image card. Three formats are available:

• Stories — 9:16 vertical format for Instagram/TikTok Stories
• Feed — 1:1 square format for Instagram/Twitter feed posts
• Quote — minimal card with a key stat or quote from your session

Cards include your result, profit/loss, session details, and a mini stack graph. Tap Post to X to share directly to X/Twitter, or use the native share sheet to send anywhere.

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.

Themes

Three dark themes are available, all designed for low-light poker room conditions. Change theme in Settings → Theme.

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.