Troubleshooting
If your problem is a known limitation rather than a fix-it issue, check Known issues too.
Recording shows “no capture sources”
Section titled “Recording shows “no capture sources””The Screen Recording permission was denied, revoked, or has gone stale. Open System Settings → Privacy & Security → Screen Recording. If CrowdCast is already listed, remove it from the list (select it and click the minus button), then add it back. On macOS this often works where simply toggling the switch does not. Quit and relaunch crowd-cast afterwards.
No special permissions are needed on Windows. If you see this, the first-launch
component download may have failed. Check your internet connection, delete the
install folder at %LOCALAPPDATA%\Programs\crowd-cast, and re-run the installer.
crowd-cast supports only GNOME on Wayland and sway; on any other session it won’t start (the setup wizard blocks until you’re in a supported one). On GNOME, this usually means the bundled focus extension isn’t active yet: install it from the wizard and log out and back in once, then recording can start. On sway, capture is full-screen and the portal asks which output to share when crowd-cast starts.
The tray icon doesn’t appear
Section titled “The tray icon doesn’t appear”First check that the app is running (Activity Monitor). If it is, the icon may be hidden because the menu bar is full: macOS has no overflow arrow, so when there isn’t room for every icon (common on notch laptops) it simply doesn’t show. Free up space by quitting other menu-bar apps or hiding their icons, or use a menu-bar manager such as Ice or Bartender to reveal hidden ones.
Click the ^ arrow in the system tray to reveal hidden icons. You can drag crowd-cast into the always-visible area.
The tray needs a StatusNotifier (SNI) host, so the icon will not show under vanilla GNOME (without the AppIndicator extension). Under swaybar the icon appears but its menu will not open, so on sway run waybar for a working menu. The agent keeps running and recording regardless.
Notifications don’t appear
Section titled “Notifications don’t appear”Notifications need permission. Open System Settings → Notifications, find CrowdCast, and make sure notifications are allowed.
crowd-cast does not currently show desktop notifications on Windows.
Notifications go through the freedesktop notification service, which needs a notification daemon to be running. GNOME provides one out of the box. On a bare sway session, run mako or dunst. Recording is unaffected either way.
Uploads are failing
Section titled “Uploads are failing”Segments are retried automatically with exponential backoff (about 30 seconds up to 2 hours), so transient failures sort themselves out. Check your internet connection. If uploads are paused, resume them from the tray menu. Segments are kept on disk until they upload successfully, so nothing is lost in the meantime.
Re-run the setup wizard
Section titled “Re-run the setup wizard”Quit crowd-cast first, then run the agent with --setup:
/Applications/CrowdCast.app/Contents/MacOS/crowd-cast-agent --setup"%LOCALAPPDATA%\Programs\crowd-cast\crowd-cast-agent.exe" --setup~/.local/bin/crowd-cast-agent --setupI signed in but can’t see my recordings
Section titled “I signed in but can’t see my recordings”The dashboard updates roughly once an hour, so new recordings won’t appear immediately. If your data still doesn’t show up after an hour, sign out and back in from the tray menu. If that doesn’t help either, reach out to us.
Where are the logs?
Section titled “Where are the logs?”~/Library/Logs/crowd-cast/%LOCALAPPDATA%\crowd-cast\logs\~/.local/state/agent/logs/Share these with us on Discord if you need help debugging.
How do I uninstall?
Section titled “How do I uninstall?”Quit the app, then drag CrowdCast from Applications to the Trash. To also remove configuration and logs, delete:
~/Library/Application Support/dev.crowd-cast.agent/~/Library/Logs/crowd-cast/Open Settings → Apps → Installed apps, find crowd-cast and click Uninstall. The uninstaller stops the agent, removes the autostart entry and deletes the install directory.
packaging/linux/install.sh --uninstallThis removes the user-space install (it keeps your config and input-group
membership).