My camera and/or mic is not working.

First Steps

  • Refresh your window!

    Many common problems can be solved by hitting the refresh button on your browser. It's the equivalent of unplugging and plugging it back in. If you are still experiencing issues, continue to the next steps.

  • Update Your Browser

    The first thing to check is if your browser is up to date. We support the two most recent versions of our supported browsers, so double-check that there isn't an update for the one you're using! There are links below that walk you through updating your browser if you don't know how to:

  • Accidentally Block Permission?

    When Whereby first asks permission to access your camera and microphone, you may have chosen "Block" instead of "Allow" by mistake.

    In this case, please press the camera icon in the browser's address bar to undo the block, then press "Try Again." The icon looks slightly different on different browsers, but here are some examples:

  • Clear Your Cache and Cookies

    Finally, it's possible that this is caused by a stale mic/cam permissions cookie or possibly because of another application that's taking priority access over Whereby.

    In this case, we recommend clearing your cache and cookies for your entire browser and restarting your computer. Sometimes a reset of your system environment will resolve these types of issues, so this is a "catch-all" solution before a further investigation is required! Instructions for clearing your cache and cookies for our supported browsers are linked below:

  • Check your system and browser settings

    Confirm the Mic/Cam settings for your operating system

    • MacOs

      In MacOS Mojave, Apple has introduced some system-level privacy controls for your mic and camera. These are great for privacy, but it is possible that your browser was mistakenly blocked from accessing your devices. You can check on this and allow your browser to access them from the Security & Privacy section in your System Preferences.

      To access these settings, do the following:

      1. Click on the Apple in the top left > select System Preferences.

      2. Click on the Security & Privacy section.

      3. Click on Camera in the list of options, and tick the box next to your browser to allow access.

      4. Repeat Step 3 for your Microphone

      5. After doing this, restart your browser for the updates to take effect

    • Windows

      Confirm the Mic/Cam settings for your browser

      • Chrome

        Mic and camera defaults can be accessed in a number of ways in Chrome, but the easiest is to paste the following links into your URL bar:

        Cam: chrome://settings/content/camera

        Mic: chrome://settings/content/microphone

        From these areas, you can manage Chrome's default cam/mic and whitelist or block websites from accessing your cam/mic! Be sure that Whereby is listed under the Allow section.

        Firefox

        Opera


      Still not working? A couple more things to check

      • Adjusting your Firewall: Some browsers are not able to connect through strict networks/firewalls. Also, there may be bugs in the browser causing problems with the connection. If you are experiencing this, try switching to another browser. Currently, Firefox is not supporting connections through very strict firewalls, so if you are on a corporate network, try to get all participants to use Chrome or Opera.

      • Browser Extensions: Interfering browser extensions: It is not uncommon for some third-party extensions to cause problems with some websites. Try using your browser through an Incognito tab or Private browsing window to test this. If all works normally then you know that an extension is causing an issue. Unfortunately, there is no way to identify which one easily. A process of elimination will need to be done on each extension to find the one causing the problem.


I can't see or hear everyone

Since Whereby is browser-based, it is important to make sure that everyone's setup is up to par with our setup. If there are black frames or someone cannot be heard, it might be related to permissions, browser or network.

Below are some tips on how to resolve this issue:

  • Network

    The most common reason for these issues is related to network connections not being established between you and your guests.

    For most users, this is related to network security, for example, a VPN or a firewall.

    • If you have a VPN try disabling it and reconnecting to the room.

    • If you have a firewall, try configuring it with our basic setup recommendations.

    • Try connecting via an alternative network, such as a mobile hotspot.

  • Clearing Cache and Cookies

    It could be possible that another platform is taking microphone access so a quick way to fix this is to clear your cache and cookies. Below you can find further instructions depending on the browser you are using

  • Switching Browsers

    There have been reports in the past where similar issues happen when a connection is made through a Safari or Edge browser. For good practice, we recommend using some of our more seasoned veterans such as Chrome or Firefox to see if the issue persists.

    While Edge & Safari are supported browsers of our technology (WebRTC), these browsers are still somewhat new to providing support to that technology and the WebRTC community has a few bug reports open with their development team that we are advocating to get fixed. Unfortunately, since we are 100% browser-based we are at the mercy of these dev teams for some bug fixes on their side.

  • Network Configuration

    First, we recommend reading through the troubleshooting article below to make sure your network meets all of our recommendations.

    Network Requirements

    If you are still running into issues, please let us know by emailing at support@whereby.com. If you are on our Pro or Business plan you can send us a message directly from your room.


I'm using a supported device, but still getting an error.

Click here for a complete list of devices the live room supports.

I'm using a supported device, but still getting an error.

One possible reason you'd get an unsupported browser message in a supported browser is that JavaScript is disabled. Instructions for checking on this will vary depending on which browser you're using, so see instructions for each below:

  • Google Chrome and other Chromium Browsers

    1. On your computer, open Chrome.

    2. At the top right, click More > Settings.

    3. At the bottom, click Advanced.

    4. Under "Privacy and security," click Content settings.

    5. Click JavaScript.

    6. Turn on Allowed (recommended).

  • Safari

    1. Select Safari from the Apple/System bar at the top of the screen.

    2. From the drop-down menu, select Preferences.

    3. Select the Security icon/tab at the top of the window.

    4. Check the Enable JavaScript checkbox under the Web content category.

    5. Close the dialog box to save your changes.

    6. Finally, refresh your browser.

  • Firefox

    1. Open a new Firefox browser window or tab.

    2. Copy the following then paste it into the Firefox address bar: about: config

    3. Click the Enter key.

    4. On the following page, click the button: "I'll be careful, I promise!"

    5. Find the javascript. enabled row under the Preference Name heading.

    6. Double-click anywhere within the javascript. enabled row to toggle the value from "False" to "True".

    7. Finally, refresh your browser.

      If the instructions above don't work, it's possible that there's a setting in your configuration file that's causing this. See the instructions below to check on your configuration settings:

      1. Open Firefox window and type " about:config" in your URL bar2 Search for the flag " media.peerconnection.enabled"3 Set the flag to True by right-clicking on selecting the Toggle option4 Quit and re-open your browser. After doing this you should be able to view the Whereby homepage normally.


How to give your browser permission to share screen

This article explains how to give browsers permission to share screens by the operating system (OS).

If you're a Mac user, you might encounter problems while trying to share your screen. This is because your browser needs permission from the Mac Operating System (OS) to share the screen.

Fortunately, this can be solved quickly.

  1. Open the System Preferences app.

  2. Go to Security and privacy.

  3. Choose the Screen recording permission from the left menu and make sure the box is checked next to the browser you are using.

  4. If you are unable to change these settings, you must first click on the padlock at the bottom left.

If it still doesn't work, try unchecking and rechecking the checkbox.

Have any other issues? For more help, contact developer@vibely.io.

Did this answer your question?