Troubleshooting

This guide covers the most common issues media teams encounter with RheoCast and how to resolve them.

Audio Issues

No audio signal in the monitor

1. Open Settings → Audio and confirm the correct microphone is selected.
2. Check that your audio interface or mixer is connected and the pastor's channel is unmuted.
3. Adjust Microphone Volume — try boosting above 100% if the signal is quiet.
4. Unplug and reconnect USB audio devices, then reselect the device in settings.

Audio works but transcription doesn't start

1. Confirm you clicked Start below the Live Transcript (header should show the red transcription timer).
2. Check Settings → Subscription — you may have exhausted your monthly transcription minutes.
3. Verify internet connectivity. Cloud transcription requires an active connection on Windows and Intel-based Macs. Apple Silicon Macs can automatically fall back to on-device transcription when offline.

Changing microphone mid-session causes a brief pause

This is expected. The audio engine restarts when you switch devices. Change microphones before starting transcription whenever possible.

Transcription Issues

Transcription is slow or delayed

1. Ensure a stable internet connection (cloud transcription requires connectivity on most platforms).
2. Close other heavy applications on the broadcast computer.
3. Use a wired Ethernet connection instead of Wi-Fi during services.

Transcription stops when internet drops

Check status in Settings → Transcription.

Detected references seem wrong

Speech-to-text occasionally mishears book names. Use manual search as a fallback — type the correct reference and press Enter.

Review the live transcript to see what was actually transcribed. Unusual pronunciations or strong room echo can affect accuracy.

Detection Issues

Pastor quotes scripture but nothing appears in Detections

1. Confirm Start is active (red transcription timer in header).
2. Try speaking more clearly: "John chapter three verse sixteen" detects reliably.
3. Check the Detections panel on the right — detections appear here even when Go Live is off.
4. Use manual search if detection misses a reference.

Detections appear but not on the projector

1. Turn Go Live ON on the Display Preview panel.
2. Click Display on a detection chip, or enable Auto Display in the header.
3. Verify your output mode in Settings → Output (Windowed, Fullscreen, NDI, or Web Overlay).

Too many false detections

1. Turn off Auto Display in the header and manually approve each detection with Display.
2. Ensure the microphone feed is the pastor's mic only — room noise and music can trigger false matches.
3. Dismiss unwanted detections with X, or click Clear all.

Display & Output Issues

Verse doesn't appear on projector

1. Check Settings → Output — confirm the correct mode (Windowed or Fullscreen).
2. For fullscreen: ensure a second display/projector is connected before launching RheoCast.
3. Turn Go Live ON on the Display Preview panel.
4. Click Display on a detection or search result to send a verse to the output.
5. Press Escape may have cleared it — select a verse again.

NDI source not visible in OBS / vMix

1. Confirm NDI Source is enabled in Settings → Output.
2. Ensure RheoCast and production software are on the same local network.
3. Use wired Ethernet — Wi-Fi often blocks NDI discovery.
4. Restart the NDI source after enabling it in RheoCast.

Browser overlay shows blank in OBS

1. Copy the overlay URL from Settings → Output → Web Overlay again.
2. Set browser source dimensions to match your stream resolution (1920×1080).
3. Enable Refresh browser when scene becomes active in OBS.
4. Display a verse in RheoCast first — the overlay is transparent when empty.

Account & Sign-In Issues

Google sign-in fails

1. Check internet connectivity.
2. Try again — browser authentication may have timed out.
3. Ensure pop-ups aren't blocked for the sign-in window.

License key rejected

1. Verify the key was typed correctly (no extra spaces).
2. Confirm the key hasn't already been activated on another device.
3. Contact support with your church name and key prefix.

"No Internet Connection" on launch

RheoCast couldn't reach the account server and shows a full-screen retry message. The app retries automatically every few seconds. Check your internet connection before signing in.

Creator Studio Issues

Can't switch to Creator Studio

Click Stop below the Live Transcript first. Creator Studio is disabled while transcription is active or starting.

AI generation fails or times out

1. Check remaining AI credits in Settings → Subscription.
2. Verify internet connection (cloud AI requires connectivity).
3. Try again with a shorter transcript section.
4. If using local AI, ensure your machine meets recommended hardware specs.

Generated content has errors

AI-generated summaries, notes, and devotionals should always be reviewed and edited before publishing. RheoCast assists your team — it does not replace pastoral review.

Performance Tips

• Dedicated broadcast computer — Avoid running RheoCast on the same machine as heavy video editing or gaming workloads during live services.
• Close unused apps — Free RAM and CPU for transcription and display.
• Rehearse weekly — A 5-minute pre-service test catches most issues before they matter.
• Keep RheoCast updated — Install updates from the website when notified.

Still Need Help?

Contact our support team — we're here to help your media team succeed:

• [email protected]
• [email protected]
• [email protected]

Include your operating system, RheoCast version (shown in the app footer), subscription plan, and a description of the issue for the fastest response.