Documentation

Everything from break-off to broadcast.

Short, practical guides for referees, club managers and streamers. Start with your first match — most people are scoring within two minutes.

OBS Overlay & Broadcasting

Customizing overlay colors and layout

Requires Pro

Colors, logo placement, and which elements show on your OBS overlay are all controlled from a single profile, with a live preview so you can see exactly what viewers will see before you go on air. Open it from the Overlay settings tile on your Hub.

Score strip style

Three snooker layouts to choose from: Bottom Bar (a full-width bar flush to the bottom edge — the original layout), Raised Tabbed (a smaller inset panel with the score info connected underneath it) and Corner Scorebug (a compact TV-style box in the bottom-left corner with the names, frames won, frame score, break and rules readouts, leaving the rest of the table clear). All three support singles and doubles, and the live preview switches as you pick one.

Shot clock style

On timed formats (Shoot-Out and Snooker 900) you can pick how the shot clock and frame clock look: Corner Ring (the original countdown ring, top-right), Red Alert (the clock sits top-centre and the edges of the screen flash red on every second from 5 down) or Edge Countdown (a glowing line around the whole screen drains as the shot clock runs, with a small clock top-right). Use Preview the last 5 seconds to see the warning in the live preview before you save.

Elements you can toggle on or off

  • Ball ON — which ball value is currently legal to pot.
  • Reds remaining — how many reds are still on the table.
  • Max from here / Fouls required — the highest break still possible for the trailing player, flipping to a red Fouls required count once potting alone can no longer win it back. See The referee pad.
  • Break strip — a row of colored ball icons, one per ball potted in the current break, in potting order.
  • Break counter — a separate large number showing the current break value, shown near whoever's at the table. This is distinct from the break strip above — one is a row of ball icons, the other is just the number — and each has its own toggle.
  • Club/sponsor logo — your club or personal logo, top-left of the overlay.
  • Sponsor slideshow — rotating sponsor logos (see Branding and sponsor slideshow).

Break counter style

Choose how the break number looks: Classic (the original look), Live Pill (a rounded pill with a pulsing live dot), Split Tab (a coloured BREAK tab joined to the number), Round Badge, Text Only, or Milestones (turns silver, then gold with a glow, as the break grows). The style applies to snooker and English billiards.

Where the break shows

Set per match in the On the overlay for this match card on Match Setup, under Break on the overlay: Standard (the break in its own box off the score strip), Next to name (a break pill on the strip, right after the name of the player at the table) or Name by score (the name moves next to the score and the break takes its place). Available for singles snooker and English billiards; doubles keep the standard box.

One profile per account, or — if you're on a Club-tier club — one shared profile the owner sets for the whole club, used automatically on every match at that club. Either way it's resolved live each time the overlay loads, never locked in per match.

Choose the colour of the overlay panels: Dark (the classic near-black), Clean White, Frosted (see-through white), Ivory, Silver, or Club colour (any colour you pick). On light and club-colour panels the text switches between dark and white to stay readable. Quick looks set several of these in one tap: Classic dark, Clean white, Pastel, White + badges, White + tint and Dark + badges.

Player colours give each side its own colour: Bold (each side filled with its colour), Pastel (a soft wash with a colour edge), Accents (colour edges and lines only) or Accents + tint. Leave it Off and both players share the panel colour.

Typography and size

  • Font — Classic (Inter names with Barlow Condensed scores), Oswald (tall, condensed sports type), Bebas Neue (all-caps poster type) or Roboto Condensed (clean and easy to read small).
  • Score strip size — Small, Medium or Large.

Caption, nicknames and flags

  • Event caption — a line shown above the score strip, such as your league or event name. A caption typed in a match's own setup replaces it, and tournament matches fill theirs in automatically.
  • Player nicknames and Country flags — shown next to the names on the strip, taken from each player's profile in Players. Works for singles and doubles.

Start, pause and end screens

Each of the three screens has its own layout and wording. Four layouts work on every screen: Full card (a full-screen graphic), Split versus (both players side by side over a dimmed table), Lower third (a banner above the score strip, so the table stays visible) and Minimal corner (a small card in the bottom-right corner).

Five broadcast layouts work on the pause and end screens: Results grid (frame-by-frame scores with breaks in brackets, TV style), Stats board (head-to-head bars for frames, points, best break, 50+ breaks and centuries), Ticker (a bottom band with a card per frame), Side panel (the frame list down the right-hand side) and Break spotlight (the best break as a huge number).

For each screen you can rewrite the Headline and Subtitle (the end screen also has a Match result headline), set how much the table behind is dimmed, and choose which parts show, such as player photos, the sponsor logo and the score line. Reset wording puts the default text back.

A different look per table or tournament

Your default look is used everywhere. To give one table or one tournament its own look, pick it in the green Editing box at the top of Overlay Settings and create an override; everything on the page then applies only to that table or tournament. If a match is on a table and in a tournament that both have their own look, the tournament's look wins. Remove the override to go back to the default.

Ready to try it? Create your free account and score a match.