Help Center.

What LvLUP DB is

LvLUP DB is a poker intelligence platform. Import your hand histories and you get a personal stats dashboard, searchable opponent profiles, a visual hand replayer, and a decision tree that shows exactly how any player handles any spot.

Create your account

Sign up with email and password. No credit card required to start — the free tier tracks your own hands forever. Upgrade to Premium when you need advanced stats, unlimited searches, and deep filters.

Connect your screen names

Go to Settings → Screen Names and add the usernames you use on each poker site. This is how the app knows which player is you across imports, so My Stats can aggregate across sites.

• Winamax, PokerStars, GGPoker, and WPN (Americas Cardroom) are supported.
• Add as many aliases as you need — you can toggle which ones are included in stats at any time.

Upload your first hand history

From the dashboard, open Upload and drop in a .txt or .zip file from your poker client. The background worker parses, stores, and aggregates your hands — within seconds your stats populate.

Single mode — search by name

Type at least two characters of a player name. Matches appear as you type, ranked by sample size so the most studied players surface first. Click a player to load their full stats.

Multi mode — filter by stat range

Find every player matching a set of stat ranges. Example: VPIP > 40% and PFR < 10% to surface loose-passive fish. Results come back as a sortable table you can filter further.

Auto Classify

Tag every player in your database with an archetype — TAG, LAG, Nit, Fish, Whale, and more — in one click. Auto Classify scores each player against the archetype definitions using their actual stats and flags the best fit.

• Set a minimum hand sample so classifications only apply to players you've studied enough.
• Set a minimum confidence threshold to exclude borderline matches.
• Customize the stats and weights used by each archetype in Settings → Archetypes — the defaults are sensible, but you can tighten a nit or loosen a whale to your taste.

Widgets — customize the player view

The player view is built from widgets, the same as My Stats. Choose which stat tiles, charts, and tables appear and arrange them to match the way you study.

• Drag any widget to reposition it.
• Resize from the bottom-right corner.
• Add or remove widgets at any time — what's shown for one opponent is shown for every opponent you search.

Presets — save and switch layouts

Save a widget layout as a preset and switch between them with one click. Keep a lean preflop-focused preset for quick scouting and a deeper postflop preset for study sessions — flip between them without rebuilding the page.

Filters — drill into the right sample

Every widget on the player page respects the active filter set. Narrow to the conditions that matter for the spot you're studying instead of looking at a lifetime average that hides the real tendency.

• Stake range, date range, and tournament type (Vanilla, PKO, Mystery, Satellite).
• Speed (Regular, Turbo, Hyper-Turbo) and tournament stage (early, mid, bubble, final table).
• Position, stack depth, pot type, and more on Premium.

Clicking stats opens the replayer

Every stat card is clickable. Clicking 3-Bet opens the hand replayer filtered to hands where that player 3-bet. No export, no SQL — click-through from aggregate to action.

Save players for one-click access

Click the bookmark icon next to any player name to save them. Saved players appear as chips above the search bar — one click reloads their full stats without typing. Great for tracking specific opponents you want to come back to.

Player pools — group and aggregate

Tag players into named pools (e.g. LAGs, Fish, Regulars, your weekly crew) and search the pool as a single unit. You see aggregate stats across every player in the pool — useful for studying how a group plays a spot rather than one individual.

• Multi-select players in Multi-mode results and click Create Pool to build a group.
• Use Auto Classify to seed pools automatically by archetype.
• Open a pool to see averaged VPIP / PFR / 3-Bet / etc. across all members, then drill in the same way you would on a single player.

Freshness

Stats are recomputed by ClickHouse materialized views on every hand import. Minutes after your session ends, the hands you just played are reflected in every opponent's profile.

Screen names — who you are across sites

Register every username you use — across Winamax, PokerStars, GGPoker, and WPN — and My Stats aggregates them into a single view. This is how the app knows which player is you in every hand you import.

• Add as many aliases as you need, spanning any combination of sites.
• Retire an old alias to exclude it from your stats without deleting it — useful for seasonal accounts or experimental screen names you don't want polluting your headline numbers.
• Bring a retired alias back at any time; nothing is lost.

Widgets

Your dashboard is built from widgets. Profit charts, ROI / ITM trackers, stat tiles, and trend widgets can be added, resized, rearranged, and styled to your taste.

• Drag any widget to move it; resize from the bottom-right corner.
• Merge compatible widgets into a combined tile when two metrics belong side-by-side.
• Customize colors to mark what matters — winners, leaks, volume milestones — at a glance.

Presets

Pre-built layouts are included for quick review, deep study, and tournament-focused views. Pick one as a starting point and customize from there — or save your own preset and switch between them with one click.

Filters

Every widget respects the active filter set. Filter by stake range, date, tournament type, position, stack depth, pot type, and more.

Freshness

Stats are recomputed by ClickHouse materialized views on every hand import. Minutes after your session ends, the hands you just played are already reflected in your dashboard — no manual refresh, no waiting.

Controls

Step forward and backward action by action, jump to the next or previous hand, or play through at normal speed. The hand list on the side stays in sync.

Show hero cards

Toggle whether to see your own cards from the start of the hand or only when they would be revealed in a real session. Great for reviewing your reads without spoiling your own holdings.

Share a hand

Every hand has a shareable URL that opens the replayer directly. No account required to view — perfect for coaching, forum posts, and study groups with mixed tools.

Mobile

The replayer is fully responsive. Stacks, boards, and controls scale down to phone-sized screens so you can review on the go.

What it shows

A hierarchical view of every decision point a player has faced, with frequencies for each action. Open vs. limp, continue vs. fold to a 3-bet, c-bet vs. check, float vs. give up — every street, every action, node by node.

Hero vs Villain

The tree is built around two players — the Hero you're studying and the Villain you want exploits on. The pills in the breadcrumb visually distinguish them (blue underline for Hero, orange dashed border for Villain) so you can always see whose decision the current node represents.

• Fold equity callout: when Hero bets, the panel shows the Villain's fold rate broken down by Hero's bet size (small / medium / large / pot / overbet).
• Switch Hero or Villain at any time — your tree position is preserved, the frequencies just recompute for the new pair.

Multi-villain for multiway spots

Spots don't always end up heads-up. Add extra villains (V2, V3, V4) to study multiway decisions — useful for limped pots, family squeezes, and late-stage bubble scenarios where three or four players see a flop.

Navigating the tree

Click an action pill (bet, call, raise, check, fold) to drill one level deeper. The breadcrumb at the top records every action you've walked through — click any pill to jump back to that decision, or click a street label (FLOP, TURN, RIVER) to jump to the root of that street without rebuilding your filter.

Filters — isolate the exact spot

The advanced filters panel scopes the tree to the conditions you want to study.

• Pot type — SRP, 3-bet, 4-bet, limped.
• Position — per-player, for both Hero and Villain.
• Board texture — monotone / two-tone / rainbow, paired / unpaired / trips, connectivity.
• Hand category — premium pairs, broadway, suited connectors, draws, and more.
• Action line — exact preflop / flop / turn / river sequences.
• Bet sizing — percentage-of-pot ranges on flop, turn, and river.
• Stack depth and in-position vs. out-of-position.

Breakdowns and the distribution chart

Every node comes with a distribution chart showing action frequencies as a pie or bar. Use the Break Down By selector to split the same data by a dimension — hand category, position, board texture, bet size — and find where a player's strategy diverges across contexts.

Pin & Compare

Pin the current config, change filters or switch players, and a delta table shows the difference in every action's frequency (active − pinned). Ideal for before-and-after questions: how does this player's c-bet frequency shift when the pot is 3-bet instead of single-raised? How does Villain A compare to Villain B on the same board?

Sample sizes — with warnings

Every cell shows the underlying sample so you always know how much weight to put on a frequency. Preflop numbers stabilize faster than turn and river numbers — budget accordingly.

• Under 30 hands: flagged as insufficient; the number is shown but not to be trusted.
• 30–99 hands: low-sample warning; treat as directional, not definitive.
• 100+ hands: the flag goes away; weight the frequency normally.

Bookmarks — save a study

Save any filter set, breakdown, and tree position as a named bookmark with optional notes. Useful for questions you want to revisit — a recurring hero's 3-bet response, an opponent's river overbet tendencies, the spots you want to drill before each session.

Click any cell to see the hands

Click any frequency and the replayer opens with the exact hands behind that number — drill from the number straight into the hands that produced it.

Share a study

Every tree position can be shared via URL — the filters, the node path, and the comparison state all travel with the link. Drop it in a DM or a study-group thread and the recipient opens the exact view you were looking at.

Filter by player pool

Narrow the population to a specific archetype using your player pools — Nits, TAGs, LAGs, Fish, Whales, Maniacs, Regulars, or any custom pool you've built. Leave the filter on All Population to see the entire field in one view.

• Pools are managed in Settings → Player Pools — the same place you tune the archetype definitions that drive Auto Classify.
• Populate a pool automatically with Auto Classify from Player Search, or build one manually from Multi-mode search results.
• Switch pools on the fly; every chart in the study updates to the new selection.

Pre-built studies

Dozens of ready-to-go studies are grouped into categories so you can start where you want without building a filter from scratch.

• C-Bet & Aggression — c-bet IP / OOP, facing c-bets, check-raises, multi-street c-bet lines.
• Multi-Street Lines — turn c-bet, river c-bet, delayed c-bet, float + stab.
• Pot Types — limped, single-raised, 3-bet, 4-bet, 5-bet+.
• Board Textures — sorted by suit, pairing, and connectivity.
• Every card shows a difficulty badge (Beginner / Intermediate / Advanced) and the hand sample behind the question so you know how much data you're working with before you open it.

Custom Study — build your own

Not finding the exact question in the presets? Build your own. Pick filters across position, stack depth, pot type, board texture, hand strength, and action line, then choose a dimension to group by. Results come back as frequency heatmaps you can drill into the same way as any preset.

Top Population Exploits

Surfaces spots where the population deviates significantly from pot-odds or reference frequencies — pre-sorted leaks, ranked by magnitude, with sample size and deviation baked into each row. Two validation tiers separate math-proven exploits (pot-odds thresholds) from ones awaiting GTO-solver validation, so you always know how much weight to put on each.

Click-through to hands

Any aggregate cell opens the replayer with the exact hands behind the number — go from the aggregate straight to the hands that made it.

What to upload

Hand history .txt files or .zip archives from your poker client. Winamax, PokerStars, GGPoker, and WPN formats are supported.

How processing works

Uploads are queued and processed in the background. The status on the upload card updates in real time — you can close the page and come back later. Re-uploading the same file is safe: duplicates are detected and skipped.

After the import finishes

Your stats, widgets, and opponent profiles refresh automatically. ClickHouse materialized views recompute aggregates within seconds of the import completing.

General

The baseline preferences that apply across the whole app.

• Language — choose the app language (English, Português, Español, Français); saved locally, applied immediately.
• Theme — switch between OG (navy), Dark (emerald), and Light (off-white) presets, or build and save your own custom themes with the theme builder.
• Screen Names — add the usernames you use on each poker site (with autocomplete from the database). Maintain a separate retired list for old aliases so they don't pollute your stats but aren't lost either.
• Notifications — toggle in-app tips and banners on or off. Maintenance alerts always show regardless.

Replayer

Styling for the hand replayer — tweak how the table and its pieces look while you review.

• Appearance — pick the table background, felt fill, and armrest colors with a live preview of the poker table.
• Cards — choose a deck style and card back design (multiple backs × multiple colors) with an instant preview of any card.
• Chips — switch between Classic and Modern chip styles; preview the full denomination set (1 / 5 / 25 / 100 / 500 / 1000).

Agg Stats

How aggregate stats (bars, bet-sizing buckets, stack tiers) are colored and bucketed across the whole Agg Stats page.

• Colors — customize the color of each action (BET, RAISE, ALL-IN, CALL, CHECK, FOLD) shown in stacked bars and action breakdowns. Live preview, reset-to-defaults always available.
• Bet Sizes — define Hero and Villain bet-size ranges separately, each with a custom label and color. Add up to 10 buckets per side, set your own thresholds.
• Raise Sizes — same structure as Bet Sizes but for raise sizing. Hero and Villain ranges managed independently.
• Stack Buckets — configure the stack-depth tiers used to classify hands (e.g. 10–20 BB, 20–40 BB) so your filters and Decision Tree nodes group stacks the way you think about them.

Player Pool

Where every player pool lives. Manual pools (the ones you built in Player Search or by hand) sit alongside auto-classified pools (the dashed-border ones created by Auto Classify).

• Rename a pool, change its color, see the total hand count across every player in it.
• Add players by username (with autocomplete) or delete selected players in bulk.
• Lock players so they're protected from bulk clears; unlock when you're ready to prune them.
• Auto-classified pools are read-only — rerun Auto Classify to refresh them.
• Pools whose name matches an archetype link automatically, so the pool inherits the archetype definition.

Archetypes

The definitions that power Auto Classify. Each archetype (Nit, TAG, LAG, Fish, Whale, Maniac, Regular, plus any you add) is a set of stat ranges and a weight that determines how strongly each stat counts toward the match.

• Stats & Weights view — edit the global weight of each stat (how much it pulls a player toward or away from a match); add or remove stats from the classifier entirely.
• Individual archetype view — rename it, pick its color, adjust the acceptable range of each stat (grouped by preflop action, postflop action, sizing, etc.) using range sliders.
• Minimum of two archetypes enforced; add new ones whenever a player type isn't captured by the defaults.
• Confidence guide: 70–100% strong, 50–69% good, 25–49% moderate, 0–24% weak — shown next to every classified player.

Database

Stat color rules and database-level maintenance actions.

• Stat Colors — for every stat (VPIP, PFR, 3-Bet, etc.), define the value ranges and colors that drive how the number renders in tiles and tables. Search or filter by stat name, add or remove ranges, use operators like between / > / ≥ / < / ≤.
• Maintenance — recompute hand flags and re-run player classification in bulk. Use after large imports or after tuning archetype definitions.
• Create Stats — bulk generate or import stat definitions (power-user tooling; not needed for day-to-day use).