CueSport Scoreboard - Professional OBS Overlay for Cue Sports
CueSport Scoreboard is an OBS stream overlay focused on cue sport, providing automated ball scoring for a variety of pool games and snooker. It provides a clean, customizable scoreboard with features for streamers, league directors, and tournament organizers.
Per OBS Forum Policy: Parts of CueSport Scoreboard are developed with AI coding assistance (e.g. Cursor). I design the features, review and test all changes, and remain fully responsible for the code and support. AI is a tool in the workflow, not an unattended publisher. Specifically, AI assistance has been used to for document creation, wiki generation, and the recent addition of a modern theme, as well as assisting in bug hunting and fixing.
Donate and Support
Key Features:
Simply add the browser source to OBS, customize your logos and settings, and start streaming. The control panel docks into OBS for easy access during your stream. Remote control from a self-hosted solution, or simply sign-up for a managed service.
Single Instance or multiple instances from a single dock:
To modify the overlay the user will leverage a local browser interface in OBS for control (one for each instance), or the new Cuesport Scoreboard Cloud function.
Additional Feature Notes
Ability to reposition elements within the space: scoreboard, logo slideshow, and game information. Select source, choose interact, and move to your desired location. Refresh page or change size to return to default locations.
Ability to use custom win animations, specific to cue-ball games (8,9, and 10-ball, default is 8-ball).
Tabbed sections of the control panel to save on UI real-estate.
Ball tracker that displays appropriate balls based on game type chosen, and allows for vertical or horizontal display (including International and American style pool balls)
See notes for configuring Replay settings.
Mobile controls via CueSport Scoreboard Cloud, a self-hosted solution or managed service provided by CueSport.macleod.systems.
CueSport Scoreboard is an OBS stream overlay focused on cue sport, providing automated ball scoring for a variety of pool games and snooker. It provides a clean, customizable scoreboard with features for streamers, league directors, and tournament organizers.
Per OBS Forum Policy: Parts of CueSport Scoreboard are developed with AI coding assistance (e.g. Cursor). I design the features, review and test all changes, and remain fully responsible for the code and support. AI is a tool in the workflow, not an unattended publisher. Specifically, AI assistance has been used to for document creation, wiki generation, and the recent addition of a modern theme, as well as assisting in bug hunting and fixing.
Donate and Support
Key Features:
- Support for manual/automatic scoring for 8, 9, 10, Straight, Bank, One-pocket, and Snooker.
- Real-time score tracking with player names, race information, and general game details:
- Overlay scaling and opacity controls.
- Professional shot clock inspired by Mosconi Cup and European Open tournaments:
- Including 30/60 second timer, and extension support.
- Custom logo support for players and sponsor slideshow.
- Ball tracker integration for enhanced viewer experience:
- Track potted balls.
- Player ball set.
- Breaking player.
- Display game stats on overlay.
- 3D win animations in the form of 8, 9, and 10 ball.
- Various ball style for scoring/display
- Ultimate Pool Balls
- International Pool Balls
- Unity Pool Balls
- World Pool Balls
- Snooker Balls
- Replay buffer integration for instant replay control
- Hotkey support for quick score updates during live streams
- Multiple OBS themes to match your stream aesthetic
- Seamless OBS integration with dockable control panel
- Ability for multiple table/instance tracking
- User stats and game storage
- Multiple instance support in a single OBS dock
- Cloud control functionality to control it allfrom your phone
- Pool and billiards streamers (display scoring and player names)
- League Directors (track player scoring and matchstats)
- Tournament Organizers (leverage individuals for tracking multiple games)
- Anyone looking for a professional scoreboard solution
Simply add the browser source to OBS, customize your logos and settings, and start streaming. The control panel docks into OBS for easy access during your stream. Remote control from a self-hosted solution, or simply sign-up for a managed service.
Single Instance or multiple instances from a single dock:
To modify the overlay the user will leverage a local browser interface in OBS for control (one for each instance), or the new Cuesport Scoreboard Cloud function.
Installation Guide
Full installation guide covering dock and self-hosted cloud solution available on github:- Click on the Docks Menu from the top menu bar of OBS and select "Custom Browser Docks".
- Type a name (CueSport-Scoreboard) in the "Dock Name" box, and input the full path to "control_panel.html" in the URL box e.g., c:\users\yourname\desktop\Cuesport-Scoreboard\control_panel.html.
This forms the control panel for the overlay that will be implemented later, as a browser under sources.
- (Optional) If you are going to use multiple instances in a single stream make sure to add a query at the end of the URL e.g., ?instance=table1 (as seen in the image below, only needed when using multiple instances)
Click "Close"
- Select the scene you want the scoreboard to display and add a "Browser Source" -> "Create New" -> give it a name. click OK.
- Input the full path to "browser_source.html" in the URL box e.g., c:\users\yourname\obs-plugins\Cuesport-Scoreboard\browser_source.html"). Again, if using multiple instances, add ?instance=game4 at he end of the URL definition (as seen in the image)
Set Width to 1920 and Height to 1080.
Click OK.
- You now have a control panel and associated browser overlay, or multiple if you choose to use instances.
- In the event you need to clear the locally stored data, utilize the reset data button for an instance or all instances.
Additional Feature Notes
Ability to reposition elements within the space: scoreboard, logo slideshow, and game information. Select source, choose interact, and move to your desired location. Refresh page or change size to return to default locations.
Ability to use custom win animations, specific to cue-ball games (8,9, and 10-ball, default is 8-ball).
Tabbed sections of the control panel to save on UI real-estate.
Ball tracker that displays appropriate balls based on game type chosen, and allows for vertical or horizontal display (including International and American style pool balls)
See notes for configuring Replay settings.
Mobile controls via CueSport Scoreboard Cloud, a self-hosted solution or managed service provided by CueSport.macleod.systems.
