CueFinch Download beta
English

How to add a basketball scoreboard to OBS

Basketball is harder to run than football: the clock counts down and stops on every whistle, the score moves every few seconds, and a quarter can end mid-sentence. This guide sets up a basketball scoreboard in OBS that keeps up — with one browser source and one panel.

What changes from a football score bug

  • The clock counts down. Each period starts at 10:00 (FIBA) or 12:00 (NBA) and runs to zero; overtime is 5:00.
  • Quarters, not halves. The status line shows 1st to 4th quarter and overtime.
  • The score moves in twos and threes. You need the score on keys, not in a text box.

CueFinch switches all three when you choose basketball as the sport: the clock direction, the preset period lengths, the status labels and the quick announcements change with it.

Setting up the game — step by step

  1. Add the CueFinch output page to OBS as a browser source (exact settings).
  2. Open Teams and add both sides with a short code, colours and a logo. Enter the rosters — positions use basketball labels (PG, SG, SF, PF, C) — and tick the starting five.
  3. On the Live page choose basketball as the sport and pick the two teams.
  4. Set the period length: 10 minutes for FIBA rules, 12 for NBA, 5 for overtime.
  5. Press TAKE on the score object, then start the clock at the tip-off.

Stopping and starting the clock

In basketball the operator owns the clock: it stops on fouls, time-outs and out-of-bounds, and restarts with play. Start and stop are a single key — S on the keyboard, or a clock key on a Stream Deck that shows the running time on the button itself.

Reset rewinds the current period to its full length, ready for the next quarter. The time is kept by the CueFinch server, so a refreshed browser source or a second output never shows a different clock.

Keeping up with the score

The panel’s + and − buttons change the score one point at a time — right for free throws and corrections. For field goals, put the scoring on keys: a Stream Deck score key can add 2 or 3 in one press, and on a Stream Deck + the dial turns the score up and down. Any controller that sends HTTP requests can do the same with an address such as …/api/v1/score/home/+3.

The score bug updates in place while it stays on screen, so a fast run of baskets never makes the graphic flicker in and out.

Player moments and announcements

From the line-ups in the Match Desk, tap a player for a quick strap: three-pointer, dunk, free throw, foul or rebound, with the player’s name and number. Time-outs and the 24-second call are one-tap announcements, and substitutions show who comes on and who goes off.

Volleyball works the same way

Choose volleyball and the clock block gives way to a set score: the bug shows the points in the current set and the sets won, for example SET 2–1.

Ready for the tip-off? Download the free beta, choose basketball and put a count-down score bug on air in a few minutes.

Download the free beta

Frequently asked questions

Can the OBS scoreboard count down for basketball quarters?

Yes. With basketball selected, the period clock counts down from 10 or 12 minutes (5 for overtime) and reset rewinds it for the next quarter.

How do I add two or three points at once?

Use a key: the CueFinch Stream Deck plugin’s score action has a step you set to 2 or 3, and the HTTP API accepts steps such as +2 and +3. The panel buttons change one point at a time.

Does the clock stay right if OBS reloads the source?

Yes. The clock runs on the CueFinch server, so a reloaded output shows the current time immediately.

Can I use it for a local league or school game?

Yes — you enter the teams and rosters yourself, so any league works, with no data feed or subscription.

Related pages