OBS Studio is a free and open source software for video recording and live streaming. An auxiliary app 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.

Links:

Open Broadcast Software (OBS): https://obsproject.com/
DigiBallScanner (macOS): download app

Mac Computer
Most Macs today (post 2015) already have built-in BLE adapters.

Download and install the DigiBallScanner app from the Apple store here.

The DigiBallScanner app for macOS has a very simple graphical interface. Select from the observed DigiBall devices on the left. A picture of the ball and tip contact point is shown on the right. Leave the app open and running.

Note: For the Mac version there is currently not an option to select multiple balls simultaneously.



You may also want to add your Pictures folder to your Favorites in Finder to make access easier. To do this, drag and drop your Pictures folder into your Favorites section of the sidebar.

1. Open OBS and click on the Plus button to create a new scene.
   
   
   
   
2. Add your video capture device as a source.
   
   
   
   
3. Add the DigiBallScanner-generated cue ball image as an overlay image. Click the Plus icon in Sources and select Image.
   
   
   
   
4. Navigate to your user's Pictures folder. Select DigiBall.png.
   
   
   
   
5. Position and size the overlay image where you want it to appear in the video.
   
   
   
   

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.

1. To add a video delay, click on the Video Capture Device source and then click on the Filters button.
   
   
   
   
2. Add a Video Delay (Async) filter.
   
   
   
   
3. Change the delay to 10000ms to add 10 seconds of video delay.
   
   
   
   
4. 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.
   
   
   
   
5. 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 the DigiBallScanner app is still running, and then click the Start Recording button to create a video. Press Stream to start streaming if you are set up for it.