OBS Studio is a free and open source software for video recording and live streaming. An auxiliary program for Windows called DigiBallScanner automatically generates DigiBall images in real time so that video overlays of cue ball tip position, speed, spin, and other stats can be added to live games, matches and tournaments.
Open Broadcast Software (OBS): https://obsproject.com/
DigiBallScanner: https://github.com/nataddrho/digiball_windows
Windows 10
Bluetooth Low Energy (BLE) capability. Most computers running Windows in 2025 already have built-in BLE adapters. BLE USB dongles are also widely available.
Download and install OBS from the link provided above.
Click here and then click "View raw" to download the latest version of DigiBallScannerSetup installation package.
To enable BLE:
Go to Start and type devmgmt.msc to open the Device Manager
Find Bluetooth and expand.
Verify that one entry reads "Microsoft Bluetooth LE Enumerator". If you do not see this then your adapter does not support BLE. A BLE USB dongle can be purchased from a variety of vendors.
Disable the classic Bluetooth adapter "Intel(R) Wireless Bluetooth(R)" by right-clicking and selecting Disable.
(Optional): Test your adapter. Double-click on the DigiBallScannerCmdLine icon to open a command terminal in the installation directory. Type DigiBallScanner all to scan for all BLE devices in your area. You should see activity. Close the terminal when finished.
Scan for your DigiBall by clicking on the DigiBallScanner icon (or run DigiBallScanner from the terminal in the previous step). Make sure that your DigiBall is charged and awake by taking a shot or two with it. You should see activity in the terminal.
Make note of the DigiBall address that you wish to use, as there may be more than one device available. Either re-run DigiBallScanner with the MAC address as the first argument, or edit the DigiBallScanner desktop shortcut and append the MAC address.
You should now see information being printed related to the selected DigiBall.
Open OBS and click on the Plus button to create a new scene.
Add your video capture device as a source.
Add the DigiBallScanner-generated cue ball image as an overlay image. Click the Plus icon in Sources and select Image.
Navigate to the DigiBallScanner installation directory. This path can be found by right-clicking on the DigiBallScanner icon and selecting "Open file location". Copy and paste the path here, and then choose one of the generated cue ball images. In this example the image with a tip-outline shadow and a grid is used.
Click OK.
Position and size the overlay image where you want it to appear in the video.
If you want to add additional numerical information, feel free to another image and do the same with the digiballX_stats.png image.
You can create the effect of the DigiBall graphic updating before a shot is taken by adding a fixed delay to the video and audio inputs.
To add a video delay, click on the Video Capture Device source and then click on the Filters button.
Add a Video Delay (Async) filter.
Change the delay to 10000ms to add 10 seconds of video delay.
If you want to also add a sound delay to the microphone recording the table sounds, then select the source from the Audio Mixer and go to Advanced Audio Properties.
Change the Sync Offset to 10000ms for the appropriate audio source. You may need to tailor the exact delay depending on your particular microphone.
Make sure that DigiBallScanner is still running, and then click the Start Recording button to create a video. The video location is in your My Documents/Videos folder by default. Press Stream to start streaming if you are set up for it.
This video shows an example of a recorded video with DigiBall overlays in the upper-left corner of the screen. Small details in tip position are useful for shot analysis. For example, in the second shot of the video, the blue 2-ball was thrown to the left because the tip position was a tiny bit to the right of center, resulting in a miss.