> For the complete documentation index, see [llms.txt](https://docs.sonoransoftware.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sonoransoftware.com/studio/sonoran-studio/troubleshooting.md).

# Troubleshooting

## The overlay looks square, stretched, or cropped

Use the exact Studio canvas width and height in the browser source. Reset the source transform and fit it to the scene again.

## A temporary widget is missing

Radio transmission, panic takeover, and dispatch notification appear only while matching live data is present or while **TEST** is active. Confirm the widget is enabled and run its test.

## Live CAD or Radio data is not appearing

* Confirm you signed in with the correct Sonoran account.
* Keep the browser source active and connected.
* In OBS, leave **Shutdown source when not visible** off.
* Verify the community and product session granting Studio context is active.
* Replace and re-copy the overlay URL if the existing source was revoked.

## A premium layout is not broadcasting

Only the fallback layout broadcasts without premium access. Restore premium access or switch the streaming scene back to the fallback layout.

## The desktop companion says premium is unavailable

Confirm the companion is signed in and that either the personal Studio subscription or eligible Sonoran One community context is active.

## Smart lights do not respond

* Verify the companion is running.
* Confirm the displayed FiveM endpoint matches your integration.
* Test the scene directly in the companion.
* Check local-network access to the bridge or bulb.
* If LAN access is enabled, verify the caller uses the generated private token.

## Streamer.bot does not connect

Verify Streamer.bot's WebSocket server is enabled, normally on `127.0.0.1:8080`. Confirm its port, endpoint, and optional password in the companion, then select **Save & connect**.

## Still stuck?

Contact [Sonoran Support](https://support.sonoransoftware.com/) and include the streaming app, canvas size, affected widget, and whether the issue also appears during a Studio test.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.sonoransoftware.com/studio/sonoran-studio/troubleshooting.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.