> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tuple.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Sharing a webcam video

Pairing well is all about communication, and there's so much information sent through someone's facial expressions. Seeing your pair's face while working really makes you feel more connected to them.

<View title="macOS" icon="apple">
  <span id="share-webcam" />

  ## Sharing a webcam

  To add a webcam video, click the "Start Webcam" icon in the popover UI:

  <img src="https://mintcdn.com/tuple-0f82e5be/O4IiteXcXoa48ycm/images/pairing-with-tuple/macos-sharing-a-webcam-video/start-webcam-call-controls.png?fit=max&auto=format&n=O4IiteXcXoa48ycm&q=85&s=7802326264c627342f27b738c6aa5f9d" alt="Call controls showing the Start Webcam option" width="2288" height="1108" data-path="images/pairing-with-tuple/macos-sharing-a-webcam-video/start-webcam-call-controls.png" />

  You'll be shown a preview of your webcam's feed so you can adjust your lighting or background:

  <img src="https://mintcdn.com/tuple-0f82e5be/O4IiteXcXoa48ycm/images/pairing-with-tuple/macos-sharing-a-webcam-video/webcam-preview.png?fit=max&auto=format&n=O4IiteXcXoa48ycm&q=85&s=50a88d27cf800c13d220e0bc633f815c" alt="Preview window showing your webcam feed before sharing starts" width="978" height="764" data-path="images/pairing-with-tuple/macos-sharing-a-webcam-video/webcam-preview.png" />

  **Note:** this preview won't be seen by your pair, even if you're already sharing your desktop with them.

  Once you click "Start Sharing", the preview disappears and your video stream will be shown to your pair.

  When you aren't sharing your webcam feed, you can bring up the camera preview via an option in the dropdown:

  <img src="https://mintcdn.com/tuple-0f82e5be/O4IiteXcXoa48ycm/images/pairing-with-tuple/macos-sharing-a-webcam-video/webcam-preview-dropdown.png?fit=max&auto=format&n=O4IiteXcXoa48ycm&q=85&s=fe92cbdd44161a096ccd394a592b43cd" alt="Webcam dropdown menu with the preview option and available camera devices" width="2288" height="1117" data-path="images/pairing-with-tuple/macos-sharing-a-webcam-video/webcam-preview-dropdown.png" />

  ### Conversation mode & coding mode

  Tuple has two different ways to see the webcams of other participants on the call: **coding mode** and **conversation mode.**

  **Coding mode** is the default mode, and is designed to be used in a pairing session where code is the primary focus:

  * In this mode, the webcam window will float above all other windows.
  * This mode allows participant webcams to be laid out either in a horizontal row or vertical column (this can be changed from the triple-dot menu).
  * In this mode, the webcam window resizes proportionally.
  * Buttons and other UI elements are hidden by default and show up when your cursor hovers the window.

      <img src="https://mintcdn.com/tuple-0f82e5be/O4IiteXcXoa48ycm/images/pairing-with-tuple/macos-sharing-a-webcam-video/coding-mode-layout.png?fit=max&auto=format&n=O4IiteXcXoa48ycm&q=85&s=18abb6a0a824117983a43428e1d8d565" alt="Coding mode webcam window floating above the screen share" width="808" height="798" data-path="images/pairing-with-tuple/macos-sharing-a-webcam-video/coding-mode-layout.png" />

  Conversely, you can use **conversation mode** in sessions where more of the focus is on discussion amongst the participants:

  * In this mode, the webcam window will behave like a normal window (i.e. it will go behind other windows when it loses focus, the window can be resized arbitrarily, etc).
  * This mode lays out participant webcams in a grid, which allows each individual webcam view to be larger.

      <img src="https://mintcdn.com/tuple-0f82e5be/O4IiteXcXoa48ycm/images/pairing-with-tuple/macos-sharing-a-webcam-video/conversation-mode-layout.png?fit=max&auto=format&n=O4IiteXcXoa48ycm&q=85&s=1e6e7fc7069d5279546fb50f9325552c" alt="Conversation mode webcam window arranged in a grid layout" width="1796" height="1388" data-path="images/pairing-with-tuple/macos-sharing-a-webcam-video/conversation-mode-layout.png" />

  To switch between the two modes, click the toggle button in the top-right of the webcam window:

  <img src="https://mintcdn.com/tuple-0f82e5be/O4IiteXcXoa48ycm/images/pairing-with-tuple/macos-sharing-a-webcam-video/webcam-mode-toggle.png?fit=max&auto=format&n=O4IiteXcXoa48ycm&q=85&s=c7fda9e710e34d3fbc4521f42a62fc79" alt="Toggle button for switching between coding mode and conversation mode" width="688" height="288" data-path="images/pairing-with-tuple/macos-sharing-a-webcam-video/webcam-mode-toggle.png" />

  <span id="self-view" />

  ## Showing your own webcam self-view

  While on a call, you can show or hide your own self view. This won't change whether other participants can see your webcam or not.

  To show or hide your self view, click on the menu in the top-right corner of the webcam window, and click "Show/Hide Self View".

  <img src="https://mintcdn.com/tuple-0f82e5be/O4IiteXcXoa48ycm/images/pairing-with-tuple/macos-sharing-a-webcam-video/self-view-menu.png?fit=max&auto=format&n=O4IiteXcXoa48ycm&q=85&s=50ca3e64b269679d2a26b4c45e826c4f" alt="Webcam window menu with the Show or Hide Self View option" width="514" height="478" data-path="images/pairing-with-tuple/macos-sharing-a-webcam-video/self-view-menu.png" />

  When you're in **coding mode**, you have the ability to choose between a small or large self view. *Small* will display your own video feed as a minimized thumbnail placed in the bottom-right corner of the webcam window, which helps save space when you're pairing with someone. *Big* sets your self-view to be the same size as the other tiles.

  <img src="https://mintcdn.com/tuple-0f82e5be/O4IiteXcXoa48ycm/images/pairing-with-tuple/macos-sharing-a-webcam-video/self-view-size-options.png?fit=max&auto=format&n=O4IiteXcXoa48ycm&q=85&s=59d8cd44dfc34b227eefcea2c896ef0b" alt="Coding mode self-view size options for small and big tiles" width="504" height="730" data-path="images/pairing-with-tuple/macos-sharing-a-webcam-video/self-view-size-options.png" />

  <span id="change-webcam" />

  ## Changing the webcam in use while sharing

  You can swap out the webcam in use when you are sharing a webcam by selecting the camera you'd prefer to share by selecting it from the dropdown:

  <img src="https://mintcdn.com/tuple-0f82e5be/O4IiteXcXoa48ycm/images/pairing-with-tuple/macos-sharing-a-webcam-video/webcam-preview-dropdown.png?fit=max&auto=format&n=O4IiteXcXoa48ycm&q=85&s=fe92cbdd44161a096ccd394a592b43cd" alt="Webcam dropdown menu listing the available camera devices while sharing" width="2288" height="1117" data-path="images/pairing-with-tuple/macos-sharing-a-webcam-video/webcam-preview-dropdown.png" />

  <span id="effects" />

  ## Using effects on your webcam

  Tuple does allow the usage of virtual cameras as a webcam source. You can use third-party software such as [Krisp.ai](https://krisp.ai/) or [OBS](https://obsproject.com/) to add video backgrounds.

  If you're using a Mac with Apple Silicon, you can use the built-in background blur support. Select "Video effects" from the Control Center panel, and you will be able to turn it on for any app individually:

  <img src="https://mintcdn.com/tuple-0f82e5be/O4IiteXcXoa48ycm/images/pairing-with-tuple/macos-sharing-a-webcam-video/video-effects-control-center.png?fit=max&auto=format&n=O4IiteXcXoa48ycm&q=85&s=0fb3f7de0f3df53aef94ce1302a678bf" alt="macOS Control Center with Video Effects options for the active webcam" width="632" height="495" data-path="images/pairing-with-tuple/macos-sharing-a-webcam-video/video-effects-control-center.png" />

  Then select "Portrait" mode to add the blur:

  <img src="https://mintcdn.com/tuple-0f82e5be/O4IiteXcXoa48ycm/images/pairing-with-tuple/macos-sharing-a-webcam-video/portrait-video-effect.png?fit=max&auto=format&n=O4IiteXcXoa48ycm&q=85&s=b109f0c9bf283e1a1f28dc64f4033c65" alt="Portrait video effect selected in macOS Control Center" width="678" height="406" data-path="images/pairing-with-tuple/macos-sharing-a-webcam-video/portrait-video-effect.png" />

  You can also enable and disable video effects from the webcam sharing indicator that appears in the menu bar:

  <img src="https://mintcdn.com/tuple-0f82e5be/O4IiteXcXoa48ycm/images/pairing-with-tuple/macos-sharing-a-webcam-video/menu-bar-video-effects.png?fit=max&auto=format&n=O4IiteXcXoa48ycm&q=85&s=6d7e235a50da62f2af13dbe23bf3f218" alt="Menu bar webcam indicator with video effects controls" width="620" height="864" data-path="images/pairing-with-tuple/macos-sharing-a-webcam-video/menu-bar-video-effects.png" />

  <span id="preferences" />

  ## Setting your webcam resolution preference

  You can set the webcam resolution in your [preferences](/application-preferences/macos-preferences-webcam). Setting the resolution will automatically change the resolution on any current calls.

  You might need to tweak your resolution depending on your network connection. If you have a high-speed connection and want maximum webcam quality, set your preference to high. If you're working with a relatively poor connection, set your preference to medium:

  <img src="https://mintcdn.com/tuple-0f82e5be/O4IiteXcXoa48ycm/images/pairing-with-tuple/macos-sharing-a-webcam-video/webcam-resolution-preference.png?fit=max&auto=format&n=O4IiteXcXoa48ycm&q=85&s=5021e1f289f2c72287140ae67ccf64e2" alt="Preferences screen showing webcam resolution options" width="1083" height="654" data-path="images/pairing-with-tuple/macos-sharing-a-webcam-video/webcam-resolution-preference.png" />
</View>

<View title="Windows" icon="windows">
  ### Sharing a webcam

  To add a webcam video, click the "Start Webcam" icon in the popover UI:

  <img src="https://mintcdn.com/tuple-0f82e5be/6QQND0Fn_6FQQwmn/images/pairing-with-tuple/windows-sharing-a-webcam-video/start-webcam-button.png?fit=max&auto=format&n=6QQND0Fn_6FQQwmn&q=85&s=bc75c462167ec67d77be3d026477eeb7" alt="Call controls showing the Start Webcam option on Windows" width="505" height="496" data-path="images/pairing-with-tuple/windows-sharing-a-webcam-video/start-webcam-button.png" />

  You'll be shown a preview of your webcam's feed so you can adjust your lighting or background:

  **Note:** this preview won't be seen by your pair, even if you're already sharing your desktop with them.

  Once you click "Start Sharing", the preview disappears and your video stream will be shown to your pair.

  When you aren't sharing your webcam feed, you can bring up the camera preview via an option in the dropdown:

  <img src="https://mintcdn.com/tuple-0f82e5be/6QQND0Fn_6FQQwmn/images/pairing-with-tuple/windows-sharing-a-webcam-video/webcam-preview-dropdown.png?fit=max&auto=format&n=6QQND0Fn_6FQQwmn&q=85&s=d0cf48c347c7f33ef2a8389b9d74a7d1" alt="Webcam dropdown menu with preview and camera device options on Windows" width="644" height="516" data-path="images/pairing-with-tuple/windows-sharing-a-webcam-video/webcam-preview-dropdown.png" />

  ### Showing your own webcam self-view

  While on a call, you can show or hide your own self view. This won't change whether other participants can see your webcam or not.

  To show or hide your self view, click on the menu in the top-left corner of the webcam window, and toggle "Show Self View".

  <img src="https://mintcdn.com/tuple-0f82e5be/6QQND0Fn_6FQQwmn/images/pairing-with-tuple/windows-sharing-a-webcam-video/show-self-view-toggle.png?fit=max&auto=format&n=6QQND0Fn_6FQQwmn&q=85&s=4ab8caa81885305751e897f083a423a4" alt="Webcam window menu with the Show Self View toggle on Windows" width="394" height="398" data-path="images/pairing-with-tuple/windows-sharing-a-webcam-video/show-self-view-toggle.png" />

  ### Changing the Webcam in use while sharing

  You can swap out the webcam in use when you are sharing a webcam by selecting the camera you'd prefer to share by selecting it from the dropdown:

  <img src="https://mintcdn.com/tuple-0f82e5be/6QQND0Fn_6FQQwmn/images/pairing-with-tuple/windows-sharing-a-webcam-video/webcam-device-dropdown.png?fit=max&auto=format&n=6QQND0Fn_6FQQwmn&q=85&s=f9b28d40a5f93ad52e2cf3f975c940d2" alt="Camera device dropdown for switching webcams on Windows" width="657" height="535" data-path="images/pairing-with-tuple/windows-sharing-a-webcam-video/webcam-device-dropdown.png" />
</View>
