DigiBallScanner for Open Broadcaster Software (OBS)

Windows: Enable Bluetooth LE Adapter

To enable BLE:

1. Go to Start and type devmgmt.msc to open the Device Manager

2. Find Bluetooth and expand.

3. 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.

4. Disable the classic Bluetooth adapter "Intel(R) Wireless Bluetooth(R)" by right-clicking and selecting Disable.

macOS: Run DigiBallScanner

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: 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.

Configure OBS

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.

Windows: 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.

macOS: Navigate to your user's Pictures folder. Select DigiBall.png. (Only one image file is generated.)

Click OK.

Position and size the overlay image where you want it to appear in the video.

Windows only: If you want to add additional numerical information, feel free to another image and do the same with the digiballX_stats.png image.

(Optional) Add video and audio delays

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.

All Done! Stream or Record using the DigiBall!

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.

Example Video

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.