Getting started
Two things happen before you see your own play: install and sign in, then import your hands. The solved spots download by themselves. This page walks through both steps and ends with a map of where everything lives.
0. Install and sign in
Download the installer from megamaster.io/download and run it. Windows should name the publisher as BITB CASH LTD. If "Windows protected your PC" appears instead, click More info and check the publisher reads BITB CASH LTD before you run it; if it says Unknown publisher, do not run it. The installer shows the licence terms, then installs for your user only — no admin rights needed.
On first launch megamaster asks you to sign in with Google. Use the Google account your licence is on; your browser opens, you approve, and the app picks it up. A licence covers two computers. Settings › Account › Licence lists them and shows how long this computer is verified for, online or not; to move to a new computer, sign out on the old one.
Updates arrive in the app: when a newer version is published, a strip above the header offers Update and restart. Your database and settings are untouched by an update.
Once you're signed in, a short Getting started tour opens, and the solved spots start downloading as it does. Its second step, after how you found us, imports your hands in the background while you read the rest (or skip it). If PokerTracker 4, Holdem Manager, Hand2Note, DriveHUD or Jurojin is on this computer, that step adds an unticked Import from my trackers box for its hand history folders, with every screen name it found listed under the details for you to tick, only if it's yours. The tour also says what leaves your machine. It's in the cog menu at the top right whenever you want it again.
1. Import your hands
Export your hand histories from your poker site's own export tool: a folder of hand history files, or a
single .zip, .rar or .7z of that export. megamaster reads:
- GGPoker
- PokerStars
- WPN (Winning Poker Network)
- CoinPoker
- 888poker (and 888.it)
- Betclic
- Winamax
- Unibet
- PartyPoker (and the US client: BetMGM, Borgata, partypoker NJ)
- iPoker (both the session XML and the text export)
- Chico (BetOnline, TigerGaming, SportsBetting)
- Ignition / Bodog / Bovada
- PokerBros
- Sisal
- Snai
- BetRivers (Run It Once)
Open Data & imports from the cog menu (a new, empty database opens there by itself).
Drop your export onto the field, or use the folder button to browse to a folder or an archive, then press
Import. You never pick the site: megamaster works out which site wrote each file, so a folder
holding more than one room's exports imports as all of them. Subfolders are included, so point at the folder
holding every screen name — HandHistory, not HandHistory/yourname.
The import shows live progress in two steps: hands imported, then stats built. When it finishes it lists files seen, hands imported, duplicates skipped and parse errors, and which sites it read.
To keep importing as you play, add the folder your site writes hand histories to under Saved folders (Save this folder, or Add folder…). Its Import button then reads only the files that are new or have grown since the last import, and On startup chooses what happens when megamaster opens: Ask (the default), Import automatically or Do nothing.
Hands are keyed by site + hand number. Re-importing the same export, or an export with overlapping hands from a previous session, just skips what's already there — nothing gets double-counted.
What the app downloads for you
The solved library is not in the installer, and you don't need to fetch it by hand:
- The Getting started tour starts downloading the summary package for every solved spot as soon as it opens. The Lines map, sizing costs and grading read these.
- Analyse fetches the individual solved boards it needs while it grades your hands.
- The trainer and the viewer fetch a board the first time they open it.
Boards go into a cache whose size you set under Solve › Library, which also lists every spot and lets you update or remove packages.
What happens during import
- Each hand is parsed into structured players, actions, board, and pot data.
- Position (BTN, SB, BB, UTG, ...) is derived from seat + button, not read off the export literally — so it stays correct for 6-max, 9-max, and shorthanded tables alike.
- Pot type (walk, limped, SRP, 3bet, 4bet, 5bet+) and whether Hero was the preflop aggressor are computed once at import time, so every later query can filter on them directly instead of re-deriving them.
- Bet-size-as-percent-of-pot is precomputed per action, which is what powers the B30/B50/B70-style bucketing everywhere in the app.
- Hero's net result and all-in-equity-adjusted result are computed per hand, feeding the Results tab.
Where your data lives
Everything is stored locally in a SQLite database on your own machine, by default on the system drive;
Settings › Solver & data › Data folder moves it to another
drive. The database's name is in the header: click it to switch databases, open one or create a new one.
It's a plain .db file, so you can back it up or move it like any other. There's no server in the loop for
import, storage, or querying — the whole pipeline runs on your machine against your own files, and your
imported hands never leave it. What the app fetches: the solved library and your licence. What it can send:
anonymous usage counts (off in Settings › App › Usage log if you prefer); when you're signed in, your
trainer results for the leaderboards and your player profile (Settings › Account › Leaderboards), your grade and action at each
Arena decision for the other players (Settings › Account › Arena) and your totals after a live match for
your opponent (Settings › Account › Live tables); a trainer or live hand you publish with Share link; a 3-way
spot you choose to build on our server (the spot, never a hand); and, if you
turn it on in Settings › Account › Phone drills, your drills for the
phone app. See Privacy.
Where everything lives
Six tabs across the top:
- Train — where the app first opens, hands imported or not (after that it opens where you left off; Settings › App › Startup): Home (today's routine, one click to start), Play (drills, routines, the Arena, puzzles, free play, preflop and sizing menus), Stats, History, Leaderboards and Live (play other megamaster users heads-up for play money, then review the hands together). See The trainer.
- Lines — the Lines map and the Preflop view, one matchup at a time, with the full decision tree a card opens.
- Analyse — your own decisions graded against real solves, in big blinds.
- Population, Results — the reports.
- Solve — Build, Viewer and Library, three sections of one solver workflow.
The cog menu at the top right holds Data & imports (Import, Players and Preflop sims), Settings, this tour, the docs and FAQ, Report a bug and Sign out. The filter (dates, stake, players, ante, position and sites) isn't a tab: it's the chip at the right of the tab strip, and it narrows Lines, Analyse, Population and Results at once. Your database file is in the header — click it to switch databases.
Next
Once you've got hands imported, the Lines map is the fastest way to see something real: pick a spot in the list on the left, and the key nodes of that line are there with your play beside the solver's — the red dots in the list say where to look first. Your first visit points at the list and at a card for you.