Troubleshooting Guide

If BrowserCord isn't updating your status, don't worry! Most issues can be fixed by checking these common settings.

1. "Failed to connect" or "Failed to load sites" in Extension

If the browser extension cannot find the server app:

• Check the Server: Ensure that BrowserCord is actually running in your system tray.
• Firewall Permissions: Ensure your Windows Firewall isn't blocking the app. It needs to communicate on a local port to talk to your browser.
• Restart the App: Close the server completely and re-open it, then refresh your browser tab.

2. Server is Connected, but Discord isn't showing the status

If the extension says "Connected" but your Discord profile is empty:

• Discord Desktop App: Discord Rich Presence only works with the official Discord Desktop client. It will not work if you are using Discord in a browser tab.
• Activity Settings: 1. Open Discord User Settings.

2. Go to Activity Privacy.
3. Ensure "Display current activity as a status message" is toggled ON.

• Game Overlay: Some users find they need to have "Enable in-game overlay" on, though this is rarely the cause.

3. Linux Version Issues (Legacy 1.x.x)

If you are using the old .deb version:

• Dependency Errors: Run sudo apt --fix-broken install to ensure all necessary libraries are installed.
• Version Mismatch: Ensure you are not trying to use a v2.0.0+ extension with a v1.x.x Linux server. They are not compatible.

---

🆘 Still need help?

If none of the above worked, please make a issue and provide the following info:

1. Your Windows Version.
2. Your Browser Name (Chrome, Firefox, etc.).
3. A screenshot of the Extension Popup status.