> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getcuemanager.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Snooker scoring
> Score frames ball by ball and share a live scoreboard with spectators.
The marker is a tablet-sized scoring screen for a single snooker frame. A member of staff — or the players themselves — taps each pot and foul as it happens, and the running score appears live on the table card, on any spectator screen, and in the frame's final result.
## Opening the marker
Start the session with the game type set to **Snooker** (see [Starting a session](/sessions/starting-a-session)). The active session panel then shows **Open marker**, which opens the scoring screen for the current frame.
The header shows the frame number, both players, the current **Break**, which ball is **On**, how many **Reds** are left, the **Hi**ghest break so far, and a **Free ball** flag when one is in play. A connectivity chip sits alongside it, because the marker often runs unattended for an hour at a time.
## Scoring a frame
Tap the ball that was potted: red (1), yellow (2), green (3), brown (4), blue (5), pink (6), black (7). Balls that are not legally on are dimmed and cannot be tapped, so the break stays valid.
Choose **Foul** and pick the reason:
| Reason | When it applies |
| ------------------------ | ------------------------------------------------------- |
| **Hit wrong ball first** | The cue ball contacted a ball that was not the ball-on. |
| **Pot wrong ball** | A ball other than the ball-on was potted. |
| **Cue ball potted** | The cue ball went into a pocket. |
| **Ball off table** | Any ball left the table. |
| **No ball hit** | The cue ball failed to contact any ball. |
| **Manual / other** | Operator-declared, with the penalty set by hand. |
The modal shows the **Ball involved**, the calculated **Penalty**, and who plays next, ending with **Confirm — Bilal Khan plays**. The scoring engine on the server has the final say and may raise the penalty if it sees more balls involved.
After a snooker foul, choose **Declare free ball**. The **Free ball** button on the pad becomes tappable so you can score the nominated ball. If the fouled player is offered the shot again, a **Play again (replace)** button appears.
**Safety** and **Miss** end the visit without a pot and pass play to the opponent.
When the cue ball is in hand, the marker locks input and shows an overlay — at frame start, after the cue ball was potted, or after it left the table. It says "Place cue ball anywhere inside the D", names the ball-on, and unlocks when you choose **Ready — record next shot**.
**Undo last** removes the most recent shot. It is disabled when there is nothing to undo.
**End frame** asks to confirm: "This closes the frame and triggers session billing for it." Accepting closes the frame, charges it to the loser, and shows the **Frame ended** banner with the winner and final score. **Back to tables** returns you to the floor.
Ending a frame here is what bills it. The result also raises a **Frame Finished** alert for the rest of the club to acknowledge — see [Running a session](/sessions/running-a-session).
## The spectator scoreboard
**Spectator view** in the marker header opens a second, read-only screen sized for a wall display or projector. It shows both scores at full height, the current break, the ball on, reds left, a free-ball indicator, a foul banner as fouls happen, and a cue-ball-in-hand overlay — all driven live from the marker with no input of its own.
Nobody has to sign in on the spectator screen: the link carries its own access, so you can open it once on a club display and leave it running. If it loses its connection it says **Reconnecting** rather than leaving a stale score on the wall.
The spectator link contains an access token from the marker's own session. Open it on screens the club controls; do not post it publicly or send it to customers. If a link has been shared beyond the club, reopen the spectator view from the marker to generate a fresh one.
## Scoring offline
The marker keeps accepting shots with no connection. Completed frames are held on the device, counted by a pending badge on both the marker and the session panel, and sent when the connection returns. The offline chip in the header tells you when that is happening — see [Offline and sync](/concepts/offline-and-sync).
## Related pages
* [Starting a session](/sessions/starting-a-session) — choosing Snooker as the game type
* [Running a session](/sessions/running-a-session) — frame alerts and the session panel
* [Checkout and payments](/sessions/checkout-and-payments) — how frames become the bill
* [Roles and permissions](/concepts/roles-and-permissions) — the Marker role, for scoring-only staff