RoomCast
Home - Manual - Troubleshooting
Help! It's not working
Common problems with RoomCast for Mac, and how to fix them.
Download RoomCast for MacShare with your venueStuck on a step? Tell me
Applies to: Mac app
Make sure listeners are on the same Wi-Fi as the Mac. Some venue or guest Wi-Fi blocks devices from seeing each other; try another network or a personal hotspot from a phone used only as a router.
Applies to: Mac app
Turn the source down first: the mixer, music app or DJ software output, until peaks sit around three-quarters of the meter. If you're feeding a line-level source into a mic input, use a line input instead.
Applies to: Mac app
Turn the source up first, then fine-tune with the app's gain. On the listener's side, check the phone volume.
Applies to: Mac app
Chrome may ask for permission to access devices on the local network. Tap Allow, or check the site's settings in Chrome and allow local network access.
Applies to: Mac app
The listening page needs JavaScript. Turn JavaScript on in the browser, or try a different browser.
Applies to: Mac app
Changing networks ends the stream for everyone. Stay on one network for the whole event, then start again and re-share the link if you must switch.
Applies to: Mac app
When macOS asks whether RoomCast may accept incoming network connections, click Allow. If you missed it, check System Settings › Network › Firewall.
Applies to: Mac app
RoomCast sends audio to phones through one network port, 8189 by default. You only need to change it if another app on your Mac already uses that port, or the venue network or a firewall blocks it. In Settings › Advanced, set ICE port to a free number (for example 8190), allow that port in any firewall, then stop and start the broadcast.
Applies to: Mac app
Click Done — do not click Move to Trash. Open System Settings → Privacy & Security, scroll to Security, and click Open Anyway. Confirm with your password or Touch ID, then click Open. On macOS 13 and 14, Control-click RoomCast in Applications → Open → Open can also work. More detail is in Getting started.
Applies to: Mac app
The download or the signature is broken. Download RoomCast again and drag a fresh copy to Applications.
Applies to: Mac app
The desk is not feeding the interface, or the music-app path is not reaching BlackHole. Raise Volume if the source is quiet. See Getting started and Broadcast music from an app.
Applies to: Mac app
The Mac’s address changed. Check the reservation on the router, then compare the on-screen listen address with the poster. Make a new poster if they differ. See Your network and the QR poster.
Applies to: Mac app
Tap play. Tap the speaker or mute icon on the player and in the browser tab. Turn the phone volume up. Keep the screen on and the browser in front.
Applies to: Mac app
Leave quality on Speech for speech, or in Settings → Stream try TCP only. See Settings.
Applies to: Mac app
The lid was closed, or it was on battery and idle. Keep power connected and the lid open, and turn on Keep Mac awake while broadcasting in Settings → General.
Applies to: Mac app
Expected. Allow it again. If you previously clicked Don’t Allow, go to System Settings → Privacy & Security → Microphone. See Getting started.
Applies to: Mac app
Another program is using that port. In Settings → Advanced change the ICE port (8189 by default), or in Settings → Stream change the listener port (8889 by default). If the program is a leftover RoomCast helper, press Stop leftover helper, then Start.
If that got you back on air, and RoomCast helped, you can buy me a coffee.
Still stuck? Ask on GitHub issues → · FAQ →