---
title: "macOS Settings for Polarity Enterprise Client Setup"
slug: "macos-settings-for-the-polarity-enterprise-client"
description: "Configure Polarity Enterprise Client on macOS with step-by-step settings instructions. Learn how to install, configure preferences, and optimize the annotation client for Mac systems in enterprise deployments."
updated: 2024-12-26T15:41:40Z
published: 2024-12-26T15:41:40Z
canonical: "knowledge.threatconnect.com/macos-settings-for-the-polarity-enterprise-client"
---

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

# macOS Settings for the Polarity Enterprise Client

*Due to security features on macOS, a few settings will need to be configured in System Preferences in order for the Polarity Enterprise Client (PolarityX) to function as intended.*

## macOS Permissions Reference Table

The table below is a quick reference on permissions requirements for Polarity to run with full functionality.

| Permission \ macOS Version → | Sonoma | Ventura | Earlier |
| --- | --- | --- | --- |
| **Accessibility** | ✅ | ✅ | ✅ |
| **Screen Recording** | ✅ | ✅ | ✅ |
| **Input Montioring** | ✅ |  |  |
| **Developer Tools** *(contingent on circumstance)* |  | ✅ |  |

For steps to enable these permissions, please see the appropriate section below.

> [!NOTE]
> Note
> 
> Your Polarity Customer Success team is available to assist and provide support.
> 
> Please contact us at [CustomerSuccess@Polarity.io](mailto:CustomerSuccess@Polarity.io) for assistance.

## Enabling Shortcut Keys on macOS

Polarity uses system wide shortcut keys that allow users to Annotate or run an On-Demand search. In order to use Polarity shortcut keys you will need to grant Polarity permission from within the macOS Accessibility settings.

**To enable the Accessibility setting for Polarity:**

1. Navigate to System Preferences on your macOS
2. Click on Security & Privacy
3. Navigate to the Privacy tab
4. Go to Accessibility and find PolarityX (Figure 1)
5. Click on the checkbox next to the Polarity Icon

> [!WARNING]
> You will need to restart the Client to use shortcut keys in Polarity.

### macOS Sonoma (v. 14.x) Shortcut Keys

The macOS Sonoma release (v. 14.x) requires the Input Monitoring permission to enable Polarity to use shortcut keys. The Input Monitoring permission is found in the Privacy & Security menu.

**To enable Input Monitoring on macOS Sonoma:**

1. Navigate to the Privacy & Security tab in the macOS System Preferences (Figure 2)
2. Navigate to Input Monitoring (Figure 2)
3. In Input Monitoring, click the + button and select the PolarityX application (Figure 3)

> [!WARNING]
> You will need to restart the Client to use shortcut keys in Polarity.

## Enabling Real Time Recognition (RTR) on macOS

The Screen Recording permission is required for all versions of macOS to provide access to all Real Time Recognition features in Polarity.

**To enable Screen Recording:**

1. Navigate to the Privacy tab within System Preferences
2. Navigate to Screen Recording (Figure 4)
3. Select the PolarityX application

> [!WARNING]
> You will need to restart the Client to start running Real Time Recognition in Polarity.

### Troubleshooting Real Time Recognition

Security updates made to macOS in the Ventura release (v. 13.x) initially required users to grant an application "developer-level" access to recognize contents on the screen. This update affected multiple software applications besides Polarity, to include antivirus and security packages.

If you have granted the permissions outlined above (and restarted the Client software) but Polarity still isn't recognizing on-screen content, please follow the directions below to enable the Developer Tools permission.

**To enable Developer Tools:**

1. Navigate to Privacy and Security under System Preferences
2. Navigate to Developer Tools (Figure 5)
3. In Developer Tools, click the + button and select the PolarityX application (Figure 6)

> [!WARNING]
> You will need to restart the Client to start running Real Time Recognition in Polarity.