# Special Considerations for Setting Up Polarity on macOS

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.

<table data-full-width="false"><thead><tr><th width="294" align="right">Permission</th><th width="140" align="right">macOS Ver. -></th><th width="100" data-type="checkbox">Sonoma</th><th width="100" data-type="checkbox">Ventura</th><th width="100" data-type="checkbox">Earlier</th></tr></thead><tbody><tr><td align="right"><strong><code>Accessibility</code></strong></td><td align="right">-----</td><td>true</td><td>true</td><td>true</td></tr><tr><td align="right"><strong><code>Screen Recording</code></strong></td><td align="right">-----</td><td>true</td><td>true</td><td>true</td></tr><tr><td align="right"><strong><code>Input Monitoring</code></strong></td><td align="right">-----</td><td>true</td><td>false</td><td>false</td></tr><tr><td align="right"><em><code>Developer Tools</code></em><br><em>(contingent on circumstances)</em></td><td align="right">-----</td><td>false</td><td>true</td><td>false</td></tr></tbody></table>

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

{% hint style="info" %}
**Your Polarity Customer Success team is available to assist and provide support.**

Please contact us at <CustomerSuccess@Polarity.io> for help.
{% endhint %}

***

## Enabling Shortcut Keys on macOS <a href="#enabling-shortcut-keys-on-macos" id="enabling-shortcut-keys-on-macos"></a>

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

{% hint style="warning" %}
***You will need to restart the Client to use shortcut keys in Polarity.***
{% endhint %}

![Figure 1](https://2418141914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MCAAXaadP8o1ERJ4Z4C%2Fuploads%2FNNlbVaDg8ne84Ls9f4Wi%2Fmac_shortcutkey_settings2.png?alt=media\&token=6b089b9e-b1b9-4ef3-a73b-fea7f3a1abcc)

### 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)*

{% hint style="warning" %}
***You will need to restart the Client to use shortcut keys in Polarity.***
{% endhint %}

<figure><img src="https://2418141914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MCAAXaadP8o1ERJ4Z4C%2Fuploads%2FsV5lpf2dmyRstg3AJgra%2Fimage.png?alt=media&#x26;token=1c11da12-2123-481d-9e92-16fbf9ee2f22" alt=""><figcaption><p>Figure 2</p></figcaption></figure>

<figure><img src="https://2418141914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MCAAXaadP8o1ERJ4Z4C%2Fuploads%2F9j92mx0ZZkFIZhiKpu75%2Fimage.png?alt=media&#x26;token=3ae28ff1-ab16-4b69-a99f-e1d3a0849642" alt=""><figcaption><p>Figure 3</p></figcaption></figure>

***

## Enabling Real Time Recognition (RTR) on macOS <a href="#running-polarity-on-macos-catalina" id="running-polarity-on-macos-catalina"></a>

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

![Figure 4](https://2418141914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MCAAXaadP8o1ERJ4Z4C%2Fuploads%2FZO0RbQn9USi3Ja9zmqmB%2FMac_screenrecord.png?alt=media\&token=80f486fb-3496-44db-bb6c-5e1da73b588d)

***

## Troubleshooting

### *If Real Time Recognition Still Isn't Working...*

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.

{% hint style="info" %}
**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.**
{% endhint %}

#### 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)*

{% hint style="warning" %}
***You will need to restart the Client to start running Real Time Recognition in Polarity.***
{% endhint %}

<figure><img src="https://2418141914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MCAAXaadP8o1ERJ4Z4C%2Fuploads%2FAl9CMGoor9eslQy2NK6S%2Fimage.png?alt=media&#x26;token=dd0ad7f4-004d-45d3-a10d-09d33f1739d2" alt=""><figcaption><p>Figure 5</p></figcaption></figure>

<figure><img src="https://2418141914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MCAAXaadP8o1ERJ4Z4C%2Fuploads%2FhFRd3Gr7mCDZJbkSlgoA%2Fimage.png?alt=media&#x26;token=ce23f52f-0581-4a15-aa32-0c840fa451f2" alt=""><figcaption><p>Figure 6</p></figcaption></figure>