To open your preferences, click your avatar at the bottom left of the Tuple popover and select Settings from the dropdown:You can also press cmd + , to open the Settings window.Then select Screen Share in the sidebar:
This setting dictates the resolution that will be used when someone else shares their screen with you. If you adjust this setting while a session is in progress, it will be utilized in the next call. On a call where faster interactions are necessary, you might want to set this lower; if you don’t need to do a lot of typing or clicking but want high viewing quality, then set it higher.
On Apple Silicon Macs, Tuple can upscale incoming screen share video to make text and UI elements look sharper on your display. This is a local, per-viewer setting — it only affects what you see and has no impact on the resolution other participants receive.You can toggle this from the Screen Share preferences pane, or directly during a call from the Upscale Content option in the screen share window’s settings menu.
If this setting is enabled, the audio playing on your Mac is sent to the other participants while you’re sharing your screen.You can also turn it on or off during a call from Share System Audio in the screen share menu in the call controls. That menu item appears only while you’re sharing your screen.Tuple only sends system audio while your Mac’s sound output is headphones. See Sharing system audio for which devices count as headphones and what gets shared.
If this setting is enabled, when an app gets focus while you’re sharing, its window title and URL are shared with the other participants. If they are capturing the call, this allows them to have a history of the files and URLs viewed on a call, as well as giving any connected agents a quick way to understand what’s being discussed. You’ll be asked if you want to enable this the first time you share your screen.Apps hidden by App Veil will not share any metadata.Before anything is shared, Tuple will apply a variety of heuristics to prevent sensitive information from being transmitted; see Sharing app metadata for more information.
If you don’t like the fact that guests can force a URL to open on your computer, you can disable this. URLs will still be sent to your clipboard, but you have to explicitly paste them into a browser to open them.
If selected, any drawings created with the paint mouse mode will persist until you right click. You can also change this while on a call via the settings dropdown on the screen share window.
If this setting is enabled, you’ll see other participants’ cursors all the time. If it’s disabled, you’ll only see them if another participant enters control mode.
If this setting is enabled, you’ll see name labels appear on other participants’ cursors whenever they enter a call, take control, or begin annotating on the screen. If it’s disabled, name labels will only be shown if you hover over another participant’s cursor.
Your cursor, paint strokes, text annotations, and highlight clicks all use a single color, so other participants can tell your marks from theirs.Leave it on Automatic and Tuple assigns you a free color at the start of each call, picking colors with good contrast so everyone is easy to tell apart. Your color can change from call to call.If you pick one of the eleven colors instead, Tuple uses it on every call. The choice applies immediately, including on a call already in progress, and takes precedence over the color the call would have given you — so it is possible to end up matching someone else.You can also change this during a call from the Cursor Color swatches at the top of the settings menu in the shared screen window. Both places set the same preference and stay in sync.
Was this page helpful?
{"docsConfig":{"theme":"palm","$schema":"https://mintlify.com/docs.json","name":"Tuple documentation","description":"Documentation for Tuple, the remote pair programming app for developers on macOS, Windows, and Linux.","colors":{"primary":"#6a5ed9","light":"#adb6f4","dark":"#5e50c7"},"logo":{"light":"https://mintcdn.com/tuple-0f82e5be/-nDSac4-fwCPupIa/logo/light.png?fit=max\u0026auto=format\u0026n=-nDSac4-fwCPupIa\u0026q=85\u0026s=691cb0a8e2a3dcdc0227b893ee08b6b6","dark":"https://mintcdn.com/tuple-0f82e5be/-nDSac4-fwCPupIa/logo/dark.png?fit=max\u0026auto=format\u0026n=-nDSac4-fwCPupIa\u0026q=85\u0026s=5a19781377926b4667bf0867efd75e57"},"favicon":"https://mintcdn.com/tuple-0f82e5be/EHjq0cG1Dd6CF26O/favicon.svg?fit=max\u0026auto=format\u0026n=EHjq0cG1Dd6CF26O\u0026q=85\u0026s=1b6c6ae1f64a9c50fe32a72a08c1e044","navbar":{"links":[{"href":"https://tuple.app?utm_source=docs","label":"Website"},{"href":"mailto:support@tuple.app","label":"Support"}],"primary":{"type":"button","label":"Download","href":"https://tuple.app/download?utm_source=docs"}},"footer":{"socials":{"x":"https://x.com/tuple","linkedin":"https://linkedin.com/company/tuple","youtube":"https://www.youtube.com/@tuple-app"},"links":[{"header":"Product","items":[{"label":"Download","href":"https://tuple.app/download?utm_source=docs"},{"label":"Changelog","href":"/changelog"},{"label":"Pricing","href":"https://tuple.app/pricing?utm_source=docs"}]},{"header":"Resources","items":[{"label":"Support","href":"mailto:support@tuple.app"},{"label":"Blog","href":"https://tuple.app/blog?utm_source=docs"}]}]},"seo":{"metatags":{"og:image":"https://docs.tuple.app/images/og.jpg"}},"integrations":{"posthog":{"apiKey":"phc_1X4UcburMnpeGzdvbEpquCPIp4RO5Wn46yogbxpD1Y8","apiHost":"https://us.i.posthog.com"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Changelog","icon":"list","href":"/changelog"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"tuple-0f82e5be","hasAudioNarration":false,"actualSubdomain":"tuple-0f82e5be","customDomains":["docs.tuple.app"],"gitSource":{"type":"github","owner":"tupleapp","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true,"agentFeedback":false},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6af46e6fec0de01b00c1c00b","clientVersion":"0.0.4111","searchFilterCounts":[{"language":"default","tag":"Pairing with Tuple","count":26},{"language":"default","tag":"Team Management","count":19},{"language":"default","tag":"Features","count":15},{"language":"default","tag":"Troubleshooting","count":14},{"language":"default","tag":"Application Preferences","count":13},{"language":"default","tag":"macOS","count":9},{"language":"default","tag":"Authentication and SSO","count":9},{"language":"default","tag":"Tuple CLI","count":7},{"language":"default","tag":"Calls","count":7},{"language":"default","tag":"Managing Your Account","count":6}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":true,"enableContextualStarterQuestions":true,"enableAskAiSearchBar":true,"deflection":{"enabled":true,"email":"support@tuple.app","showHelpButton":true}},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"application-preferences/macos-preferences-screen-share","slug":"/application-preferences/macos-preferences-screen-share","pageMetadata":{"title":"Screen share","description":null,"href":"/application-preferences/macos-preferences-screen-share"},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,em:`em`,p:`p`,strong:`strong`,..._provideComponents(),...props.components},{Heading,OptimizedImage}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`To open your preferences, click your avatar at the bottom left of the Tuple popover and select `,_jsx(_components.strong,{children:`Settings`}),` from the dropdown:`]}),`\n`,_jsx(OptimizedImage,{src:`https://mintcdn.com/tuple-0f82e5be/UF5N5W8t3gU8dGua/images/application-preferences/shared/macos/open-settings-menu.png?fit=max\u0026auto=format\u0026n=UF5N5W8t3gU8dGua\u0026q=85\u0026s=a2cf94387cbc3d6227d23ff579e413c0`,alt:`Tuple avatar menu with Settings selected on macOS`,\"data-og-width\":`2288`,width:`2288`,\"data-og-height\":`1108`,height:`1108`,\"data-path\":`images/application-preferences/shared/macos/open-settings-menu.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/tuple-0f82e5be/UF5N5W8t3gU8dGua/images/application-preferences/shared/macos/open-settings-menu.png?w=280\u0026fit=max\u0026auto=format\u0026n=UF5N5W8t3gU8dGua\u0026q=85\u0026s=3b5748580cfcde4e48c9505398ee9c6d 280w, https://mintcdn.com/tuple-0f82e5be/UF5N5W8t3gU8dGua/images/application-preferences/shared/macos/open-settings-menu.png?w=560\u0026fit=max\u0026auto=format\u0026n=UF5N5W8t3gU8dGua\u0026q=85\u0026s=6da7da9cf502cf4a0245616871bc2a33 560w, https://mintcdn.com/tuple-0f82e5be/UF5N5W8t3gU8dGua/images/application-preferences/shared/macos/open-settings-menu.png?w=840\u0026fit=max\u0026auto=format\u0026n=UF5N5W8t3gU8dGua\u0026q=85\u0026s=9b2d30ecde25c95df9018aaa8a2b9cf1 840w, https://mintcdn.com/tuple-0f82e5be/UF5N5W8t3gU8dGua/images/application-preferences/shared/macos/open-settings-menu.png?w=1100\u0026fit=max\u0026auto=format\u0026n=UF5N5W8t3gU8dGua\u0026q=85\u0026s=e336bae0434dc52df2bbb3547c4d45a6 1100w, https://mintcdn.com/tuple-0f82e5be/UF5N5W8t3gU8dGua/images/application-preferences/shared/macos/open-settings-menu.png?w=1650\u0026fit=max\u0026auto=format\u0026n=UF5N5W8t3gU8dGua\u0026q=85\u0026s=59d2cb1e20f052ffce00968b774c8e57 1650w, https://mintcdn.com/tuple-0f82e5be/UF5N5W8t3gU8dGua/images/application-preferences/shared/macos/open-settings-menu.png?w=2500\u0026fit=max\u0026auto=format\u0026n=UF5N5W8t3gU8dGua\u0026q=85\u0026s=3d358499afae375ce4c120eef6ebbdc4 2500w`}),`\n`,_jsxs(_components.p,{children:[`You can also press `,_jsx(_components.strong,{children:`cmd + ,`}),` to open the Settings window.`]}),`\n`,_jsxs(_components.p,{children:[`Then select `,_jsx(_components.strong,{children:`Screen Share`}),` in the sidebar:`]}),`\n`,_jsx(OptimizedImage,{src:`https://mintcdn.com/tuple-0f82e5be/ZYHNNROsZgyCG4Xi/images/application-preferences/macos-preferences-screen-share/screen-share-tab.png?fit=max\u0026auto=format\u0026n=ZYHNNROsZgyCG4Xi\u0026q=85\u0026s=26e7bfcf74cac23770a6fe6e9e480a1e`,alt:`Settings window with the Screen Share tab selected on macOS`,\"data-og-width\":`1464`,width:`1464`,\"data-og-height\":`1420`,height:`1420`,\"data-path\":`images/application-preferences/macos-preferences-screen-share/screen-share-tab.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/tuple-0f82e5be/ZYHNNROsZgyCG4Xi/images/application-preferences/macos-preferences-screen-share/screen-share-tab.png?w=280\u0026fit=max\u0026auto=format\u0026n=ZYHNNROsZgyCG4Xi\u0026q=85\u0026s=5b7de4d9133d2b8e837258d951299c04 280w, https://mintcdn.com/tuple-0f82e5be/ZYHNNROsZgyCG4Xi/images/application-preferences/macos-preferences-screen-share/screen-share-tab.png?w=560\u0026fit=max\u0026auto=format\u0026n=ZYHNNROsZgyCG4Xi\u0026q=85\u0026s=4655fcb74d806c892ad9a958b7a088b9 560w, https://mintcdn.com/tuple-0f82e5be/ZYHNNROsZgyCG4Xi/images/application-preferences/macos-preferences-screen-share/screen-share-tab.png?w=840\u0026fit=max\u0026auto=format\u0026n=ZYHNNROsZgyCG4Xi\u0026q=85\u0026s=82f0df15b48b2fe4edd1d99429c235ea 840w, https://mintcdn.com/tuple-0f82e5be/ZYHNNROsZgyCG4Xi/images/application-preferences/macos-preferences-screen-share/screen-share-tab.png?w=1100\u0026fit=max\u0026auto=format\u0026n=ZYHNNROsZgyCG4Xi\u0026q=85\u0026s=8bcb8752cc7186a0e1d6f0a6e14a49f3 1100w, https://mintcdn.com/tuple-0f82e5be/ZYHNNROsZgyCG4Xi/images/application-preferences/macos-preferences-screen-share/screen-share-tab.png?w=1650\u0026fit=max\u0026auto=format\u0026n=ZYHNNROsZgyCG4Xi\u0026q=85\u0026s=7825006f667e7989702bfac6187c1df3 1650w, https://mintcdn.com/tuple-0f82e5be/ZYHNNROsZgyCG4Xi/images/application-preferences/macos-preferences-screen-share/screen-share-tab.png?w=2500\u0026fit=max\u0026auto=format\u0026n=ZYHNNROsZgyCG4Xi\u0026q=85\u0026s=98f14d1ee4ccb27bf2e8edf9c05bad82 2500w`}),`\n`,_jsx(Heading,{level:`2`,id:`viewing-resolution`,children:`Viewing resolution`}),`\n`,_jsx(_components.p,{children:`This setting dictates the resolution that will be used when someone else shares their screen with you. If you adjust this setting while a session is in progress, it will be utilized in the next call. On a call where faster interactions are necessary, you might want to set this lower; if you don’t need to do a lot of typing or clicking but want high viewing quality, then set it higher.`}),`\n`,_jsx(Heading,{level:`2`,id:`upscale-content`,children:`Upscale content`}),`\n`,_jsxs(_components.p,{children:[`On Apple Silicon Macs, Tuple can upscale incoming screen share video to make text and UI elements look sharper on your display. This is a local, per-viewer setting — it only affects what `,_jsx(_components.em,{children:`you`}),` see and has no impact on the resolution other participants receive.`]}),`\n`,_jsxs(_components.p,{children:[`You can toggle this from the Screen Share preferences pane, or directly during a call from the `,_jsx(_components.strong,{children:`Upscale Content`}),` option in the screen share window’s settings menu.`]}),`\n`,_jsx(Heading,{level:`2`,id:`sharing`,children:`Sharing`}),`\n`,_jsx(Heading,{level:`3`,id:`share-system-audio-when-using-headphones`,children:`Share system audio when using headphones`}),`\n`,_jsx(_components.p,{children:`If this setting is enabled, the audio playing on your Mac is sent to the other participants while you’re sharing your screen.`}),`\n`,_jsxs(_components.p,{children:[`You can also turn it on or off during a call from `,_jsx(_components.strong,{children:`Share System Audio`}),` in the screen share menu in the call controls. That menu item appears only while you’re sharing your screen.`]}),`\n`,_jsxs(_components.p,{children:[`Tuple `,_jsx(_components.strong,{children:`only sends system audio while your Mac’s sound output is headphones`}),`. See `,_jsx(_components.a,{href:`/pairing-with-tuple/sharing-system-audio`,children:`Sharing system audio`}),` for which devices count as headphones and what gets shared.`]}),`\n`,_jsx(Heading,{level:`3`,id:`share-app-metadata`,children:`Share app metadata`}),`\n`,_jsxs(_components.p,{children:[`If this setting is enabled, when an app gets focus while you’re sharing, its window title and URL are shared with the other participants. If they are `,_jsx(_components.a,{href:`/pairing-with-tuple/capturing-calls`,children:`capturing the call`}),`, this allows them to have a history of the files and URLs viewed on a call, as well as giving any connected agents a quick way to understand what’s being discussed. You’ll be asked if you want to enable this the first time you share your screen.`]}),`\n`,_jsxs(_components.p,{children:[`Apps hidden by `,_jsx(_components.a,{href:`/application-preferences/macos-preferences-app-veil`,children:`App Veil`}),` will `,_jsx(_components.em,{children:`not`}),` share any metadata.`]}),`\n`,_jsxs(_components.p,{children:[`Before anything is shared, Tuple will apply a variety of heuristics to prevent sensitive information from being transmitted; see `,_jsx(_components.a,{href:`/pairing-with-tuple/sharing-app-metadata`,children:`Sharing app metadata`}),` for more information.`]}),`\n`,_jsx(Heading,{level:`2`,id:`behavior`,children:`Behavior`}),`\n`,_jsx(Heading,{level:`3`,id:`open-links-sent-to-my-clipboard`,children:`Open links sent to my clipboard`}),`\n`,_jsx(_components.p,{children:`If you don’t like the fact that guests can force a URL to open on your computer, you can disable this. URLs will still be sent to your clipboard, but you have to explicitly paste them into a browser to open them.`}),`\n`,_jsx(Heading,{level:`3`,id:`persist-annotations-until-right-click`,children:`Persist annotations until right click`}),`\n`,_jsx(_components.p,{children:`If selected, any drawings created with the paint mouse mode will persist until you right click. You can also change this while on a call via the settings dropdown on the screen share window.`}),`\n`,_jsx(Heading,{level:`2`,id:`cursors`,children:`Cursors`}),`\n`,_jsx(Heading,{level:`3`,id:`always-show-other-cursors`,children:`Always show other cursors`}),`\n`,_jsx(_components.p,{children:`If this setting is enabled, you’ll see other participants’ cursors all the time. If it’s disabled, you’ll only see them if another participant enters control mode.`}),`\n`,_jsx(Heading,{level:`3`,id:`automatically-show-name-labels`,children:`Automatically show name labels`}),`\n`,_jsx(_components.p,{children:`If this setting is enabled, you’ll see name labels appear on other participants’ cursors whenever they enter a call, take control, or begin annotating on the screen. If it’s disabled, name labels will only be shown if you hover over another participant’s cursor.`}),`\n`,_jsx(Heading,{level:`3`,id:`cursor-color`,children:`Cursor color`}),`\n`,_jsx(_components.p,{children:`Your cursor, paint strokes, text annotations, and highlight clicks all use a single color, so other participants can tell your marks from theirs.`}),`\n`,_jsxs(_components.p,{children:[`Leave it on `,_jsx(_components.strong,{children:`Automatic`}),` and Tuple assigns you a free color at the start of each call, picking colors with good contrast so everyone is easy to tell apart. Your color can change from call to call.`]}),`\n`,_jsx(_components.p,{children:`If you pick one of the eleven colors instead, Tuple uses it on every call. The choice applies immediately, including on a call already in progress, and takes precedence over the color the call would have given you — so it is possible to end up matching someone else.`}),`\n`,_jsxs(_components.p,{children:[`You can also change this during a call from the `,_jsx(_components.strong,{children:`Cursor Color`}),` swatches at the top of the settings menu in the `,_jsx(_components.a,{href:`/pairing-with-tuple/interacting-with-a-shared-screen#settings`,children:`shared screen window`}),`. Both places set the same preference and stay in sync.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Screen share","description":null,"href":"/application-preferences/macos-preferences-screen-share"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Viewing resolution","slug":"viewing-resolution","depth":2,"children":[]},{"title":"Upscale content","slug":"upscale-content","depth":2,"children":[]},{"title":"Sharing","slug":"sharing","depth":2,"children":[{"title":"Share system audio when using headphones","slug":"share-system-audio-when-using-headphones","depth":3,"children":[]},{"title":"Share app metadata","slug":"share-app-metadata","depth":3,"children":[]}]},{"title":"Behavior","slug":"behavior","depth":2,"children":[{"title":"Open links sent to my clipboard","slug":"open-links-sent-to-my-clipboard","depth":3,"children":[]},{"title":"Persist annotations until right click","slug":"persist-annotations-until-right-click","depth":3,"children":[]}]},{"title":"Cursors","slug":"cursors","depth":2,"children":[{"title":"Always show other cursors","slug":"always-show-other-cursors","depth":3,"children":[]},{"title":"Automatically show name labels","slug":"automatically-show-name-labels","depth":3,"children":[]},{"title":"Cursor color","slug":"cursor-color","depth":3,"children":[]}]}],"codeExamples":{}},"jsLinks":[],"subdomain":"tuple-0f82e5be","siteName":"Tuple documentation","title":"Screen share - Tuple documentation","contextualStarterQuestions":[{"_id":"6af35234e98c54a9fd38cbef","deploymentId":"69cbe83e7f226f107dbe3406","questionText":"Where is screen share in preferences?","status":"active","generatedBy":"contextual","path":"application-preferences/macos-preferences-screen-share","createdAt":"2026-11-10T17:19:48.279Z","updatedAt":"2026-11-10T17:19:48.279Z","__v":0},{"_id":"6af35234e98c54a9fd38cbee","deploymentId":"69cbe83e7f226f107dbe3406","questionText":"How do I open screen share settings?","status":"active","generatedBy":"contextual","path":"application-preferences/macos-preferences-screen-share","createdAt":"2026-11-10T17:19:48.279Z","updatedAt":"2026-11-10T17:19:48.279Z","__v":0}],"navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-10T17:19:37.938Z","originalFileLocation":"application-preferences/macos-preferences-screen-share.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"application-name\" content=\"Tuple documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/tuple-0f82e5be/1w1zy1sfDexR8wGh/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/tuple-0f82e5be/1w1zy1sfDexR8wGh/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/tuple-0f82e5be/1w1zy1sfDexR8wGh/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/tuple-0f82e5be/1w1zy1sfDexR8wGh/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/tuple-0f82e5be/1w1zy1sfDexR8wGh/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/tuple-0f82e5be/1w1zy1sfDexR8wGh/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/tuple-0f82e5be/1w1zy1sfDexR8wGh/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/tuple-0f82e5be/1w1zy1sfDexR8wGh/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/tuple-0f82e5be/1w1zy1sfDexR8wGh/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Screen share - Tuple documentation\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Tuple documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.tuple.app/application-preferences/macos-preferences-screen-share\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://docs.tuple.app/images/og.jpg\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Screen share - Tuple documentation\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://docs.tuple.app/images/og.jpg\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/tuple-0f82e5be/1w1zy1sfDexR8wGh/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Tuple documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#6a5ed9\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.tuple.app/application-preferences/macos-preferences-screen-share\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/application-preferences/macos-preferences-screen-share.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.tuple.app/#organization\",\"name\":\"Tuple documentation\",\"url\":\"https://docs.tuple.app\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/tuple-0f82e5be/-nDSac4-fwCPupIa/logo/light.png?fit=max\u0026auto=format\u0026n=-nDSac4-fwCPupIa\u0026q=85\u0026s=691cb0a8e2a3dcdc0227b893ee08b6b6\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.tuple.app#website\",\"name\":\"Tuple documentation\",\"url\":\"https://docs.tuple.app\",\"publisher\":{\"@id\":\"https://docs.tuple.app/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.tuple.app/application-preferences/macos-preferences-screen-share#webpage\",\"url\":\"https://docs.tuple.app/application-preferences/macos-preferences-screen-share\",\"name\":\"Screen share\",\"dateModified\":\"2026-11-10T17:19:37.938Z\",\"isPartOf\":{\"@id\":\"https://docs.tuple.app#website\"},\"breadcrumb\":{\"@id\":\"https://docs.tuple.app/application-preferences/macos-preferences-screen-share#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.tuple.app/application-preferences/macos-preferences-screen-share#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Application Preferences\",\"item\":\"https://docs.tuple.app/application-preferences/macos-preferences-general\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"macOS\",\"item\":\"https://docs.tuple.app/application-preferences/macos-preferences-general\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Screen share\",\"item\":\"https://docs.tuple.app/application-preferences/macos-preferences-screen-share\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.tuple.app/application-preferences/macos-preferences-screen-share#article\",\"headline\":\"Screen share\",\"name\":\"Screen share\",\"url\":\"https://docs.tuple.app/application-preferences/macos-preferences-screen-share\",\"mainEntityOfPage\":{\"@id\":\"https://docs.tuple.app/application-preferences/macos-preferences-screen-share#webpage\"},\"image\":\"https://docs.tuple.app/images/og.jpg\",\"dateModified\":\"2026-11-10T17:19:37.938Z\",\"publisher\":{\"@id\":\"https://docs.tuple.app/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.tuple.app#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Tuple documentation\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Tuple documentation\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/application-preferences/macos-preferences-screen-share.md","siteName":"Tuple documentation","nav":{"global":{"anchors":[{"anchor":"Changelog","icon":"list","href":"/changelog"}]},"groups":[{"group":"Getting Started","pages":[{"title":"Installation","href":"/getting-started/installation"},{"title":"Supported platforms","href":"/troubleshooting/supported-platforms"},{"title":"Tuple for Linux (alpha)","href":"/getting-started/tuple-for-linux"},{"title":"Agreements and Policies","href":"/overview/agreements-and-policies"}]},{"group":"Pairing with Tuple","pages":[{"group":"Screen Sharing","root":{"title":"Sharing your screen","href":"/pairing-with-tuple/sharing-your-screen"},"pages":[{"title":"Interacting with a shared screen","href":"/pairing-with-tuple/interacting-with-a-shared-screen"},{"title":"Requesting a share","href":"/pairing-with-tuple/requesting-a-share"},{"title":"Sharing app metadata","href":"/pairing-with-tuple/sharing-app-metadata"},{"title":"Sharing system audio","href":"/pairing-with-tuple/sharing-system-audio"}]},{"group":"Calls","pages":[{"title":"Adding more call participants","href":"/pairing-with-tuple/adding-more-call-participants"},{"title":"Joining an existing call","href":"/pairing-with-tuple/joining-an-existing-call"},{"title":"Joining a call via a link/URL","href":"/pairing-with-tuple/joining-a-call-via-a-linkurl"},{"title":"Joining a call from your browser","href":"/pairing-with-tuple/joining-a-call-from-your-browser"},{"title":"Using Rooms","href":"/pairing-with-tuple/using-rooms"},{"title":"Pairing with Someone on Tuple as a Guest","href":"/pairing-with-tuple/pairing-with-someone-on-tuple-as-a-guest"},{"title":"Using Tuple for Interviews","href":"/pairing-with-tuple/using-tuple-for-interviews"}]},{"group":"Features","pages":[{"title":"Audio device swapping","href":"/pairing-with-tuple/audio-device-swapping"},{"title":"Copying and pasting from one computer to another","href":"/pairing-with-tuple/copying-and-pasting-from-one-computer-to-another-sharing-your-clipboard"},{"title":"Sound Check","href":"/pairing-with-tuple/sound-check"},{"title":"Call Stats","href":"/pairing-with-tuple/call-stats"},{"title":"Sharing a webcam video","href":"/pairing-with-tuple/sharing-a-webcam-video"},{"title":"Collaborative Painting","href":"/pairing-with-tuple/collaborative-painting"},{"title":"Showing Who You're Pairing With","href":"/pairing-with-tuple/showing-who-youre-pairing-with"},{"title":"Using your keyboard to navigate Tuple","href":"/pairing-with-tuple/using-your-keyboard-to-navigate-tuple"},{"title":"Spotlight Integration","href":"/pairing-with-tuple/spotlight-integration"},{"title":"How to stream pair programming sessions","href":"/pairing-with-tuple/how-to-stream-pair-programming-sessions"},{"title":"Capturing calls","href":"/pairing-with-tuple/capturing-calls"},{"title":"Ways to use Capture","href":"/pairing-with-tuple/ways-to-use-capture"},{"title":"Local call history","href":"/pairing-with-tuple/local-call-history"},{"title":"Searching past calls","href":"/pairing-with-tuple/searching-past-calls"},{"title":"Speaking-while-muted notification","href":"/pairing-with-tuple/speaking-while-muted-notification"}]}]},{"group":"Managing Your Account","pages":[{"group":"Profile and Security","pages":[{"title":"Setting your profile picture avatar","href":"/managing-your-account/setting-your-profile-picture-avatar"},{"title":"Resetting your password","href":"/managing-your-account/resetting-your-password"}]},{"group":"Account Type and Access","pages":[{"title":"Using Tuple as an unpaid user","href":"/managing-your-account/using-tuple-as-an-unpaid-user"},{"title":"Upgrading a guest account","href":"/managing-your-account/upgrading-a-guest-account"}]},{"group":"Integrations and Activity","pages":[{"title":"Adding Integrations","href":"/managing-your-account/adding-integrations"},{"title":"Viewing your call history","href":"/managing-your-account/viewing-your-call-history"}]}]},{"group":"Team Management","pages":[{"group":"Members and Permissions","root":{"title":"Inviting users","href":"/team-management/inviting-users"},"pages":[{"title":"Removing users","href":"/team-management/removing-users"},{"title":"Team Owner and Managers","href":"/team-management/team-owner-and-managers"},{"title":"Requesting a Team Invite Link","href":"/team-management/requesting-a-team-invite-link"}]},{"group":"Billing and Subscription","root":{"title":"Managing Team billing","href":"/team-management/managing-team-billing"},"pages":[{"title":"Adding Details To Your Invoice","href":"/team-management/adding-details-to-your-invoice"},{"title":"Cancelling a subscription","href":"/team-management/cancelling-a-subscription"},{"title":"Reactivating a subscription","href":"/team-management/reactivating-a-subscription"},{"title":"OSS and startup plans","href":"/team-management/oss-and-startup-plans"}]},{"group":"Authentication and SSO","pages":[{"title":"Sign In With Google","href":"/team-management/sign-in-with-google"},{"title":"Sign in With Microsoft","href":"/team-management/sign-in-with-microsoft"},{"group":"SAML","root":{"title":"Single Sign-On (SSO)","href":"/team-management/configuring-single-sign-on-sso"},"pages":[{"title":"Okta","href":"/team-management/sso-okta"},{"title":"Google Workspace","href":"/team-management/sso-google"},{"title":"Microsoft Entra ID","href":"/team-management/sso-azure"},{"title":"OneLogin","href":"/team-management/sso-onelogin"}]},{"group":"SCIM","root":{"title":"SCIM provisioning","href":"/team-management/scim-provisioning"},"pages":[{"title":"Okta","href":"/team-management/scim-okta"},{"title":"Microsoft Entra ID","href":"/team-management/scim-entra-id"},{"title":"OneLogin","href":"/team-management/scim-onelogin"}]}]},{"group":"Reporting","pages":[{"title":"Pairing Insights","href":"/team-management/pairing-insights"},{"title":"Exporting Team Usage","href":"/team-management/exporting-team-usage"},{"title":"Usage API (alpha)","href":"/team-management/usage-api-alpha"}]}]},{"group":"Application Preferences","pages":[{"group":"macOS","expanded":false,"pages":[{"title":"General","href":"/application-preferences/macos-preferences-general"},{"title":"Audio","description":null,"href":"/application-preferences/macos-preferences-audio"},{"title":"Screen share","href":"/application-preferences/macos-preferences-screen-share"},{"title":"Webcam","description":null,"href":"/application-preferences/macos-preferences-webcam"},{"title":"Hotkeys","href":"/application-preferences/macos-preferences-hotkeys"},{"title":"Capture","href":"/application-preferences/macos-preferences-capture"},{"title":"App Veil","href":"/application-preferences/macos-preferences-app-veil"},{"title":"Triggers","href":"/application-preferences/macos-preferences-triggers"},{"title":"Integrations","href":"/application-preferences/macos-preferences-integrations"}]},{"group":"Windows","expanded":false,"pages":[{"title":"General","href":"/application-preferences/windows-preferences-general"},{"title":"Audio","href":"/application-preferences/windows-preferences-audio"},{"title":"Network","href":"/application-preferences/windows-preferences-network"},{"title":"Capture","hidden":true,"href":"/application-preferences/windows-preferences-capture"},{"title":"App Veil","href":"/application-preferences/windows-preferences-app-veil"}]}]},{"group":"Tuple CLI","pages":[{"title":"CLI overview","href":"/cli/overview"},{"title":"Command reference","href":"/cli/commands"},{"title":"Connect an AI agent","href":"/cli/connect"},{"title":"Config file","href":"/cli/config"},{"title":"MCP server","href":"/cli/mcp"},{"title":"Migrate Tuple CLI and MCP integrations","href":"/cli/migration"},{"title":"Migrate from the earlier Linux commands","href":"/cli/linux-migration"}]},{"group":"Triggers","pages":[{"title":"Building a trigger","href":"/triggers/building-a-trigger"},{"title":"Testing and debugging","href":"/triggers/testing-and-debugging"},{"title":"API reference","href":"/triggers/api-reference"},{"title":"Best practices","href":"/triggers/best-practices"},{"title":"Submitting a trigger","href":"/triggers/submitting-a-trigger"},{"title":"Security","href":"/triggers/security"}]},{"group":"Troubleshooting","pages":[{"group":"Connectivity and Call Quality","pages":[{"title":"Fixing Connectivity Issues","href":"/troubleshooting/fixing-connectivity-issues"},{"title":"Networking and Firewall Issues","href":"/troubleshooting/networking-and-firewall-issues"},{"title":"Reducing latency","href":"/troubleshooting/reducing-latency"},{"title":"AWDL interference","href":"/troubleshooting/awdl"}]},{"group":"Audio and Notifications","pages":[{"title":"Audio Issues","href":"/troubleshooting/audio-issues"},{"title":"Audio device swapping","href":"/troubleshooting/audio-device-swapping"},{"title":"Quiet microphone on Windows","href":"/troubleshooting/quiet-microphone-on-windows"},{"title":"Not receiving notifications","href":"/troubleshooting/not-receiving-notifications"}]},{"group":"Performance and Stability","pages":[{"title":"Crashes","href":"/troubleshooting/crashes"},{"title":"High CPU usage","href":"/troubleshooting/high-cpu-usage"}]},{"group":"Updates and System Setup","pages":[{"title":"Upgrading","href":"/troubleshooting/upgrading"},{"title":"Minimum Disk Space Requirements","href":"/troubleshooting/minimum-disk-space-requirements"},{"title":"Preventing Launch at Login","href":"/troubleshooting/preventing-launch-at-login"}]},{"group":"Diagnostics and Support","pages":[{"title":"Recording on Tuple","href":"/troubleshooting/recording-on-tuple"}]}]}]},"basePath":"","title":"Screen share - Tuple documentation","buildId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","deploymentId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","dynamics":["a74be98ba7"],"chunks":["zoom-image-lightbox-DTFzvaXJ.js","lightbox-handle-r17bVUz3.js"]}