{% extends "base.html" %} {% block title %}Help · myboker.org{% endblock %} {% block content %}

Documentation

How myboker works

Everything you need to run a home poker league — sessions, ledgers, leaderboards, and settlement.

Leagues

A league is the top-level container for your home game. It holds all your players, sessions, and ledger events in one place. One account can manage multiple leagues — useful if you run separate games (e.g. a Thursday game and a weekend game).

When you create a league you give it a name and optional description. A unique public key is automatically generated so you can share a link to it later if you make it public.

Tip: Leagues are long-lived. You don't need to create a new league every season — use sessions to separate individual nights of play.

Players

Players are the people in your league. They do not need a myboker account — only the league owner or manager needs one. You just add names.

Each player has a display name that appears on the leaderboard and in ledger events. You can add an optional note (like a payment handle) to help with settlement later.

Archiving a player hides them from the active roster but preserves all their history. You can reactivate them at any time.

Active Shows on the roster and is available to record events against.
Archived Hidden from the roster. History and stats are preserved. Reactivate any time.

Sessions

A session is a single night of poker. Sessions are date-stamped and sequenced — if you play twice on the same day, they become S1 and S2 automatically.

Sessions have two states: open and closed. While open, you can record buy-ins, cashouts, and other ledger events. When everyone has settled up and cashed out, you close the session. Closing doesn't delete anything — you can always reopen it.

Date The calendar date the game was played. Used to order sessions and group same-day games.
Label Optional short name for this session (e.g. "Main table", "Side game"). Shown in lists.
Notes Optional freeform context visible in the session list (e.g. "Holiday game", "Marcus's place").
Open Session is live — events can be added and settlement is still in progress.
Closed Session is settled. Books are considered final. Can be reopened if needed.

Ledger events

All activity in a session is recorded as ledger events. The ledger is append-only — events are never deleted. This keeps the record clean and auditable, even if you need to correct a mistake (you just add a correcting entry).

There are eight event types:

buy-in
A player buys chips with cash.

Cash comes into the pot. Records how much the player has invested. Most common event — record one every time someone puts money on the table.

front
The house covers a player's buy-in.

When a player doesn't have cash handy, the organizer (house) can front them chips. This creates a debt — the player owes that amount back to the house. Track fronts carefully so you know who owes what at the end of the night.

cashout
A player exchanges their chips for their cash value.

Records the chip count a player walks away with. This is the "you are owed X" event — but it doesn't mean cash has left the house yet. Use paid out to record the actual cash handover.

paid out
Cash physically leaves the house to the player.

Closes the loop on a cashout. Once a player has been paid out, their balance goes to $0. Record this separately from cashout because you may pay people out at different times (end of night, next day via transfer, etc.).

rollover in
Chips carried in from a previous session.

If a player didn't cash out at the end of a session and instead carries their chip stack forward to the next game, record a rollover in at the start of the new session.

rollover out
Chips carried out to a future session.

Recorded when a player leaves a session without cashing out, intending to carry their stack forward. Paired with a rollover in at the next session.

debt repayment
A player repays an outstanding front.

When a player who was fronted chips pays the house back (cash, transfer, etc.), record a debt repayment. This reduces their outstanding balance with the house.

write-off
The house forgives a debt.

If a front won't be collected (player left, debt forgiven, etc.), write it off. The debt is cleared from the open balance without cash changing hands. This is irreversible — add a note explaining why.

Settlement

The ledger tracks two types of open balances at all times:

Due to players Cash the house owes to players who have cashed out but haven't been paid yet. Pay these out to clear the balance.
Due to house Cash players owe to the house from unpaid fronts. Collect debt repayments or write these off to clear the balance.
Cash in Total real cash that has come into the pot across all sessions — buy-ins and repaid fronts only, not fronts themselves.
Cash paid out Total real cash that has left the house to players. Ideally this approaches cash in over time.
Fronts vs buy-ins: A front doesn't add to "cash in" because no cash actually entered the pot — the house covered it. Cash in only counts real money on the table.

Leaderboard & stats

The leaderboard ranks players by their all-time performance. Stats are computed from ledger events, not manually entered.

Net Total cash out minus total cash in across all sessions. Positive means up, negative means down.
ROI Net divided by total invested, expressed as a percentage. Compares performance independent of how much someone plays.
Win rate Percentage of sessions where the player finished with a positive net. Ties (exactly break even) count as a loss.
Sessions played Number of sessions with at least one ledger event for this player.
Biggest win The single session where the player netted the most profit.
Biggest loss The single session where the player lost the most money.

Public vs private

Each league has a visibility setting you can change in league settings.

Private Only members (owners and managers) can see this league. The league won't appear on the Explore page. This is the default.
Public Anyone with the link — or who finds it on the Explore page — can view the leaderboard and session history. No account required to view. Members still need an account to manage it.
Note: Making a league public shares leaderboard rankings and session results, but not private financial details like individual debt balances or account emails.
{% endblock %}