📺
Twitch Bodycam, Bot, & Lighting Integration
Display your identifier information, attached call information, and more on your gaming stream!


Sonoran CAD - Smart Lighting
Sonoran CAD has a built-in livestream overlay, allowing you to display your live unit information, call information, and more!
Our Twitch bot can also be configured to send out chat messages when data is modified.

The free version of the overlay does not include the customizable bodycam asset.
However, you can still create custom overlay text with the free version!
The bodycam creates local text files and hosts a local webserver.
This requires the desktop application to run.
This allows you to customize a bodycam overlay on your stream, with your real-time unit and call information.
First, ensure you are using the desktop version of Sonoran CAD. The application has to generate physical files, and host a local webserver to work. This can not be done in a browser.
In the stream overlay, open the txt file directory viewer and select a folder for the text files and bodycam webpage to be generated:

Stream Overlay - Text file Location
In the livestream overlay config section, expand the
Bodycam
section.Here, you can enable and customize the data placement and keys just as before with the customizable text files.
- Expand the
Unit Updates
orCall Updates
Section - Toggle
ON
the txt file COPY
the field keyPASTE
the field key into the bodycam sectionSAVE
the configuration once complete
You can also optionally specify a different port for the bodycam webpage to run on (
9990
is the default).
In OBS, add a new "Browser" source and paste the URL listed in the bodycam section.
By default, this will be
http://localhost:9990

OBS - New Browser Source
Paste the URL into the browser source and hit OK.

You can now customize the size and placement of this browser window in OBS as you normally would.
Due to the nature of most smart bulb manufacturers, our smart lighting integration is at the mercy of their API support.
We can not guarantee that these manufacturers won't change or remove backdoor support to these bulbs in the future.

Sonoran CAD - Smart Lighting
Sonoran CAD allows you to configure in-game events to smart lighting in your own home!
When you toggle your police lights in-game, your room can flash with custom lighting patterns to further immerse and simulate real world lighting.
The smart lighting integration is not included with the free version of the Stream Overlay.
Learn more about the full version of Sonoran CAD's stream overlay.
The smart lighting integration creates local text files and hosts a local webserver.
This requires the desktop application to run.
Sonoran CAD - Smart Lighting Video
At this time, Sonoran CAD currently supports the following smart bulb types:
Many of our development team members personally use and recommend these bulbs. Due to the design, these tend to provide the fastest response type with more complex lighting patterns. A 4 pack typically costs ~$40 ($10/bulb).
Philips Hue is significantly more expensive, but is typically the most widely known option. This option will also require the purchase of a Hue bridge/hub. Due to the design, these tend to have a ~10ms+ delay when setting the color of multiple bulbs at a time.
Therefore, we recommend keeping the
delay
between frames above 500ms when using Philips Hue bulbs.Govee light bulbs are supported via Bluetooth and WiFi.
Bluetooth bulbs are supported, but can have additional time when starting the initial connection. Bluetooth connections can also experience intermittent connection problems. Govee's WiFi bulbs are currently ran through the official API, resulting in rate limitations of 60 calls per minute.
Therefore, we recommend keeping the
delay
between lighting frames above 1,000ms when using Govee wifi bulbs.The smart lighting section has multiple
Scenes
Restore
: Set when you are no longer flashing emergency lights, turn signals, etc.Emergency Lights
: While you are in an emergency vehicle with the lights onPanic
: While your panic status is toggledAvailable
: When your unit status is set to availableUnavailable
: When your unit status is set to unavailableBusy
: When your unit status is set to busyEnroute
: When your unit status is set to enrouteOn Scene
: When your unit status is set to on sceneLeft Turn Signal
: While your left hand turn signal is onRight Turn Signal
: While your right hand turn signal is onHazard Lights
: While your hazard lights are on
Expand the
Scene
> Add Bulb
> Search for Bulbs
> Select Wyze
or Philips Hue

Sonoran CAD - Scan for Smart Bulbs
The Wyze Color bulbs require your Wyze login credentials. This makes a simulated request to your homepage for all lights on your account. The Wyze credentials are not saved on both the local Desktop app or Sonoran CAD's servers. However, you may wish to update/reset your password, or even create a new Wyze account that shares these bulbs.
Your Philips Hue bridge should be automatically discovered by pressing the
Scan
button in Sonoran CAD.If you are seeing the following error:
Error: Unable to find a Hue bridge on the local network.
You may need to manually enter the bridge's IP address. This is most easily found using the Philips Hue mobile app.
- 1.Select Settings
- 2.Network Settings
- 3.Toggle
DHCP
Off - 4.Copy the
IP address
to Sonoran CAD - 5.Toggle
DHCP
On - 6.Scan for the bridge in Sonoran CAD

Philips Hue - Copy Bridge IP

Sonoran CAD - Manual Hue Bridge IP
Govee WiFi bulbs are handled via Govee's official API. Note that this does include a rate limit of 60 calls/minute.
1. Request an API Key
Using the Govee mobile app navigate to
Account
> Settings
> About Us
> Apply for API Key

2. Retrieve your API Key and Search
Within a few minutes, Govee should email your account API credentials to use. Paste these into Sonoran CAD and search for your Govee WiFi lights.
Govee Bulb models only supporting bluetooth can be controlled by Sonoran CAD, as long as your PC supports bluetooth connections. Windows limits this to no more than 5 active bluetooth connections at one time.
1. Scan for Bluetooth devices
Sonoran CAD will scan for all locally active Bluetooth devices. Govee bulbs will typically be found with a name format:
WORD_MODELNUMBER_XXXX
.If your bulb is not discoverable, turn the bulb's power off entirely for ~5 seconds then turn it back on. This should place your bulb into discovery mode.

2. Add the Bulb
Click on the Bluetooth bulb to add it to your scene, and continue on to building your lighting sequences.
Bluetooth bulbs will have their status listed on the left side. When you click the
Test
button, it may take up to 60 seconds for the connection to complete.
You can add the desired bulb to your
Scene
. Each scene
is made up of multiple frames
.The example below shows a very simple sequence of two lights switching back and forth between red and blue, with a
delay
of 500ms
between each frame. You can duplicate and create advanced chase sequences, flashes, etc. with several bulbs at a time.We recommend keeping the delays no shorter than:
250ms
for Wyze Color Bulbs
500ms
for Philips Hue Bulbs
You can press the
Test Scene
button to test the scene with your smart bulbs. Press the Test Scene
button in the Restore
scene section to go back to your normal lighting.For in-game use, your lights, turn signals, and hazards will automatically run as long as your community has the Sonoran CAD integration framework installed. This utilizes a local webserver running from your desktop app.
- 1.If you have modified your Bodycam port from the default
9990
, you will need to update this port in-game as well. Use the/setlightport <some port here>
command in-game to change your port from9990
to something else. - 2.Additionally, ensure you have set your file directory in the credentials section of the stream overlay.
Sonoran CAD's stream overlay also comes with a configurable Twitch bot. This bot will send out chat updates when unit or call data is updated.
The Twitch bot is not included with the free version of the Stream Overlay.
Learn more about the full version of Sonoran CAD's stream overlay.
Using the overlay in OBS, select the
Twitch Bot
button in the taskbar.
Paste in your Twitch channel name and OAuth key.
Overlay - Twitch Bot Credentials
Once set, you can press
Test
to display a test message in your Twitch chat.Every piece of unit and call data can be toggled on or off individually.
It is highly recommended to only toggle on data updates that will not be frequently spammed. Toggling too many data fields and updating data too quickly may result in Twitch rate limiting your bot.

Overlay - Twitch Data Fields
Once you have configured your Twitch Bot's credentials and data fields, press
Save
.Now, whenever one of those data fields is updated, your Twitch bot will send a chat message.

Sonoran CAD - Stream Overlay
If you're having issues seeing the Twitch bot messages, view the
Twitch Logs
panel in the stream overlay.This will contain valuable information on the twitch bot's connection, rate limiting, and other errors.

Overlay - Twitch Logs
If you have too many data fields toggled, and are sending Twitch updates too quickly you may experience rate limiting.
The overlay is immensely customizable, allowing you to customize every piece of data displayed.
The overlay configuration modal can be opened by navigating to
Start Menu
> System
> Stream Overlay
. Or, by searching in the start menu.While the Twitch bot can run in a browser instance of Sonoran CAD, the desktop application is required, to generate unit/call data txt files.
In the stream overlay, open the txt file directory viewer and select a folder for the text files to be generated:

Stream Overlay - Text file Location
The free version of the overlay is limited to three (3) data keys.
Learn more about the full version of Sonoran CAD's stream overlay!
In the
Configuration
tab, toggle on the desired data fields for your unit and dispatch call information.For every field toggled, a text file will be generated to be viewed in OBS.
However, we recommend creating custom text files to combine multiple data fields in a single text file.

Stream Overlay - Custom Text Files
These can be easily copied from the UI, by pressing the
Copy
button next to the toggled field and pasting into the custom file's key textbox.Key | Description |
{unit_status} | Unit Status |
{unit_location} | Unit Location |
{unit_aop} | Unit AOP |
{unit_number} | Unit Number |
{unit_name} | Unit Name |
{unit_agency} | Unit Agency |
{unit_department} | Unit Department |
{unit_subdivision} | Unit Subdivision |
{unit_rank} | Unit Rank |
{unit_group} | Unit Group |
{unit_panic} | Unit Panic Status |
{call_id} | Dispatch Call ID |
{call_origin} | Dispatch Call Origin |
{call_status} | Dispatch Call Status |
{call_priority} | Dispatch Call Priority |
{call_block} | Dispatch Call Block |
{call_address} | Dispatch Call Address |
{call_postal} | Dispatch Call Postal |
{call_title} | Dispatch Call Title |
{call_code} | Dispatch Call 10-Code |
{call_description} | Dispatch Call Description |
Don't forget to save your configuration!
In OBS, add a new text source:

OBS - New Text Source
In the text source properties, select
Read from File
and select one of your generated data key files from the location specified earlier.
Stream Overlay - Text Files

Stream Overlay - Text file Viewer
You can now place the text field anywhere in your OBS stream layout.
You can also customize the fonts, change the background and more!
The free version of the livestream overlay allows anyone to test out the basic functionality. The free version does not allow use of the Twitch bot, bodycam, or smart lighting integration and is locked to a maximum of three custom "data keys".
The full, individual license for Sonoran CAD's livestreaming tools is available for $7.99/mo.
Users can purchase a license to the full version in their billing center:
Last modified 7mo ago