LogoLogo
WherebyStatusCommunity
  • 📹Whereby 101
    • Create Your Video Experience
      • Get started in 3 steps
      • Embedding Whereby in a web app
        • Using Whereby's Web Component & Pre-built UI
          • Script Tags
          • With Low Code
            • Embedding in Squarespace or Wordpress
            • No code video conferencing in Bubble
        • Using Whereby's Browser SDK with React Hooks for a fully custom UI
      • Embedding Whereby in a mobile app
        • Embedding Whereby in iOS
          • Using Whereby's Native iOS SDK
        • Embedding Whereby in Android
          • Using Whereby's Native SDK
        • Using Flutter
        • Using React Native
      • Github SDK Examples
      • Meeting scheduling with Cronofy
    • Generating Room URLs
      • Name prefixes
      • Using “Create a room”
      • Using Postman
    • Customize Your Video Experience
      • During room creation
      • Using Attributes/URL Params
      • Global preferences
      • Branding elements
      • Dial-In
      • File sharing
      • Breakout Groups with Embedded
      • Waiting Rooms
    • User roles & Meeting Permissions
    • FAQ
      • Accessibility
      • Whereby Words
      • Firewall & Security
      • HIPAA compliant setup
      • Allowed Domains & Localhost
      • Whereby Embedded Feature Comparison
  • 🔍Meeting Content & Quality
    • Recording
      • Cloud Recording
      • Local Recording
    • Transcribing
      • Session Transcription
      • Recording Transcription
    • Live Captions
    • Session summaries
    • Live streaming RTMP
    • Quality Insights
      • Real-time troubleshooting
      • Using the Insights dashboard
      • Improving call quality
      • Tracking room events with Webhooks
  • 🤷End User
    • End User Support Guides
      • Supported Browsers & Devices
      • Screen Sharing Setup & Usage
      • Using Breakout Groups
      • Troubleshooting & Basics
  • 🚚Developer Guides
    • Quickly deploy Whereby to your domain
    • Tracking Customer Usage
    • Migrating from Twilio
      • Twilio JS SDK Quick Migration
      • Twilio JS SDK Direct Migration
  • 🖥️Reference
    • REST API Reference
      • /meetings
      • /insights
      • /recordings
      • /transcriptions
      • /summaries
      • /rooms
    • Web Component Reference
    • React Hooks Reference
      • Quick Start
        • Getting started with the Browser SDK
      • Guides & Tutorials
        • Migrate from version 2.x to 3
        • Grid logic
        • Custom Video Tiles with React
        • Usage with Next.js
        • How to customize the toolbar
      • API Reference
        • WherebyProvider
        • VideoView
        • VideoGrid
        • useLocalMedia
        • useRoomConnection
      • Types
    • React Native Reference
      • Quick Start
      • WherebyEmbed
    • Webhooks Reference
Powered by GitBook
On this page
  • Setup and Management
  • Browser sharing options
  • Screen sharing additional features
  • Screen sharing with audio
  • Picture in picture
  • Annotating Screen share
  • Troubleshooting Screen Sharing

Was this helpful?

Edit on GitHub
  1. End User
  2. End User Support Guides

Screen Sharing Setup & Usage

Last updated 1 year ago

Was this helpful?

Screen sharing is a great way to share content to other hosts/participants in the room.

To keep an optimal level of performance in the room, screen sharing will broadcast from 1-5 FPS (frames per second) by default, and up to 1080p based on network and CPU restraints.

Depending on the browser being used, there will be different options for what can be shared.

Screen sharing on Mobile (both phone and tablet) devices is not currently available.

Setup and Management

As the platform holder, there are few options you have for managing the available screen sharing feature.

  • Enabling screen sharing for all rooms via a

  • Enabling screen sharing on a per room/user basis with a

  • Listening for the with our Web Component to facilitate in app messages or notifications

  • Using the for stopping/starting screen sharing

Browser sharing options

You can share an image of your entire screen. If you have multiple monitors, you can also select which one you'd like to show.

If you select the "Window" section, you can select a specific application like Word or Chrome that you want to share.

lastly, you can use the Chrome Tab option if you only want to share one tab from your Browser.

Firefox allows for the sharing of an entire screen, or of an app window. Options are not divided into sections.

Safari allows for the sharing of an entire screen, or of an app window. When selecting the "Share Window" option, you'll hover your mouse over and click the window you'd like to share.

Screen sharing additional features

Screen sharing with audio

Sharing computer audio is possible while screen sharing and using Chrome or Chromium browsers.

Depending on the sharing option selected and the operating system, a checkbox that says "Share Audio" will be present that you can check to share audio.

Tip: Many audio and video files (eg mp3, mp4, webm) can be opened into Chrome for viewing and playback. Simply drag and drop the local files into a new tab, and share tab audio as previously mentioned

macOS

On macOS, users are only able to share a specific Chrome tab. Sharing audio for the entire computer or a specific application window isn't possible at this time due to browser/operating system permissions.On Windows machines, you'll have the option to share audio from any Chrome tab, and you can also share the audio for your Entire Screen.

On Windows machines, users have the option to share audio from any Chrome tab or share the audio for the Entire Screen.

Sharing the audio of the entire screen that contains a Whereby room will cause an echo effect. To prevent this issue from happening, try sharing the audio of a Chrome tab or a separate monitor instead.

Picture in picture

Due to a bug in Safari for macOS, we've temporarily disabled our Picture in Picture feature for versions 17.x

This activates a pop-out of the currently active videos within the meeting room.

Annotating Screen share

Troubleshooting Screen Sharing

"Could not start screen share"

If you are seeing the above error message, it could mean a few things. Either the request was canceled or your browser doesn't have permission to access screen sharing.

Windows Permissions: At the moment Windows doesn't have any system-level permissions for screen access. if you're running into problems or getting an error, double-check your browser settings.

Chrome and Chromium: At the moment Chrome doesn't have any specific settings related to screen access.

In the more recent versions of macOS, Apple has introduced system-level permissions for applications like your browser for accessing screen sharing.

If you've recently updated or upgraded your device and can't screen share anymore, you'll need to update the preferences by doing the following:

  1. Open up System Settings on your Mac

  2. Click on the "Privacy & Security" section

  3. Scroll to the "Screen & System Audio Recording" section, and ensure that your browser is toggled on

  4. Restart your browser

In some cases you may have accidentally blocked screen sharing for the site at a browser level. In Safari you can fix that with the following:

  1. In your menu bar, select Safari->Settings

  2. Select the "Websites" option

  3. Scroll down to the "Screen Sharing" section

  4. Find your website and verify it is set to "Ask"

When using screen sharing in Firefox, you'll see a pop up that asks if you'd like to allow Whereby (or your site) to access your screen

If you accidentally selected "Always block", Firefox won't show this prompt again. In this case, you'll need to manually reset the permissions for screen access by doing the following:

  1. Click on the "Site information" area, just to the left of the website address

  2. Locate the "Share the Screen" item in the list, and select the "X" next to Blocked

  1. Refresh the tab

"Screen share is hard to read"

If you're having trouble reading smaller text on a screen share, try making the window or content that is being shared smaller. That might mean instead of sharing the entire screen, share a browser window/tab that has been resized slightly. Or, if you have a large monitor try to not use an app window or browser tab that is stretched to the full size of the monitor.

Allowing the use of "" can be helpful for users that want to screen share content and still be able to view others within the room.

Users can extend the capability of screen sharing by installing extensions in Chrome or Chromium browsers. Tools like "" or "" work well to highlight and indicate content in your browser while screen sharing.

🤷
Picture in Picture
Draw on page
Paint
dashboard preference
URL parameter
screen sharing event
browser method