LogoLogo
SupportServer Hosting
  • Sonoran CAD
  • 📱Download The App
    • Steam Browser - Workaround
    • Web Browser - Clear Cache
    • Desktop App - Clear Cache
    • GTA RP Tablet - Clear Cache
    • Steam Browser - Clear Cache
  • Why Choose Sonoran CAD?
    • 🏆Why Choose Sonoran CAD?
  • Other Products
    • 🖥️FiveM Hosting
    • 📝Sonoran CMS
    • 📡Sonoran Radio
  • Tutorials
    • Getting Started
      • Registering Your Account
      • Registering Your Community
      • Inviting Users to Your CAD
      • Granting Account Permissions
      • View Your Limits
      • Community ID and API Keys
      • Troubleshooting
    • Customization
      • Custom Domain & Login Page
      • Customizing Your Layout
      • Community Branding and Settings
      • Creating Custom Record and Report Types
      • Sharing Custom Records
      • Custom Search Types
      • Geographical Settings
      • Penal Codes
      • 10-Codes
      • Addresses and Street Names
      • Unit Status Codes
      • Tone Board
      • Custom Audio Notifications
      • Custom Emails
      • Quick Links
      • Custom Page Colors
      • User Account Restrictions
      • Configuring Multiple Servers
      • Advanced Query Strings
    • Dispatching
      • Creating a Call
      • Self Dispatch
      • Timers
      • Command Line Interface (CLI)
    • Records Management
      • Record Lookups
      • Adding a Record
      • PDF Records
      • Scene Diagram Builder
    • Administration
      • System Logs
      • Remove User Account
      • Deleting or Transferring your CAD
    • Other Features
      • Configurable Hotkeys
      • Voice Commands
      • Volume and Language
  • Integration Capabilities
    • 🗃️Paid Integration Resources
      • Mobile Command Center
      • ATM Robbery
      • In-Vehicle Radar
      • Evidence Camera
      • Power Grid
      • Speed Cameras
      • Shot Spotter
    • 🛠️Integrated Vendors
    • 📺Twitch Bodycam, Bot, & Lighting Integration
    • Database Sync and Merge
      • Database Sync Credentials
      • QB Core Mapping Tutorial
      • Troubleshooting
    • Discord Bot Integration
    • Discord Rich Presence
    • Discord Webhooks
    • TeamSpeak 3 Integration
    • Stream Deck Integration
    • 🎮FiveM
      • FiveM Installation
        • Submodule Configuration
          • Submodule Troubleshooting
          • Submodule Configuration Updates
        • FiveM Submodules
          • Body Camera
          • Call Commands
          • Check API ID
          • Civilian Integration
          • Dispatch Notify
          • Emergency Response Simulator (ERS)
          • Framework Support (ESX/QBCore) and Auto Fines
          • FivePD
          • ForceReg
          • Kick
          • Locations
          • Live Map
          • Lookups
          • Postals
          • Smart Signs
          • Sonoran Radio (sonrad)
          • Station Alert
          • Tablet & Mini-CAD
          • TeamSpeak 3
          • Traffic Stop
          • Unit Status
          • VehReg
          • WraithV2
      • FiveM Development Documentation
        • Client Functions
        • Shared Functions
        • Server Functions
        • Server Events
        • HTTP Request Handling
      • Error Codes
    • 🎮Roblox ER:LC
  • Developer API Documentation
    • 📖API Integration
      • Getting Started
        • Retrieving Your Credentials
        • Integration API ID
        • Account Secret ID
      • Push Events
        • Event Restrictions
        • Record Events
          • Record Added
          • Record Edited
          • Record Removed
        • Unit Events
          • Unit Panic
          • Unit Login
          • Unit Logoff
          • Unit Status Update
          • Unit Group Name Change
          • Unit Group Add
          • Unit Group Remove
        • Dispatch Events
          • New Dispatch
          • Modified Dispatch
          • Closed Dispatch
          • Dispatch Note
          • Attach Unit
          • Detach Unit
          • Toggle Bodycam
        • Event 911
        • Remove 911
        • Sign Updated
        • Tone Played
        • Civilian
          • Character Selected
        • ERS
          • New Callout
        • Station Alert
          • New Station Alert
      • API Endpoints
        • API Restrictions
        • Emergency
          • Identifiers
            • Get Identifiers
            • Modify Identifier
            • Set Identifier
            • Unit Panic
            • Kick Unit
            • Unit Status
            • Get Active Units
            • Update Unit Location
          • Dispatch and Emergency Calls
            • Get Calls
            • New Dispatch
            • Attach Unit
            • Detach Unit
            • Update Call Postal
            • Add Call Note
            • Update Call Primary
            • Close Dispatch
            • New 911 Call
            • Remove 911
          • Custom Blips
            • Get Map Blips
            • Add Blip
            • Modify Blip
            • Remove Blip
          • Street Signs
            • Set Street Sign Config
            • Update Street Sign
          • ERS
            • Set Available Callouts
          • Station Alert
            • Set Stations
        • Civilian
          • Set Character
          • Get Characters
          • New Character
          • Edit Character
          • Remove Character
          • DB Sync: Get Character Links
          • DB Sync: Link Character
        • General
          • Get Servers
          • Set Servers
          • Get Version
          • Set Penal Codes
          • Set API IDs
          • Custom Records
            • API Options for Adding and Modifying Records
            • Get Record Templates
            • New Record
            • Edit Record
            • Remove Record
          • Lookup By Value
          • Lookup Name or Plate
          • Get Account
          • Get Accounts
          • Check API ID
          • Apply Permission Key
          • Modify Account Permissions
          • Kick or Ban User
          • Verify Secret
          • Auth Street Signs
          • Set Postal Config
          • Set Clock Time
          • Send Photo
          • Leave Community
          • Join Community
        • Local Endpoints
          • Smart Lighting
        • Internal
          • FiveM Download
      • API Examples
        • Emergency
          • LUA Examples
            • Dispatch and Emergency Calls
              • New 911 Call
              • Remove 911
              • Add Call Note
              • Set Call Postal
            • Custom Blips
              • Add Blip
              • Add Blips
              • Add Temp Blip
              • Get Map Blips
              • Remove Blip
              • Remove Blip With Subtype
            • General
              • Lookup Name or Plate
          • JavaScript Examples
            • Dispatch and Emergency Calls
              • New 911 Call
              • Remove 911
              • Add Call Note
              • Set Call Postal
            • Custom Blips
              • Add Blip
              • Add Blips
              • Add Temp Blip
              • Get Map Blips
              • Remove Blip
              • Remove Blip With Subtype
            • General
              • Lookup Name or Plate
      • Development Branch
    • 💵Developer Bounties
    • 🌎Translation Support
  • Pricing
    • Pricing FAQ
      • Military and First Responder Discount
      • Expert Installation
      • Accessing the Payment Center
      • Create and Manage a Subscription
      • Request Discord Role
    • View and Compare Plans
  • Roadmap
    • 📋Changelog
  • Other
    • AI QA
    • Contact Us
    • Policy
      • Rocket CAD Closure
      • Terms of Service
      • Privacy Policy
      • Refund and Purchase Policy
      • Discord Bot
    • Archive
      • Fire Siren
Powered by GitBook
On this page
  • What is Sonoran CAD's Livestream Overlay?
  • Bodycam Overlay
  • 1. Set a File Directory
  • 2. Configuring the Bodycam Contents
  • 3. Add the Bodycam to OBS
  • 4. Customize the Size and Placement
  • Smart Lighting
  • Supported Smart Bulbs
  • 1. Searching for Bulbs
  • 2. Creating Sequences
  • 3. Testing and Using In-Game
  • Configuring the Twitch Bot
  • 1. Create a Twitch OAuth Token
  • 2. Configure your Twitch Bot Token and Username
  • 3. Configure the Bot's Event Data
  • 4. Save and Run
  • Debugging the Twitch Bot
  • Custom Overlay Text
  • 1. Accessing the Overlay Window
  • 2. Configuring Text File Location
  • 3. Toggle and Configure Keys
  • 4. Save your Configuration
  • 5. Configure Data in OBS
  • Purchasing the Overlay

Was this helpful?

Edit on GitHub
  1. Integration Capabilities

Twitch Bodycam, Bot, & Lighting Integration

Display your identifier information, attached call information, and more on your gaming stream!

PreviousIntegrated VendorsNextDatabase Sync and Merge

Last updated 1 year ago

Was this helpful?

What is Sonoran CAD's Livestream Overlay?

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.

Bodycam Overlay

This allows you to customize a bodycam overlay on your stream, with your real-time unit and call information.

1. Set a File Directory

In the stream overlay, open the txt file directory viewer and select a folder for the text files and bodycam webpage to be generated:

2. Configuring the Bodycam Contents

In the livestream overlay config section, expand the Bodycam section.

  • Expand the Unit Updates or Call Updates Section

  • Toggle ON the txt file

  • COPY the field key

  • PASTE the field key into the bodycam section

  • SAVE the configuration once complete

You can also optionally specify a different port for the bodycam webpage to run on (9990 is the default).

3. Add the Bodycam to OBS

In OBS, add a new "Browser" source and paste the URL listed in the bodycam section. By default, this will be http://localhost:9990

Paste the URL into the browser source and hit OK.

4. Customize the Size and Placement

You can now customize the size and placement of this browser window in OBS as you normally would.

Smart Lighting

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

Supported Smart Bulbs

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.

1. Searching for 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 on

  • Panic: While your panic status is toggled

  • Available: When your unit status is set to available

  • Unavailable: When your unit status is set to unavailable

  • Busy: When your unit status is set to busy

  • Enroute: When your unit status is set to enroute

  • On Scene: When your unit status is set to on scene

  • Left Turn Signal: While your left hand turn signal is on

  • Right Turn Signal: While your right hand turn signal is on

  • Hazard Lights: While your hazard lights are on

Expand the Scene > Add Bulb > Search for Bulbs > Select Wyze or Philips Hue

Credentials: Wyze

  • Username: Email address used to login to your Wyze account

  • Password: Password used to login to your Wyze account

Credentials: Philips Hue

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

Credentials: Govee WiFi

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.

Credentials: Govee Bluetooth

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.

2. Creating Sequences

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

3. Testing and Using In-Game

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.

Local Webserver: In-Game Use

  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 from 9990 to something else.

  2. Additionally, ensure you have set your file directory in the credentials section of the stream overlay.

Configuring the Twitch Bot

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.

1. Create a Twitch OAuth Token

2. Configure your Twitch Bot Token and Username

Using the overlay in OBS, select the Twitch Bot button in the taskbar. Paste in your Twitch channel name and OAuth key.

Once set, you can press Test to display a test message in your Twitch chat.

3. Configure the Bot's Event Data

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.

4. Save and Run

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.

Debugging the Twitch Bot

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.

If you have too many data fields toggled, and are sending Twitch updates too quickly you may experience rate limiting.

Custom Overlay Text

The overlay is immensely customizable, allowing you to customize every piece of data displayed.

1. Accessing the Overlay Window

The overlay configuration modal can be opened by navigating to Start Menu > System > Stream Overlay. Or, by searching in the start menu.

2. Configuring Text File Location

In the stream overlay, open the txt file directory viewer and select a folder for the text files to be generated:

3. Toggle and Configure Keys

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.

Data Field Keys:

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

4. Save your Configuration

Don't forget to save your configuration!

5. Configure Data in OBS

In OBS, add a new text source:

You can now place the text field anywhere in your OBS stream layout.

You can also customize the fonts, change the background and more!

Purchasing the Overlay

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:

The free version of the overlay does not include the customizable bodycam asset. However, you can still create with the free version!

Learn more about the !

The bodycam creates local text files and hosts a local webserver. This requires the application to run.

The stream overlay also includes a customizable version of the popular .

First, ensure you are using the 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.

Here, you can enable and customize the data placement and keys just as before with the .

The smart lighting integration is not included with the free version of the Stream Overlay. The smart lighting integration creates local text files and hosts a local webserver. This requires the application to run.

(Recommended)

Key ID: The "Key ID" in the

API Key: The "API Key" in the

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 running from your desktop app.

The Twitch bot is not included with the free version of the Stream Overlay.

Create a new Twitch OAuth token by going to

While the Twitch bot can run in a browser instance of Sonoran CAD, the is required, to generate unit/call data txt files.

The free version of the overlay is limited to three (3) data keys. Learn more about the !

In the text source properties, select Read from File and select one of your generated data key files from the .

The free version of the livestream overlay allows anyone to test out the basic functionality. The free version does not allow use of the , , or and is locked to a maximum of three custom "data keys".

Or, include the livestreaming tools for your entire community with .

📺
desktop
XION Chase Cam asset
desktop
Video Promo and Tutorial
Wyze Color
Philips Hue
Govee
Wyze API key generator
Wyze API key generator
local webserver
https://twitchapps.com/tmi/
desktop application
Sonoran One
Create and Manage a Subscription
custom overlay text
full version of Sonoran CAD's stream overlay
customizable text files
desktop
Learn more about the full version of Sonoran CAD's stream overlay.
Learn more about the full version of Sonoran CAD's stream overlay.
full version of Sonoran CAD's stream overlay
location specified earlier
Twitch bot
bodycam
smart lighting integration
Sonoran CAD - Smart Lighting Video
Sonoran CAD - Smart Lighting
Stream Overlay - Text file Location
OBS - New Browser Source
Sonoran CAD - Smart Lighting
Sonoran CAD - Scan for Smart Bulbs
Philips Hue - Copy Bridge IP
Sonoran CAD - Manual Hue Bridge IP
Overlay - Twitch Bot Credentials
Overlay - Twitch Data Fields
Sonoran CAD - Stream Overlay
Overlay - Twitch Logs
Stream Overlay - Text file Location
Stream Overlay - Custom Text Files
OBS - New Text Source
Stream Overlay - Text Files
Stream Overlay - Text file Viewer